Présentation

Le protocole OpenTelemetry (OTLP) permet d’envoyer des histogrammes OTLP, un type de métrique qui compresse les informations sur un ensemble de mesures en fournissant des statistiques agrégées, telles que la somme, le nombre, le minimum et le maximum. Les histogrammes OTLP comptent également le nombre de ces mesures qui entrent dans des catégories configurables par l’utilisateur.

Vous pouvez visualiser ce type de données sous la forme d’une carte thermique dans Datadog en suivant les étapes décrites sur cette page.

Remarque : le type OTLP Exponential Histogram associé peut également être affiché sous forme de carte thermique, puisqu’il est converti en distribution. Pour en savoir plus sur les distributions, consultez la page dédiée aux distributions.

Implémentation

Ce guide part du principe que votre configuration permet d’envoyer des métriques OpenTelemetry à Datadog.

Configuration du SDK OpenTelemetry

Si vous générez des métriques à partir d’un SDK OpenTelemetry, suivez les étapes ci-dessous pour les configurer :

1. Configurez la temporalité delta pour le SDK servant à envoyer vos histogrammes OTLP. Cela permet au widget Carte thermique d’utiliser les valeurs minimales et maximales.
2. Choisissez si vous souhaitez remplacer les limites de compartiment par défaut de votre agrégation. Remarque : chaque compartiment supplémentaire est considéré comme une métrique custom distincte.

Pour les métriques provenant d’autres sources, assurez-vous, si possible, que ces métriques sont fournies en tant qu’histogrammes OTLP avec les champs de valeur minimale et de valeur maximale définis.

Configuration avec l’exportateur Datadog ou l’Agent Datadog

Définissez le mode Histogramme et activez les métriques d’agrégation sur votre exportateur Datadog ou sur l’Agent Datadog.

exporters:
  datadog:
    metrics:
      histograms:
        mode: counters
        send_aggregation_metrics: true

otlp_config:
  metrics:
    histograms:
      mode: counters
      send_aggregation_metrics: true

Configuration du widget Carte thermique

Le widget Carte thermique repose sur l’ensemble de métriques <NOM_MÉTRIQUE>.bucket généré par l’exportateur Datadog ou l’Agent Datadog. Chaque métrique correspondant à un compartiment d’histogramme distinct. Pour visualiser votre histogramme sous forme de carte thermique, procédez comme suit :

1. Sélectionnez la métrique <NOM_MÉTRIQUE>.bucket pour la visualiser.
2. Choisissez l’option pre-binned data dans le menu distributions of.

Vous pouvez alors visualiser votre histogramme OTLP au sein d’un widget Carte thermique.

Compatibilité d’OpenMetrics

Le check OpenMetrics de l’Agent Datadog est également compatible avec l’option pre-binned data du widget Carte thermique. Si vous souhaitez envoyer directement des métriques au check OpenMetrics, sans effectuer de conversion OpenTelemetry, activez les flags collect_histogram_buckets et non_cumulative_histogram_buckets sur votre instance pour vous assurer que les données sont envoyées à Datadog sans problème de compatibilité.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Types de métriques OTLPDOCUMENTATION Prise en charge d'OpenTelemetry dans DatadogDOCUMENTATION