Après avoir configuré la bibliothèque de tracing avec votre code ainsi que l’Agent de façon à recueillir des données APM, vous pouvez ajuster sa configuration selon vos besoins, notamment en configurant le tagging de service unifié.

Il est conseillé d’utiliser DD_SERVICE, DD_ENV et DD_VERSION pour définir les paramètres env, service et version pour vos services. Consultez la documentation sur le tagging de service unifié pour en savoir plus sur les valeurs à configurer pour les variables d’environnement.

Variables d’environnement

Pour configurer le traceur à l’aide de variables d’environnement, définissez-les avant le lancement de l’application instrumentée.

DD_SERVICE
Depuis : v0.1.0
Définit le nom de service.
DD_ENV
Depuis : v0.1.0
Exemple : prod, pre-prod ou staging
Ajoute le tag env avec la valeur spécifiée à toutes les spans générées.
DD_VERSION
Depuis : v0.1.0
Exemple : 1.2.3, 6c44da20, 2020.02.13
Définit la version du service.
DD_TAGS
Depuis : v0.1.0
Exemple : team:intake,layer:api,foo:bar
Un liste séparée par des virgules de paires key:value à ajouter à toutes les spans générées.
DD_AGENT_HOST
Depuis : v0.1.0
Valeur par défaut : localhost
Définit le host vers lequel les traces sont envoyées (le host qui exécute l’Agent). Il peut s’agir d’un hostname ou d’une adresse IP. Ce paramètre est ignoré si DD_TRACE_AGENT_URL est défini.
DD_TRACE_AGENT_PORT
Depuis : v0.1.0
Valeur par défaut : 8126
Définit le port sur lequel les traces sont envoyées (le port sur lequel lʼAgent détecte les connexions). Ignoré si DD_TRACE_AGENT_URL est défini. Si la configuration de lʼAgent définit receiver_port ou DD_APM_RECEIVER_PORT sur une valeur autre que la valeur par défaut 8126, alors DD_TRACE_AGENT_PORT ou DD_TRACE_AGENT_URL doit correspondre à cette valeur.
DD_TRACE_AGENT_URL
Depuis : v0.1.0
Valeur par défaut : http://<DD_AGENT_HOST>:<DD_TRACE_AGENT_PORT> si définis, ou http://localhost:8126. Exemples :
URL HTTP : http://localhost:8126
Socket de domaine Unix : unix:///var/run/datadog/apm.socket

Définit lʼendpoint de l’URL où les traces sont envoyées. Remplace DD_AGENT_HOST et DD_TRACE_AGENT_PORT si défini. Cette URL prend en charge les schémas d’adresses HTTP, HTTPS et Unix.
Si la configuration de lʼAgent définit receiver_port ou DD_APM_RECEIVER_PORT sur une valeur autre que la valeur par défaut 8126, alors DD_TRACE_AGENT_PORT ou DD_TRACE_AGENT_URL doit correspondre à cette valeur.
DD_TRACE_RATE_LIMIT
Depuis : 0.1.0
Valeur par défaut : 200
Nombre maximum dʼenvoi de traces autorisé par seconde.
DD_TRACE_SAMPLE_RATE
Depuis : 0.1.0
Valeur par défaut : Le taux par défaut de lʼAgent Datadog ou 1.0.
Définit le taux d’échantillonnage pour toutes les traces générées. La valeur doit être comprise entre 0.0 et 1.0 (inclus). Par défaut, le taux d’échantillonnage est délégué à lʼAgent Datadog. Si aucun taux d’échantillonnage n’est défini par lʼAgent Datadog, la valeur par défaut est 1.0.
DD_TRACE_SAMPLING_RULES
Depuis : v0.1.0
Valeur par défaut : null
Exemples :
Définir le taux d’échantillonnage sur 20 % : [{"sample_rate": 0.2}]
Définir le taux d’échantillonnage de spans sur 50 % pour le service my-service et le nom de l’opération http.request, jusqu’à 50 traces par seconde : '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'

