ポートを変更する必要がある場合は、メインの Agent 構成ファイル で dogstatsd_port オプションを構成してから、Agent を再起動してください。DogStatsD を UNIX ドメインソケット で使用するように設定することもできます。

独自の Agent DogStatsD サーバーの UDP ポートを有効にするには、次のようにします。

1. dogstatsd_port パラメータを設定します。

   ## @param dogstatsd_port - integer - optional - default: 8125
   ## Override the Agent DogStatsD port.
   ## Note: Make sure your client is sending to the same UDP port.
   #
   dogstatsd_port: 8125
   

2. Agent を再起動します。

デフォルトの場合、DogStatsD は、UDP ポート 8125 をリッスンしているため、コンテナ内で Agent を実行する際にはこのポートをホストポートにバインドする必要があります。StatsD メトリクスが localhost の外部からの場合は、メトリクス収集を許可するために DD_DOGSTATSD_NON_LOCAL_TRAFFIC を true に設定する必要があります。DogStatsD サーバーを起動した状態で Agent を実行するには、次のコマンドを実行します:

docker run -d --cgroupns host \
              --pid host \
              -v /var/run/docker.sock:/var/run/docker.sock:ro \
              -v /proc/:/host/proc/:ro \
              -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
              -e DD_API_KEY=<DATADOG_API_KEY> \
              -e DD_DOGSTATSD_NON_LOCAL_TRAFFIC="true" \
              -p 8125:8125/udp \
              registry.datadoghq.com/agent:latest

StatsD メトリクスの収集に使用するポートを変更する必要がある場合は、DD_DOGSTATSD_PORT="<NEW_DOGSTATSD_PORT> 環境変数を使用してください。DogStatsD を UNIX ドメインソケット で使用するように設定することもできます。

StatsD メトリクスの収集は、UNIX ドメインソケットにおいて、デフォルトで有効になっています。UDP 経由で StatsD メトリクスの収集を開始するには、Operator 設定で DogStatsD 機能を有効にする必要があります。

1. features.dogstatsd.hostPortConfig.enabled を datadog-agent.yaml マニフェストに追加します。

   features:
       dogstatsd:
           hostPortConfig:
               enabled: true
   

   This is an example datadog-agent.yaml manifest:

   apiVersion: datadoghq.com/v2alpha1
   kind: DatadogAgent
   metadata:
     name: datadog
   spec:
     global:
       credentials:
         apiSecret:
           secretName: datadog-secret
           keyName: api-key
     features:
       dogstatsd:
         hostPortConfig:
           enabled: true
   

   This enables the Agent to collect StatsD metrics over UDP on port 8125.

2. 変更を適用します。

   kubectl apply -f datadog-agent.yaml
   

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

StatsD メトリクスを Agent に送信する

アプリケーションには、ホストの IP アドレスを特定するための信頼できる手段が必要です。Kubernetes 1.7 ではそれが簡単に実現されています。これにより、Pod に環境変数として渡すことができる属性のセットが拡張されます。バージョン 1.7 以降では、PodSpec に環境変数を追加することで、ホスト IP を任意の Pod に渡すことができます。たとえば、アプリケーションのマニフェストは次のようになります。

env:
    - name: DD_AGENT_HOST
      valueFrom:
          fieldRef:
              fieldPath: status.hostIP

これにより、アプリケーションを実行している Pod は、$DD_AGENT_HOST のポート 8125 で DogStatsD メトリクスを送信できるようになります。

注: ベストプラクティスとして、Datadog では属性を割り当てる際に統合サービスタグ付けを使用することが推奨されています。unified service tagging は、env、service、および version の 3 つの標準タグを使用して Datadog テレメトリを結び付けます。環境を統一する方法については、unified service taggingを参照してください。

DogStatsD で helm を使用してカスタムメトリクスを収集するには:

1. datadog-values.yaml ファイルを更新して DogStatsD を有効にします。

     dogstatsd:
       port: 8125
       useHostPort: true
       nonLocalTraffic: true
   

   Note: hostPort functionality requires a networking provider that adheres to the CNI specification, such as Calico, Canal, or Flannel. For more information, including a workaround for non-CNI network providers, see the Kubernetes documentation: HostPort services do not work.

   Warning: The hostPort parameter opens a port on your host. Make sure your firewall only allows access from your applications or trusted sources. If your network plugin doesn’t support hostPorts, so add hostNetwork: true in your Agent pod specifications. This shares the network namespace of your host with the Datadog Agent. It also means that all ports opened on the container are opened on the host. If a port is used both on the host and in your container, they conflict (since they share the same network namespace) and the pod does not start. Some Kubernetes installations do not allow this.

2. Agent コンフィギュレーションをアップグレードします。

   helm upgrade -f datadog-values.yaml <RELEASE_NAME> datadog/datadog
   

3. アプリケーション Pod を更新する: アプリケーションには、ホストの IP アドレスを特定するための信頼できる手段が必要です。Kubernetes 1.7 ではそれが簡単に実現されています。これにより、Pod に環境変数として渡すことができる属性のセットが拡張されます。バージョン 1.7 以降では、PodSpec に環境変数を追加することで、ホスト IP を任意の Pod に渡すことができます。たとえば、アプリケーションのマニフェストは次のようになります。

   env:
       - name: DD_AGENT_HOST
         valueFrom:
             fieldRef:
                 fieldPath: status.hostIP
   

   With this, any pod running your application is able to send DogStatsD metrics through port 8125 on $DD_AGENT_HOST.

Linux の場合、コンテナ ID は procfs に関連するエントリから cgroups を抽出することで取得できます。クライアントは /proc/self/cgroup または /proc/self/mountinfo から読み取って、コンテナ ID の解析を試みます。

cgroup v2 では、/proc/self/cgroup から cgroup パスを解決し、/proc/self/mountinfo からの cgroup マウントポイントと組み合わせることによりコンテナ ID を推測できます。結果として得られるディレクトリの inode が Datadog Agent に送信されます。Datadog Agent がクライアントと同じノードにある場合、この情報を使用して Pod の UID を特定できます。

UDP 経由の発信点検出を有効にするには、アプリケーションマニフェストに次の行を追加します。

env:
- name: DD_ENTITY_ID
    valueFrom:
      fieldRef:
        fieldPath: metadata.uid

DogStatsD クライアントが内部タグ entity_id を追加します。このタグの値は DD_ENTITY_ID 環境変数の内容であり、それは Pod の UID です。

自分の Pod に以下のラベルを追加します。

admission.datadoghq.com/enabled: "true"

Pod にこのラベルがある場合、Admissions Controller により環境変数 DD_EXTERNAL_ENV が注入されます。この変数の値がメトリクスと共にフィールドに入れられて送信されます。Datadog Agent は、これを使用してメトリクスの発信点を特定できます。