.. _oper_monit:

=================
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 :ref:`config_monit`.

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``:

.. code-block:: json

  {
    "status": "UP"
  }


Zjištění stavu front
============================

Pro každý nakonfigurovaný vstupní systém a cílový systém (aplikace Elza) 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:

 - ``elza`` - pro systém Elza
 - ``peva`` - pro systém PeVa
 - ``whois`` - pro systém WhoIs

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


Příklad odpovědi:

.. code-block::

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