Un tableau d’objets JSON. Chaque objet doit avoir un sample_rate, et les champs name et service sont facultatif. La valeur de sample_rate doit être comprise entre 0.0 et 1.0 (inclus). Les règles sont appliquées dans un ordre configuré pour déterminer la fréquence d’échantillonnage de la trace.
Pour en savoir plus, consultez la section Mécanismes d’ingestion.
DD_SPAN_SAMPLING_RULES
Version : v0.1.0
Valeur par défaut : null
Un tableau d’objets JSON. Les règles sont appliquées dans un ordre configuré pour déterminer la fréquence d’échantillonnage de la span. La valeur de sample_rate doit être comprise entre 0.0 et 1.0 (inclus).
DD_SPAN_SAMPLING_RULES_FILE
Depuis : 0.1.0
Dirige vers un fichier JSON qui contient les règles d’échantillonnage de la span. Consultez DD_SPAN_SAMPLING_RULES pour obtenir le format des règles.
DD_PROPAGATION_STYLE
Depuis : 0.1.0
Liste séparée par des virgules des styles de propagation à utiliser lors de l’extraction et de l’injection du contexte de tracing.
Lorsque plusieurs valeurs sont données, l’ordre de la correspondance est basé sur l’ordre des valeurs.
DD_TRACE_PROPAGATION_STYLE_INJECT
Depuis : v0.1.6
Valeur par défaut : datadog,tracecontext
Valeurs acceptées : datadog, tracecontext, b3
Liste séparée par des virgules des styles de propagation à utiliser lors de l’injection du contexte de tracing. Lorsque plusieurs valeurs sont données, l’ordre de la correspondance est basé sur l’ordre des valeurs.
DD_TRACE_PROPAGATION_STYLE_EXTRACT
Depuis : v0.1.6
Valeur par défaut : datadog,tracecontext
Valeurs acceptées : datadog, tracecontext, b3
Liste séparée par des virgules des styles de propagation à utiliser lors de l’extraction du contexte de tracing. Lorsque plusieurs valeurs sont données, l’ordre de la correspondance est basé sur l’ordre des valeurs.
DD_TRACE_ENABLED
Depuis : 0.1.0
Valeur par défaut : true
Envoyer ou non des traces à lʼAgent Datadog.
Lorsque la valeur est false, la bibliothèque cesse d’envoyer des traces à lʼAgent Datadog. Cependant, la bibliothèque continue à générer des traces, à transmettre des données télémétriques et à rechercher des mises à jour de la configuration à distance.
DD_TRACE_REPORT_HOSTNAME
Depuis : 0.1.0
Valeur par défaut : false
Ajoute le tag hostname avec le résultat de gethostname.
DD_TRACE_STARTUP_LOGS
Depuis : 0.1.0
Valeur par défaut : true
Enregistrez la configuration du traceur une fois quʼil est entièrement initialisé.
DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED
Depuis : 0.1.6
Valeur par défaut : true
Si la valeur est true, le traceur génère des ID de trace de 128 bits.
Si la valeur est false, le traceur génère des ID de trace historiques de 64 bit.
DD_INSTRUMENTATION_TELEMETRY_ENABLED
Depuis : 0.1.12
Valeur par défaut : true
Datadog peut collecter des informations environnementales et de diagnostics sur votre système afin d’améliorer le produit. Lorsque la valeur est false, les données de télémétrie ne sont pas collectées.
DD_REMOTE_CONFIGURATION_ENABLED
Depuis : 0.2.0
Valeur par défaut : true
Active la capacité qui permet de configurer et de modifier à distance le comportement du traceur.
Lorsque la valeur est false, cette fonction est désactivée.
Pour obtenir plus d’informations, consultez la section Configuration à distance.
DD_REMOTE_CONFIG_POLL_INTERVAL_SECONDS
Depuis : 0.2.0
Valeur par défaut : 5.0
Définit la fréquence, en secondes, à laquelle lʼAgent Datadog reçoit les demandes de mise à jour de la configuration à distance.
DD_TRACE_DELEGATE_SAMPLING
Version : 0.2.0
Valeur par défaut : false
Si la valeur est true, délègue la décision d’échantillonnage de trace à un service enfant et favorise la décision résultante à la sienne, le cas échéant.

Pour aller plus loin