Présentation

Certaines des intégrations de Datadog basés sur OpenMetrics, y compris lʼintégration générique OpenMetrics, prennent en charge deux modes de fonctionnement : dernière et ancienne. Ces deux modes s’accompagnent de valeurs par défaut et de paramètres de configuration différents.

Dernière version

Datadog recommande d’utiliser la version latest et de se référer à la version latest de la documentation lors de la mise en place d’une intégration basée sur OpenMetrics à partir de zéro sur la dernière version de lʼAgent.

Ancienne version

La version legacy n’est maintenue que pour des raisons de compatibilité ascendante, principalement pour permettre à lʼintégration de continuer à fonctionner après une mise à niveau de lʼAgent sans devoir modifier la configuration.

Si vous avez déjà mis en place une intégration basée sur OpenMetrics, il se peut que vous utilisiez l’ancienne version, auquel cas vous pouvez utiliser l’exemple de configuration legacy lié à la documentation comme référence. Datadog recommande de migrer vers la version latest lorsque c’est possible.

Métriques dépendantes du mode

Les intégrations dotées des modes latest et legacy peuvent produire différents sous-ensembles de métriques, indiqués dans la documentation et dans les descriptions des métrique des apps comme OpenMetrics V2 (latest) et OpenMetrics V1 (legacy).

En mode latest, les métriques sont envoyées par défaut avec une précision renforcée. De plus, leur comportement est plus proche des types de métriques Prometheus. Par exemple, les métriques Prometheus qui se terminent par _count et _sum sont envoyées en tant que monotonic_count par défaut.

Lorsque vous recherchez des noms de métrique sur le site Datadog ou que vous configurez des dashboards et des monitors, veillez à utiliser des noms de métriques adaptés à votre version de lʼintégration.

Modes dʼintégration basés sur OpenMetrics

Bien que cela puisse varier pour chaque intégration basée sur OpenMetrics, vous pouvez activer le mode latest en procédant de l’une des manières suivantes :

• En configurant openmetrics_endpoint pour un endpoint cible.
• En définissant la valeur de use_openmetrics sur true.

Historique des dernières et des anciennes versions

Étant donné que le format OpenMetrics est couramment utilisé pour exporter des métriques, de nombreuses intégrations se basent dessus. Ces intégrations partagent un ensemble d’options de configuration et de comportements par défaut. Datadog s’engage à fournir une expérience améliorée dans la version latest et à maintenir l’expérience originale dans la version legacy.

Pour en savoir plus, consultez la documentation relative aux intégrations basées sur OpenMetrics.