コードを使用してトレーシングライブラリをセットアップし、APM データを収集するように Agent を構成した後、オプションで統合サービスタグ付けのセットアップなど、必要に応じてトレーシングライブラリを構成してください。
ddtrace-run を使用する場合、次の環境変数 (オプション) を利用できます。
DD_TRACE_DEBUGfalseDD_PATCH_MODULESDD_PATCH_MODULES=module:patch,module:patch...サービスに env、service、version を設定するには、DD_ENV、DD_SERVICE、DD_VERSION を使用することをおすすめします。このような環境変数の構成におすすめの方法については、統合サービスタグ付けのドキュメントをご参照ください。
DD_ENVprod、pre-prod、staging) を設定します。詳細については、環境の設定方法を参照してください。バージョン 0.38 以降で利用可能。DD_SERVICEDD_TRACE_PROPAGATION_STYLE_INJECTtracecontext,DatadogDD_TRACE_PROPAGATION_STYLE_INJECT=Datadog,B3 を使用すると、 Datadog と B3 形式のヘッダを注入することができます。DD_TRACE_PROPAGATION_STYLE_EXTRACTDD_TRACE_PROPAGATION_STYLE_INJECT の値 (tracecontext,Datadog)DD_TRACE_PROPAGATION_STYLE_EXTRACT=B3,Datadog は最初に B3 ヘッダーを探し、それが利用できない場合にのみ Datadog ヘッダーを使用します。DD_SERVICE_MAPPINGpostgres:postgresql,defaultdb:postgresql)。バージョン 0.47 以降で利用可能。DD_VERSION1.2.3、6c44da20、 2020.02.13) を設定します。バージョン 0.38 以降で利用可能。DD_TRACE_SAMPLE_RATEDD_TRACE_SAMPLING_RULES[]"sample_rate" を持たなければなりません。"name" と "service" フィールドは省略可能です。"sample_rate" の値は 0.0 と 1.0 の間でなければなりません (この値を含む)。ルールは、トレースのサンプルレートを決定するために設定された順序で適用されます。DD_TRACE_RATE_LIMITDD_TRACE_SAMPLE_RATE が設定されている場合、デフォルトは 100 です。それ以外の場合は、Datadog Agent にレート制限を委ねます。DD_SPAN_SAMPLING_RULES[]sample_rate の値は 0.0 から 1.0 の間でなければなりません (この値を含む)。my-service と演算子名 http.request のスパンサンプリングレートを 50% に設定し、1 秒間に最大 50 トレースします: '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'DD_TAGSlayer:api,team:intake,key:value)。バージョン 0.38 以降で利用可能。DD_TRACE_HEADER_TAGSnullDD_TRACE_HEADER_TAGS="User-Agent:http.user_agent,Referer:http.referer,Content-Type:http.content_type,Etag:http.etag" のようにします。DD_TRACE_ENABLEDtruefalse の場合、アプリケーションコードはトレースを生成しません。DD_AGENT_HOSTlocalhostDD_AGENT_PORT8126receiver_port や DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、DD_AGENT_PORT や DD_TRACE_AGENT_URL をそれに合わせなければなりません。DD_TRACE_AGENT_URLdatadog.yaml ファイル内の apm_config.receiver_socket 構成、または Datadog Agent に設定された DD_APM_RECEIVER_SOCKET 環境変数との組み合わせで Unix Domain Sockets (UDS) をサポートします。例えば、HTTP の URL には DD_TRACE_AGENT_URL=http://localhost:8126、UDS の URL には DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket を指定します。Agent 構成で receiver_port や DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、DD_AGENT_PORT や DD_TRACE_AGENT_URL をそれに合わせなければなりません。DD_DOGSTATSD_URLdatadog.yaml ファイル内の dogstatsd_socket 構成、または Datadog Agent に設定された DD_DOGSTATSD_SOCKET 環境変数との組み合わせで Unix Domain Sockets (UDS) をサポートします。例えば、UDP の URL には DD_DOGSTATSD_URL=udp://localhost:8126、UDS の URL には DD_DOGSTATSD_URL=unix:///var/run/datadog/dsd.socket を指定します。Agent 構成で dogstatsd_port や DD_DOGSTATSD_PORT をデフォルトの 8125 以外に設定した場合、このトレーシングライブラリ DD_DOGSTATSD_URL や DD_DOGSTATSD_PORT をそれに合わせなければなりません。DD_DOGSTATSD_HOSTlocalhostDD_DOGSTATSD_HOST をオーバーライドするには、 DD_AGENT_HOST を使用します。DD_DOGSTATSD_PORT8125dogstatsd_port や DD_DOGSTATSD_PORT をデフォルトの 8125 以外に設定した場合、このトレーシングライブラリ DD_DOGSTATSD_PORT や DD_DOGSTATSD_URL をそれに合わせなければなりません。DD_LOGS_INJECTIONfalseお役に立つドキュメント、リンクや記事:
