コードを使用してトレーシングライブラリをセットアップし、APM データを収集するように Agent を構成した後、オプションで統合サービスタグ付けのセットアップなど、必要に応じてトレーシングライブラリを構成してください。

環境変数

DD_AGENT_HOST
バージョン: v0.3.6
デフォルト: localhost
トレースが送信されるホストを設定します (Agent を実行するホスト)。ホスト名または IP アドレスにできます。DD_TRACE_AGENT_URL が設定されている場合は無視されます。
DD_TRACE_AGENT_PORT
バージョン: v0.3.6
デフォルト: 8126
トレースを送信するポート (Agent が接続を待機しているポート) を設定します。DD_TRACE_AGENT_URL が設定されている場合は無視されます。Agent の構成receiver_port または DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、DD_TRACE_AGENT_PORT または DD_TRACE_AGENT_URL をそれに合わせる必要があります。
DD_TRACE_AGENT_URL
バージョン: v1.1.4
トレースが送信される URL のエンドポイントを設定します。設定されている場合は DD_AGENT_HOSTDD_TRACE_AGENT_PORT をオーバーライドします。この URL は HTTP、HTTPS、Unix のアドレススキームをサポートしています。Agent の構成receiver_port または DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、DD_TRACE_AGENT_PORT または DD_TRACE_AGENT_URL をそれに合わせる必要があります。
DD_ENV
バージョン: v1.0.0
指定された場合、特定の値を持つ env タグを生成されたすべてのスパンに追加します。
DD_SERVICE
バージョン: v1.1.4
指定された場合、デフォルトのサービス名を設定します。指定しない場合、TracerOptions または JSON コンフィギュレーション経由でサービス名を設定する必要があります。
DD_TRACE_ANALYTICS_ENABLED
非推奨
デフォルト: false
アプリケーションに対して App Analytics をグローバルに有効化します。
DD_TRACE_ANALYTICS_SAMPLE_RATE
*非推奨
App Analytics のサンプリングレートを設定します。設定時に DD_TRACE_ANALYTICS_ENABLED をオーバーライドします。0.01.0 の浮動小数点数となります。
DD_TRACE_SAMPLING_RULES
バージョン: v1.1.4
デフォルト: [{"sample_rate": 1.0}]
JSON のオブジェクト配列です。各オブジェクトの sample_rate フィールドは必須となります。name および service フィールドは任意項目です。sample_rate の値は 0.0 ~ 1.0 (それぞれの値を含む) の間でなければなりません。構成された順に、トレースのサンプルレートを決定するためのルールが適用されます。
DD_SPAN_SAMPLING_RULES
バージョン: v1.3.3
デフォルト: nil
オブジェクトの JSON 配列。ルールは、スパンのサンプルレートを決定するために構成された順序で適用されます。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_VERSION
バージョン: v1.1.4
指定された場合、特定の値を持つ version タグを生成されたすべてのスパンに追加します。
DD_TAGS
バージョン: v1.1.4
指定された場合、生成されたすべてのスパンにタグを追加します。key:value ペアのカンマ区切りリストとなります。
DD_TRACE_PROPAGATION_STYLE_INJECT
バージョン: v0.4.1
デフォルト: Datadog
トレーシングヘッダーの挿入時に使用する伝搬のスタイルです。DatadogB3、または Datadog B3 となります。
DD_TRACE_PROPAGATION_STYLE_EXTRACT
バージョン: v0.4.1
デフォルト: Datadog
トレーシングヘッダーの抽出時に使用する伝搬のスタイルです。DatadogB3、または Datadog B3 となります。

その他の参考資料