起動ログ

トレーサー起動ログは、起動時に取得可能なすべての情報を取得し、DATADOG TRACER CONFIGURATIONDATADOG TRACER DIAGNOSTICSDATADOG ERROR、または DATADOG CONFIGURATION として記録し、ログ内の検索を簡素化することができます。

言語によっては、言語の慣習や Stdout やそれに相当するものにアクセスする安全性に応じて、別のファイルにログを記録するものもあります。そのような場合、ログの場所は以下の言語タブに記されています。いくつかの言語では、診断エントリをログに残しません。

CONFIGURATION ログは、トレーサーに適用された設定の JSON 形式の表現です。Agent の接続性チェックが実行される言語では、コンフィギュレーション JSON には、Agent に到達できるかどうかを示す agent_error キーも含まれます。

DIAGNOSTICS または ERROR ログエントリは、それを生成する言語では、アプリケーションの起動中にトレーサーがエラーに遭遇したときに発生します。もし DIAGNOSTICS または ERROR のログ行が表示された場合は、表示されたログから設定や構成が正しく適用されていることを確認してください。

ログが全く表示されない場合は、アプリケーションのログが消されていないか、またログレベルが少なくとも INFO であることを確認してください (該当する場合)。

コンフィギュレーション:

2020/07/09 15:57:07 Datadog Tracer v1.26.0 INFO: DATADOG TRACER CONFIGURATION {"date":"2020-07-09T15:57:07-05:00","os_name":"darwin","os_version":"10.15.4","version":"v1.26.0","lang":"Go","lang_version":"go1.14.2","env":"","service":"splittest2","agent_url":"http://127.0.0.1:8126/v0.4/traces","agent_error":"","debug":true,"analytics_enabled":false,"sample_rate":"NaN","sampling_rules":null,"sampling_rules_error":"","tags":{"runtime-id":"d269781c-b1bf-4d7b-9a55-a8174930554f"},"runtime_metrics_enabled":false,"health_metrics_enabled":false,"dd_version":"","architecture":"amd64","global_service":""}

診断:

Go トレーサーは、2 つの可能性のある診断行の 1 つを出力します。1 つは Agent に到達できない場合で、もう 1 つはトレースサンプリングエラーです。

2020/07/09 15:57:07 Datadog Tracer v1.26.0 WARN: DIAGNOSTICS Unable to reach agent: [Reason for error]
2020/07/09 15:57:07 Datadog Tracer v1.26.0 WARN: DIAGNOSTICS Error(s) parsing DD_TRACE_SAMPLING_RULES:
    at index 1 ...
    at index 4 ....

接続エラー

アプリケーションや起動ログに DIAGNOSTICS エラーや Agent に到達できない、接続できないというメッセージ (言語によって異なる) がある場合、トレーサーが Datadog Agent にトレースを送ることができないことを意味します。

これらのエラーがある場合は、Agent が ECSKubernetesDocker またはその他のオプションのトレースを受信するようにセットアップされていることを確認するか、またはサポートチームまでお問い合わせの上、トレーサーと Agent の構成を確認してください。

インスツルメントされたアプリケーションが Datadog Agent と通信できないことを示すエラーについては、接続エラーを参照してください。

構成設定

ログに CONFIGURATION 行のみが含まれている場合にトラブルシューティングするには、トレーサーによって出力された設定が、Datadog トレーサーのデプロイと構成の設定と一致することを確認すると良いでしょう。さらに、Datadog に特定のトレースが表示されない場合は、ドキュメントの互換性要件セクションを確認して、これらのインテグレーションがサポートされていることを確認してください。

使用しているインテグレーションがサポートされていない場合や、Datadog でトレースが期待通りに表示されない理由を理解するために構成出力を新しい視点で確認したい場合は、サポートに連絡して診断を受けるか、新しいインテグレーションの機能リクエストを作成してください。

起動ログの無効化

言語ごとに、環境変数 DD_TRACE_STARTUP_LOGS=false を設定して起動ログを無効にできますが、これは、発行されたログが問題を引き起こしている場合にのみ行ってください。後でデバッグログを送信する場合は、サポートケースのトリアージを迅速化するために、起動ログを有効にし、関連するすべてのログをまとめて送信してください。

その他の参考資料

お役に立つドキュメント、リンクや記事:

PREVIEWING: hannahkm/clarify-v2-docs