Unix ドメインソケット上の DogStatsD

1. Agent のメイン構成ファイルを編集して、DogStatsD がリスニングソケットを作成するパスを dogstatsd_socket に設定します。

   ## @param dogstatsd_socket - string - optional - default: ""
   ## Listen for Dogstatsd metrics on a Unix Socket (*nix only).
   ## Set to a valid and existing filesystem path to enable.
   #
   dogstatsd_socket: '/var/run/datadog/dsd.socket'
   

2. Agent を再起動します。

1. Agent コンテナの環境変数 DD_DOGSTATSD_SOCKET=<あなたの UDS パス> でソケットパスを設定します。

2. アプリケーションコンテナ (読み取り専用) と Agent コンテナ (読み書き) の両側でホストディレクトリをマウントし、ソケットファイルをアプリケーションコンテナへアクセスできるようにします。個別のソケットではなく親フォルダーをマウントすることで、DogStatsD が再起動してもソケット通信を維持することができます。

   • -v /var/run/datadog:/var/run/datadog で Agent コンテナを起動します。
   • -v /var/run/datadog:/var/run/datadog:ro でアプリケーションコンテナを起動します。

1. Agent コンテナの環境変数 DD_DOGSTATSD_SOCKET=<YOUR_UDS_PATH> でソケットパスを設定します (例: /var/run/datadog/dsd.socket)。

2. アプリケーションコンテナ (読み取り専用) と Agent コンテナ (読み書き) の両側でホストディレクトリをマウントし、ソケットファイルをアプリケーションコンテナへアクセスできるようにします。個別のソケットではなく親フォルダーをマウントすることで、DogStatsD が再起動してもソケット通信を維持することができます。

   • datadog-agent コンテナでソケットフォルダーをマウントします。

     volumeMounts:
         - name: dsdsocket
           mountPath: /var/run/datadog
         ##...
     volumes:
         - hostPath:
               path: /var/run/datadog/
           name: dsdsocket
     

   • 同じフォルダーをアプリケーションコンテナで公開します。

     volumeMounts:
         - name: dsdsocket
           mountPath: /var/run/datadog
           readOnly: true
         ## ...
     volumes:
         - hostPath:
               path: /var/run/datadog/
           name: dsdsocket
     

     注: アプリケーションコンテナでソケットへの書き込みアクセス許可が必要な場合は、 readOnly: true を削除してください。

1. Agent のメイン構成ファイルで dogstatsd_origin_detection オプションを有効にします。

   ## @param dogstatsd_origin_detection - boolean - optional - default: false
   ## When using Unix Socket, DogStatsD can tag metrics
   ## with container metadata. If running DogStatsD in a container,
   ## host PID mode (e.g. with --pid=host) is required.
   #
   dogstatsd_origin_detection: true
   

2. 任意 - 発信点検出を使用して収集されたメトリクスにタグカーディナリティを設定するには、パラメーター dogstatsd_tag_cardinality に low (デフォルト)、orchestrator、または high を使用します。

   ## @param dogstatsd_tag_cardinality - string - optional - default: low
   ## Configure the level of granularity of tags to send for DogStatsD
   ## metrics and events. Choices are:
   ##   * low: add tags about low-cardinality objects
   ##     (clusters, hosts, deployments, container images, ...)
   ##   * orchestrator: add tags about pods (Kubernetes),
   ##     or tasks (ECS or Mesos) -level of cardinality
   ##   * high: add tags about high-cardinality objects
   ##     (individual containers, user IDs in requests, etc.)
   ##
   ## WARNING: Sending container tags for DogStatsD metrics may create
   ## more metrics (one per container instead of one per host).
   ## This may impact your custom metrics billing.
   #
   dogstatsd_tag_cardinality: low
   

3. Agent を再起動します。

1. Agent コンテナの環境変数 DD_DOGSTATSD_ORIGIN_DETECTION=true を設定します。

2. 任意 - 発信点検出を使用して収集されたメトリクスに[タグカーディナリティ][5]を設定するには、環境変数 DD_DOGSTATSD_TAG_CARDINALITY に low (デフォルト)、orchestrator、または high を使用します。

DogStatsD がコンテナ内で実行されている場合、発信点検出を高い信頼性で行うには、DogStatsD をホストの PID ネームスペースで実行する必要があります。そのため、--pid=host フラグを用いて Docker で有効にします。注: これは、コンテナのタスク定義内の "pidMode": "host" パラメーターを使用して、ECS によってサポートされます。このオプションは、Fargate ではサポートされません。詳細については、PID モードで AWS のドキュメントを参照してください。

1. Agent コンテナの環境変数 `DD_DOGSTATSD_ORIGIN_DETECTION を true に設定します。

   # (...)
   env:
       # (...)
       - name: DD_DOGSTATSD_ORIGIN_DETECTION
         value: 'true'
   

2. 任意 - 発信点検出を使用して収集されたメトリクスにタグカーディナリティを設定するには、環境変数 DD_DOGSTATSD_TAG_CARDINALITY に low (デフォルト)、orchestrator、または high を使用します。

   # (...)
   env:
       # (...)
       - name: DD_DOGSTATSD_TAG_CARDINALITY
         value: 'low'