datadog-agent.yaml を編集して、features.apm.enabled を true に設定します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    apm:
      enabled: true
      unixDomainSocketConfig:
        path: /var/run/datadog/apm.socket # default

APM が有効になると、デフォルトの構成ではホスト上にディレクトリが作成され、Agent 内にマウントされます。次に Agent はソケットファイル /var/run/datadog/apm/apm.socket を作成し、リッスンします。アプリケーションポッドは、このボリュームを同様にマウントし、同じソケットに書き込むことができます。features.apm.unixDomainSocketConfig.path 構成値を使用してパスとソケットを変更できます。

After making your changes, apply the new configuration by using the following command:

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

注: minikube では、Unable to detect the kubelet URL automatically エラーが発生する場合があります。この場合、global.kubelet.tlsVerify を false に設定します。

Datadog Agent のインストールに Helm を使用した 場合、APM は UDS または Windows の名前付きパイプでデフォルトで有効になっています。

確認するには、datadog-values.yaml で、datadog.apm.socketEnabled がtrue に設定されていることを確認してください。

datadog:
  apm:
    socketEnabled: true    

デフォルトの構成では、ホスト上にディレクトリが作成され、Agent 内にマウントされます。次に Agent はソケットファイル /var/run/datadog/apm.socket を作成し、リッスンします。アプリケーションポッドは、このボリュームを同様にマウントし、同じソケットに書き込むことができます。datadog.apm.hostSocketPath および datadog.apm.socketPath 構成値を使用してパスとソケットを変更できます。

datadog:
  apm:
    # the following values are default:
    socketEnabled: true
    hostSocketPath: /var/run/datadog/
    socketPath: /var/run/datadog/apm.socket

APM を無効にするには、datadog.apm.socketEnabled を false に設定します。

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

注: minikube では、Unable to detect the kubelet URL automatically エラーが発生する場合があります。この場合、datadog.kubelet.tlsVerify を false に設定します。

Datadog Admission Controller は、アプリケーションポッドの構成を簡素化する Datadog Cluster Agent のコンポーネントです。Datadog Admission Controller ドキュメント を参照して、詳細を学べます。

Datadog Admission Controller を使用して、新しいアプリケーションポッドに環境変数を注入し、必要なボリュームをマウントし、自動的にポッドと Agent のトレース通信を構成します。Datadog Agent にトレースを送信するためにアプリケーションを自動的に構成する方法について詳しくは、Admission Controller を使用したライブラリの注入 ドキュメントをご覧ください。

UDS を使用して Agent にトレースを送信する場合は、ソケットのあるホストディレクトリ (Agent が作成したもの) をアプリケーションコンテナにマウントし、ソケットへのパスを DD_TRACE_AGENT_URL で指定します。

apiVersion: apps/v1
kind: Deployment
#(...)
    spec:
      containers:
      - name: "<CONTAINER_NAME>"
        image: "<CONTAINER_IMAGE>/<TAG>"
        env:
        - name: DD_TRACE_AGENT_URL
          value: 'unix:///var/run/datadog/apm.socket'
        volumeMounts:
        - name: apmsocketpath
          mountPath: /var/run/datadog
        #(...)
      volumes:
        - hostPath:
            path: /var/run/datadog/
          name: apmsocketpath

以下の手順で、アプリケーション SDK がトレースを送信するように構成します。

Datadog Agent がトレースを収集するように構成し、アプリケーションポッドにトレースの送信先に関する設定を行った後、Datadog SDK をアプリケーションにインストールしてトレースを送信します。これが完了すると、SDK は適切な DD_TRACE_AGENT_URL エンドポイントにトレースを送信します。

TCP (<IP_ADDRESS>:8126) を使用して Agent にトレースを送信している場合、この IP アドレスをアプリケーションポッドに供給します。Datadog Admission Controller で自動的に、または手動で下位 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

注: この構成では、Agent が TCP 上のトレースを受け入れるように構成されている必要があります。

以下の手順で、アプリケーション SDK がトレースを送信するように構成します。

Datadog Agent がトレースを収集するように構成し、アプリケーションポッドにトレースの送信先に関する設定を行った後、Datadog SDK をアプリケーションにインストールしてトレースを送信します。これが完了すると、SDK は適切な DD_AGENT_HOST エンドポイントにトレースを自動的に送信します。

以下の内容で datadog-agent.yaml を更新します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  global:
    credentials:
      apiKey: <DATADOG_API_KEY>

  features:
    apm:
      enabled: true
      hostPortConfig:
        enabled: true
        hostPort: 8126 # default

After making your changes, apply the new configuration by using the following command:

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

警告: hostPort パラメーターによりホスト上のポートが開かれます。ファイアウォールが、アプリケーションまたは信頼できるソースからのアクセスのみを許可することを確認してください。ネットワークプラグインで hostPorts がサポートされていない場合は、Agent Pod の仕様に hostNetwork: true を追加してください。これにより、ホストのネットワークネームスペースが Datadog Agent と共有されます。これは、コンテナ上で開かれるすべてのポートがホスト上でも開かれることを意味します。ホストとコンテナの両方でポートが使用されている場合、それらは競合し (同じネットワークネームスペースを共有しているため)、Pod は起動しません。一部の Kubernetes インストールでは、これは許可されていません。

以下の APM の構成を使用して datadog-values.yaml ファイルを更新します。

datadog:
  apm:
    portEnabled: true
    port: 8126 # default

After making your changes, upgrade your Datadog Helm chart using the following command:

helm upgrade -f datadog-values.yaml <RELEASE NAME> datadog/datadog

警告: datadog.apm.portEnabled パラメーターによりホスト上のポートが開かれます。ファイアウォールが、アプリケーションまたは信頼できるソースからのアクセスのみを許可することを確認してください。ネットワークプラグインで hostPorts がサポートされていない場合は、Agent Pod の仕様に hostNetwork: true を追加してください。これにより、ホストのネットワークネームスペースが Datadog Agent と共有されます。これは、コンテナ上で開かれるすべてのポートがホスト上でも開かれることを意味します。ホストとコンテナの両方でポートが使用されている場合、それらは競合し (同じネットワークネームスペースを共有しているため)、Pod は起動しません。一部の Kubernetes インストールでは、これは許可されていません。

override.nodeAgent.containers.trace-agent.env の下に、以下のように追加の APM 環境変数を設定します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  override:
    nodeAgent:
      containers:
        trace-agent:
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>

agents.containers.traceAgent.env の下に、以下のように追加の APM 環境変数を設定します。

agents:
  containers:
    traceAgent:
      env:
        - name: <ENV_VAR_NAME>
          value: <ENV_VAR_VALUE>

DaemonSet または Deployment (Datadog Cluster Agent 用) に環境変数を追加します。

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: datadog
spec:
  template:
    spec:
      containers:
        - name: agent
          ...
          env:
            - name: <ENV_VAR_NAME>
              value: <ENV_VAR_VALUE>