Kubernetes トレース収集

アプリケーションのトレースを収集するには、Kubernetes クラスターで Datadog Agent を実行する必要があります。

セットアップ

Agent でのトレース収集を有効にするには、以下の手順に従います。

1. トレースを受け取るように Datadog Agent を構成する:

   • Dropdown

   • Helm チャートをまだインストールしていない場合は、インストールしてください。

   • 以下の APM コンフィギュレーションを使用して、values.yaml ファイルを更新します。

     datadog:
       ## @param apm - object - required
       ## Enable apm agent and provide custom configs
       #
       apm:
         ## @param enabled - boolean - optional - default: false
         ## Enable this to enable APM and tracing, on port 8126
         #
         enabled: true

     • オペレーティングシステムを設定します。values.yaml の 最上部に targetSystem: linux または targetSystem: windows を追加します。

     • 続いて、次のコマンド helm upgrade -f values.yaml <RELEASE NAME> datadog/datadog を使用して Datadog Helm チャートをアップグレードします。忘れずに YAML ファイルに API キーを設定します。values.yaml にオペレーディングシステムを設定していない場合は、このコマンドに --set targetSystem=linux または --set targetSystem=windows を追加します。

   APM トレースの収集を有効にするには、DaemonSet コンフィギュレーションファイルを開いて以下を編集します。

   • ポート 8126 からの受信データを許可します（ホストから Agent へトラフィックを転送する）:

      # (...)
           ports:
             # (...)
             - containerPort: 8126
               hostPort: 8126
               name: traceport
               protocol: TCP
      # (...)

   • 古いバージョンの Agent（7.17 以前）を使用している場合は、上記の手順に加えて、datadog.yaml トレース Agent マニフェストの env セクションで DD_APM_NON_LOCAL_TRAFFIC 変数と DD_APM_ENABLED 変数を true に設定してください。

      # (...)
           env:
             # (...)
             - name: DD_APM_ENABLED
               value: 'true'
             - name: DD_APM_NON_LOCAL_TRAFFIC
               value: "true"
      # (...)

   注: minikube では、Unable to detect the kubelet URL automatically エラーを受け取る可能性があります。その場合は、DD_KUBELET_TLS_VERIFY=false を設定してください。

2. アプリケーションポッドを構成して、Datadog Agent との通信に必要なホスト IP を取得する: Downward API を使用して、ホスト IP を取得します。アプリケーションコンテナには、status.hostIP をポイントする DD_AGENT_HOST 環境変数を定義してください。

       apiVersion: apps/v1
       kind: Deployment
        # ...
           spec:
             containers:
             - name: "<CONTAINER_NAME>"
               image: "<CONTAINER_IMAGE>"/"<TAG>"
               env:
                 - name: DD_AGENT_HOST
                   valueFrom:
                     fieldRef:
                       fieldPath: status.hostIP

3. トレースを送信するようにアプリケーショントレーサーを構成する: 環境変数 DD_AGENT_HOST を使用して、アプリケーションレベルのトレーサーが Datadog Agent ホストの場所をポイントするようにします。その他の例については、言語ごとの APM インスツルメンテーションドキュメントを参照してください。

Agent 環境変数

注: Datadog では、タグを付ける際のベストプラクティスとして、統合サービスタグ付けを使用することをおすすめしています。統合サービスタグ付けは、env、service、version の 3 つの標準タグを使用して Datadog テレメトリーと結合します。ご使用環境で統合タグ付けを構成する方法に関する詳細は、統合サービスタグ付けドキュメントをご参照ください。

Kubernetes で稼働する Agent 内のトレースに利用可能なすべての環境変数をリストします。

その他の参考資料

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

アプリケーションログの収集ドキュメント Prometheus メトリクスの収集ドキュメント アプリケーションのメトリクスとログを自動で収集ドキュメント データ収集をコンテナのサブセットのみに制限ドキュメント コンテナから送信された全データにタグを割り当てドキュメント