概要

このチェックは、Linux TCP によるキューの送受信の使用方法を監視します。キューを送受信する TCP が個々のコンテナに対して満杯の状態であるかどうかを検知できます。

セットアップ

インストール

tcp_queue_length はコア Agent 6/7 のチェックで、system-probe に実装された eBPF パートに依存します。Agent バージョン 7.24.1/6.24.1 以上が必要です。

system-probe により使用される eBPF プログラムはランタイムでコンパイルされ、適切なカーネルヘッダーへのアクセスを必要とします。

Debian 系のディストリビューションでは、以下のようにカーネルヘッダーをインストールします。

apt install -y linux-headers-$(uname -r)

RHEL 系のディストリビューションでは、以下のようにカーネルヘッダーをインストールします。

yum install -y kernel-headers-$(uname -r)
yum install -y kernel-devel-$(uname -r)

注: バージョン 8 以前の Windows および CentOS/RHEL はサポートされません。

構成

tcp_queue_length インテグレーションを有効にするには、system-probe とコアエージェントの両方でコンフィギュレーションオプションを有効化する必要があります。

system-probe.yaml コンフィギュレーションファイル内で、以下のパラメーターを必ず設定してください。

system_probe_config:
  enable_tcp_queue_length: true

1. Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの tcp_queue_length.d/conf.yaml ファイルを編集して、 tcp_queue_length パフォーマンスデータの収集を開始します。 使用可能なすべてのコンフィギュレーションオプションについては、サンプル tcp_queue_length.d/conf.yaml を参照してください。

2. Agent を再起動します。

Helm のインテグレーション

Datadog Helm チャートを使用して、values.yaml ファイルで datadog.systemProbe.enabled を true に設定し、system-probe がアクティベートされている必要があります。 次に、datadog.systemProbe.enableTCPQueueLength パラメーターを設定してチェックをアクティベートします。

Operator (v1.0.0+) による構成

DatadogAgent マニフェストで features.tcpQueueLength.enabled パラメーターを設定します。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  features:
    tcpQueueLength:
      enabled: true

注: COS (Container Optimized OS) を使用する場合は、ノード Agent で src ボリュームをオーバーライドしてください。

apiVersion: datadoghq.com/v2alpha1
kind: DatadogAgent
metadata:
  name: datadog
spec:
  features:
    tcpQueueLength:
      enabled: true
  override:
    nodeAgent:
      volumes:
      - emptyDir: {}
        name: src

検証

Agent の status サブコマンドを実行し、Checks セクションで tcp_queue_length を探します。

収集データ

メトリクス

For each container, the tcp_queue_length integration returns the read/write buffer’s fill percentage of the busiest TCP connection. For example, if a container has three TCP connections, for which their read buffers (that is, receive queues) are 40%, 25%, and 80% full (respectively), the metric tcp_queue.read_buffer_max_usage_pct returns the maximum, 0.8 (80%).

サービスチェック

TCP Queue Length チェックには、サービスのチェック機能は含まれません。

イベント

TCP Queue Length チェックには、イベントは含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問い合わせください。