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 を追加します。

   • API キーを設定: apiKey: <DATADOG_API_KEY>

   • Agent が適切な Datadog の場所にデータを送信できるよう、サイトを設定します: site:

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

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

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

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

   • サイト site: を設定し、Agent が適切な Datadog の場所にデータを送信できるようにします

   • 古いバージョンの 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"
      # (...)
     

   datadog-agent.yaml マニフェストを、以下で更新します:

   agent:
     image:
       name: "gcr.io/datadoghq/agent:latest"
     apm:
       enabled: true
       hostPort: 8126
   

   agent:
     image:
       name: "gcr.io/datadoghq/agent:latest"
     apm:
       enabled: true
       hostPort: 8126
   site: <DATADOG_SITE>
   

   DD_SITE が である場所: Agent が正しい Datadog の場所にデータを送信。

   完全な例については、APM とメトリクス収集が有効になっているマニフェストの例を参照してください。

   次に、新しいコンフィギュレーションを適用します。

   $ kubectl apply -n $DD_NAMESPACE -f datadog-agent.yaml
   

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

2. Datadog Agent と通信するためにホスト IP をプルするようにアプリケーションポッドを構成します:

• Datadog Admission Controller を使用して自動的に、または

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