3.2. Monitorování

Správnost běhu a fungování všech částí komponenty Imwhooser je možné kontrolovat pomocí k tomu určeného rozhraní. To umožňuje přímé monitorování pomocí systému Prometheus, nebo pomocí nástrojů, které jsou schopny zpracovat data ve formátu OpenMetrics.

Přístup k monitorovacímu rozhraní je nutné povolit v konfiguračním souboru, viz Monitorování.

3.2.1. Zjištění stavu komponenty

Informace o stavu komponenty jsou dostupné na adrese: http://localhost:8080/actuator/health

Pokud je komponenta v pořádku, vrací stav UP. V opačném případě vrací stav DOWN a důvod selhání nebo uvedená stránka není dostupná.

Příklad odpovědi při stavu UP:

{
  "status": "UP"
}

3.2.2. Zjištění stavu vstupních front

Pro každý nakonfigurovaný vstupní systém jsou k dispozici 3 metriky:

  • počet zpracovaných záznamů: queue.count

  • doba v sekundách od počátku chybového stavu: queue_error_at, hodnota -1 znamená, že fronta není v chybovém stavu a poslední zpracování bylo úspěšné

  • doba v sekundách od posledního zpracování nezávisle na tom, zda úspěšné či neúspěšné: queue.last_check

Po startu komponenty jsou všechny metriky nastaveny na výchozí hodnoty:

  • queue.count na hodnotu 0

  • queue.last_check na hodnotu -1

  • queue_error_at na hodnotu -1.

Součástí každé metriky je i název systému, pro který je metrika určena.

Možné hodnoty názvu systému jsou:

Tyto metriky jsou dostupné na adrese: http://localhost:8080/actuator/prometheus

Příklad odpovědi:

queue_count_total{name="whois",} 0.0
queue_last_check{name="whois",} 22.0
queue_error_at{name="whois",} -1.0

3.2.3. Zjištění stavu fronty do Elza

Pro odchozí frontu do Elza jsou k dispozici 4 metriky:

  • počet zpracovaných záznamů: queue.count

  • počet zakázaných záznamů pro přenos: queue.count_disabled

  • doba v sekundách od počátku chybového stavu: queue_error_at, hodnota -1 znamená, že fronta není v chybovém stavu a poslední zpracování bylo úspěšné

  • doba v sekundách od posledního zpracování nezávisle na tom, zda úspěšné či neúspěšné: queue.last_check

Po startu komponenty jsou všechny metriky nastaveny na výchozí hodnoty:

  • queue.count na hodnotu 0

  • queue.count_disabled na hodnotu odpovídající počtu zakázaných záznamů v DB

  • queue.last_check na hodnotu -1

  • queue_error_at na hodnotu -1.

Název systému pro Elza je elza.

Tyto metriky jsou dostupné na adrese: http://localhost:8080/actuator/prometheus

Příklad odpovědi:

queue_count_total{name="elza",} 0.0
queue_count_disabled{name="elza",} 2.0
queue_last_check{name="elza",} 22.0
queue_error_at{name="elza",} -1.0