Surveillance de Micrometer
Une fois l'agent hôte d' Instana s installé, le capteur d' Micrometer est automatiquement installé et activé. Vous pouvez consulter les indicateurs liés à l' Micrometer ation dans l'interface utilisateur d' Instana.
Informations de support
Pour vous assurer que le capteur d' Micrometer s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :
Versions prises en charge
Prise en charge confirmée des métriques personnalisées pour 1.0.0x.
Capteur (collecte de données)
Micrometer est une interface de métriques simple pour l' JVM. Il s'agit de la norme de facto au sein de l'écosystème d' Java, et il est intégré à SpringBoot. Pour plus d'informations, consultez le site Micrometer.
Instana assure la prise en charge de Micrometer sans aucune configuration supplémentaire. Le capteur détecte l'utilisation de Micrometer et collecte automatiquement les métriques. Aucune dépendance d' Maven s supplémentaire n'est requise.
Un registre Micrometer MeterRegistry est uniquement reconnu lorsqu'une méthode publique est appelée sur l'objet MeterRegistry, une fois la machine virtuelle Java instrumentée. Lorsque vous initialisez un registre de métriques à l'aide d'un constructeur public, seule la méthode publique est exécutée avant le démarrage de l'agent d' Instana. Par conséquent, dès qu'une méthode publique de l'interface MeterRegistry's est appelée après le démarrage de l'agent, celui-ci détecte le registre.
Tous les graphiques de métriques sont affichés sur le tableau de bord JVM.
Affichage des mesures
Pour consulter les indicateurs, procédez comme suit :
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- Cliquez sur un hôte surveillé spécifique pour afficher le tableau de bord de cet hôte, qui présente toutes les métriques collectées et les processus surveillés.
Données de configuration
Si l' JVM e a chargé la bibliothèque de métriques Micrometer, les métriques personnalisées sont automatiquement collectées et affichées sur le tableau de bord JVM. Pour éviter toute surcharge du backend, une limite par défaut de 200 métriques par JVM est définie. Vous pouvez utiliser le tagExtractionMetricPatterns paramètre pour extraire les balises de certaines métriques. Vous pouvez fournir une liste d'expressions régulières pour filtrer les métriques en vue de l'extraction de balises. Les balises sont extraites uniquement des métriques qui correspondent aux modèles spécifiés, à savoir tagExtractionMetricPatterns. Si vous extrayez des balises à partir d'un grand nombre de métriques, le volume de données ingérées risque d'augmenter.
Pour désactiver la surveillance d' Micrometer s ou modifier la limite des métriques, utilisez la configuration suivante :
com.instana.plugin.java:
micrometerMetricCollection:
enabled: false
limit: 200
tagExtractionMetricPatterns:
- '^my_metric'
- 'abc+'
Si les indicateurs ne s'affichent pas une fois la bibliothèque chargée, définissez votre io.micrometer.core.instrument.MeterRegistry instance comme instance par défaut. Par exemple :
import io.micrometer.core.instrument.Metrics;
Metrics.globalRegistry.add(meterRegistry)
Métriques
Le tableau suivant présente le capteur qui recueille tous les types de mesures :
| Type de métrique | Description |
|---|---|
| Compteur | Nombre cumulé depuis la création de ce compteur |
| DistributionSummary | Récapitulatif de tous les événements enregistrés |
| FunctionCounter | Nombre cumulé depuis la création de ce compteur |
| FunctionTimer | Durée totale de toutes les occurrences de l'événement chronométré |
| Gauge | Valeur actuelle |
| LongTaskTimer | Nombre actuel de tâches en cours d'exécution |
| Temporisateur | Durée totale des événements enregistrés, en millisecondes |
| TimeGauge | Valeur actuelle, étendue à l'unité de base appropriée |
Pour plus d'informations, consultez la page « Micrometer metrics ».
L'exemple suivant présente les noms de métriques qui contiennent des balises concaténées lorsque celles-ci ne sont pas extraites :
exception=None, method=GET, outcome=SUCCESS,
status=200, version=1.0, maintainer=instana
L'exemple suivant présente les noms des indicateurs lors de l'extraction des balises :
{action="hello",name="fabian",}
Les indicateurs commençant par "jvm", "process", "tomcat", "system", "logback" sont automatiquement exclus de la surveillance.
Registre Micrometer Prometheus
Le registre « Prometheus Meter Registry » est un sous-projet de l'écosystème Micrometer destiné à l'exportation de données métriques au format Prometheus. Si vous utilisez cette extension et souhaitez conserver votre format métrique actuel, vous pouvez intégrer la surveillance de la bibliothèque client Instana PrometheusJava. Vous devez toutefois ajouter une ligne de code comme indiqué sur github.com/instana/prometheus-java-library-integration.