Logs de lancement du traceur

Logs de lancement

Les logs de lancement du traceur capturent toutes les informations accessibles au lancement et les enregistrent en tant que logs DATADOG TRACER CONFIGURATION ou DATADOG TRACER DIAGNOSTICS afin de faciliter la recherche au sein de vos logs.

Selon leurs conventions et la sécurité d’accès à Stdout (ou équivalent), certains langages peuvent écrire les logs dans un fichier distinct. Dans ces cas de figure, l’emplacement des logs est indiqué dans l’onglet du langage concerné ci-dessous. Certains langages n’enregistrent pas d’entrée de diagnostic (voir ci-dessous).

Les logs CONFIGURATION représentent les paramètres appliqués à votre traceur au format JSON. Dans le cas des langages pour lesquels un check de connectivité de l’Agent est effectué, la configuration JSON comprend également une clé agent_error indiquant si l’Agent est disponible ou non.

Les entrées de log DIAGNOSTICS sont générées, pour les langages qui les prennent en charge, lorsque le traceur rencontre une erreur pendant le lancement de l’application. Si des lignes de log DIAGNOSTICS s’affichent, vérifiez bien sur le log en question que les paramètres et les configurations sont correctement appliqués. 

Si vous ne voyez aucun log, assurez-vous que les logs de votre application ne sont pas désactivés et que le niveau de log est défini sur INFO ou un niveau supérieur.

Configuration :


{"agent_url":"http://localhost:8126","analytics_enabled":false,"analytics_sample_rate":null,"date":"2020-07-03T00:44:37+0000","dd_version":"","enabled":true,"env":"test-env","lang":"cpp","lang_version":"201402","operation_name_override":"","report_hostname":false,"sampling_rules":"[{\"sample_rate\": 1.0}]","service":"service_name","tags":{},"version":"v1.2.0"}

Diagnostic :

Pour C++, aucune ligne DATADOG TRACER DIAGNOSTICS n’est générée dans les logs du traceur. Toutefois, si l’Agent est indisponible, les erreurs s’affichent dans les logs de votre application. Dans ce cas, vous pouvez également constater une hausse des métriques tracing.datadog.reports_failed et tracing.datadog.reports_dropped dans Envoy.

Erreurs de connexion

Si vos logs d’application ou de lancement contiennent des erreurs DIAGNOSTICS ou des messages indiquant que l’Agent est indisponible ou que la connexion à l’Agent est impossible (ces messages varient en fonction du langage), cela signifie que le traceur ne parvient pas à envoyer des traces à l’Agent Datadog.

Si vous trouvez ces erreurs, vérifiez que votre Agent a été configuré pour recevoir des traces pour ECS, Kubernetes, Docker ou toute autre option. Vous pouvez également contacter l’équipe d’assistance pour demander à ce que la configuration de votre traceur et de votre Agent soit examinée.

Consultez la section relative aux erreurs de connexion pour en savoir plus sur les erreurs indiquant que votre application instrumentée ne peut pas communiquer avec l’Agent Datadog.

Paramètres de configuration

Si vos logs contiennent uniquement des lignes CONFIGURATION, une étape de dépannage utile consiste à confirmer que les paramètres renvoyés par le traceur correspondent aux paramètres de votre déploiement et de votre configuration du traceur Datadog. Si des traces spécifiques ne s’affichent pas dans Datadog, vous pouvez également consulter la section Exigences de comptabilité de la documentation pour vérifier que ces intégrations sont prises en charge.

Si l’une de vos intégrations n’est pas prise en charge, ou si vous souhaitez qu’une personne extérieure examine la configuration renvoyée afin de comprendre pourquoi les traces ne s’affichent pas comme prévu dans Datadog, contactez l’équipe d’assistance. Elle sera en mesure de vous aider à établir un diagnostic et à créer une demande d’ajout de fonctionnalité pour une nouvelle intégration.

Désactiver les logs de lancement

Vous pouvez désactiver les logs de lancement pour chaque langage en définissant la variable d’environnement DD_TRACE_STARTUP_LOGS=false. Toutefois, faites-le uniquement si les logs envoyés posent problème. Si vous envoyez des logs de debugging par la suite, n’oubliez pas d’activer les logs de lancement et d’envoyer tous les logs pertinents d’une traite afin d’accélérer le traitement de vos tickets d’assistance.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Dépanner des erreurs de connexion APMDOCUMENTATION more more