2.12. Métriques dans VITAM

2.12.1. Fonctionnement

Les métriques dans VITAM sont stockées dans le package :

fr.gouv.common.metrics

Les registres de métriques et les reporters de métriques sont tous les deux contenus dans une classe VitamMetrics. Cette classe doit être instanciée avec un VitamMetricsType qui peut être JERSEY, JVM ou BUSINESS. Le type définira les métriques enregistrées dans le registre interne de la classe.

La classe AbstractVitamApplication contient une Map statique de VitamMetrics qui est initialisée à chaque configuration d’une application VITAM. Cette Map contient obligatoirement un VitamMetrics de type BUSINESS et peut accessoirement contenir les VitamMetrics de types JVM et JERSEY. La fonction en question est :

protected static final void clearAndconfigureMetrics()

Cette fonction vide et recharge les métriques à chaque création d’une application VITAM. Les reporters de métriques quant à eux sont démarrés lors d’un appel à la fonction :

public final void run() throws VitamApplicationServerException

qui elle même appelle la fonction :

public final void startMetrics()

de la classe AbstractVitamApplication.

Note

Les VitamMetrics de type JERSEY ou JVM n’ont pas à être modifiés pendant l’execution d’une application VITAM.

2.12.2. Configuration

Les métriques sont configurées dans le fichier /vitam/conf/<service_id>/vitam.metrics.conf. Ce fichier contient la documentation nécessaire pour configurer correctement les métriques.

2.12.3. Métriques métier

Les métriques métiers permettent aux développeurs d’enregistrer des métriques n’importe où dans le code, pour par exemple suivre une variable ou bien chronométrer une fonction. Pour cela il suffit d’appeler la fonction statique getBusinessMetricRegistry dans la classe AbstractVitamApplication, puis d’enregistrer une métrique.

AbstractVitamApplication.getBusinessMetricsRegistry().register("Running workflows",
    new Gauge<Long>() {
        @Override
        public Long getValue() {
            return runningWorkflows.get();
        }
    });

Avertissement

Avec la fonction register, si une métrique avec un nom identique est déjà enregistrée, alors l’ancienne métrique sera ecrasée par la nouvelle avec un avertissement dans les logs. En revanche, avec les fonctions de création de métrique comme timer, meter…, une exception sera soulevée.

2.12.4. Reporters

2 reporters sont disponibles, un reporter Logback (toutes les métriques sont dumpées dans Logback) ou bien un reporter ElasticSearch (toutes les métriques sont dumpées dans la base ElasticSearch Log). Le reporter est configurable avec un interval de temps entre chaque reporting.

Avertissement

Les index ElasticSearch ne sont pas configurables pour les métriques. Ils se nomment respectivement : * metrics-vitam-jersey-YYYY.MM.dd pour les métriques JERSEY * metrics-vitam-jvm-YYYY.MM.dd pour les métriques JVM * metrics-vitam-business-YYYY.MM.dd pour les métriques métier

2.12.5. Legacy

Pour celui ou celle qui souhaiterais continuer le développement du système de métriques au sein de VITAM, voici quelques points qui peuvent être intéressants à développer :

  • Pour un reporter ElasticSearch, vérifier l’état de la connexion à chaque reporting et augmenter progressivement le temps de reporting si la base de données n’est pas accessible.
  • Permettre le chargement de reporters de manière générique, en se passant du switch dans VitamMetrics et abstraire tout ce qui concerne le reporting.