基本的な Agent の利用方法

Agent v6 と v7は、インフラストラクチャーメトリクスとログの収集、そして DogStatsD メトリクスの受信を担当する 1 つのメインプロセスで構成されています。このプロセスの主なコンポーネントは次のとおりです。

• コレクター: チェックの実行とメトリクスの収集を行います。
• フォーワーダー: Datadog にペイロードを送信します。

datadog.yaml 構成ファイルで有効にすると、次の 2 つのオプションのプロセスが Agent によって生成されます。

• APM Agent: トレースを収集するプロセスです (デフォルトで有効になっています)。
• Process Agent: ライブプロセス情報を収集するプロセスです。デフォルトでは使用できるコンテナのみを収集し、その他に対しては無効になります。

Windows では、サービスは次のように一覧表示されます。

Agent がデフォルトでバインドするポートは、Linux では 3 個、Windows と OSX では 4 個です。

ポートの構成については、ネットワークトラフィックを参照してください。

コレクター

コレクターは、15 秒ごとにすべての標準のメトリクスを収集します。Agent v6 埋め込みの Python2.7 インタープリターは、インテグレーションとカスタムチェックを実行します。

Forwarder

Agent フォワーダーは、メトリクスを HTTPS 経由で Datadog に送信します。バッファリングを行うと、ネットワークスプリットがメトリクスの報告に影響を与えることを防ぐことができます。メトリクスは、処理待ちの送信リクエストのサイズまたは数が制限に達するまで、メモリにバッファされます。その後、フォワーダーのメモリのフットプリントを管理可能な範囲に保つために、最も古いメトリクスが破棄されます。ログは、SSL 暗号化 TCP 接続経由で Datadog に送信されます。

DogStatsD

v6 の DogStatsD は、Etsy の StatsD メトリクス集計デーモンの Go 言語実装です。UDP または Unix ソケット経由で任意のメトリクスを受信してロールアップするために使用され、構成要素の一部としてカスタムコードを組み込んでもレイテンシーが発生しません。DogStatsD についての詳細はこちらでご確認いただけます。

Agent v5 は、以下に示す主な 4 つのコンポーネントで構成され、それぞれ別のプロセスとして実行される Python で記述されます。

• コレクター (agent.py): コレクターは、現在のマシンで構成されているインテグレーションのチェックを実行し、メモリや CPU などのシステムメトリクスをキャプチャします。
• DogStatsD (dogstatsd.py): アプリケーションからカスタムメトリクスを送信できる StatsD 互換可能バックエンドサーバーです。
• フォワーダー (ddagent.py): フォワーダーは、DogStatsD とコレクターの両方からデータを取得し、クエリを実行し、Datadog に送信します。
• SupervisorD: 全体が 1 つのスーパーバイザープロセスで制御されます。すべての要素を実行しない場合に各アプリケーションのオーバーヘッドを制限するために、分離されています。ただし、原則としてすべての要素を実行することをお勧めします。

注: Windows の場合、4 つの Agent プロセスはいずれも ddagent.exe インスタンスとして、DevOps' best friend という説明とともに表示されます。

監督、特権、ネットワークポート

SupervisorD プライマリプロセスは、dd-agent ユーザーとして実行され、分岐したすべてのサブプロセスは同じユーザーとして実行されます。これは、Datadog Agent によって開始されたシステムコール (iostat/netstat) にも適用されます。Agent 構成は、/etc/dd-agent/datadog.conf と /etc/dd-agent/conf.d にあります。すべての構成は、dd-agent によって読み取り可能である必要があります。構成ファイルには API キーとメトリクスにアクセスするために必要な他の証明書が含まれるので、推奨されるアクセス許可は 0600 です。

操作のために次のポートが開かれています。

v3.4.1 以上の Agent では、すべてのリスニングプロセスはデフォルトで 127.0.0.1 と ::1 にバインドされます。以前のバージョンでは、0.0.0.0 (すべてのインターフェイス) にバインドされます。プロキシから Agent を実行する詳細については、Agent のプロキシ構成を参照してください。許可される IP 範囲の詳細については、ネットワークトラフィックを参照してください。

ファイルディスクリプタを開く数は 1024 までにすることをお勧めします。この値は、コマンド ulimit -a で確認できます。Shell Fork Bomb Protection など、ハードウェアの制限でこの推奨値を下回る場合、たとえば supervisord.conf に次の内容を追加することが一解決方法として考えられます。

[supervisord]
minfds = 100 # ハードウェア制限

注:

• ソースインストールは、このリストにないオペレーティングシステムでも実行でき、ベストエフォートベースでサポートされている可能性があります。
• Datadog Agent v6+ は、最新の Windows Update がインストールされた Windows Server 2008 R2 をサポートします。Windows Server 2008 R2 に影響するクロックドリフトと Go の既知の問題もあります。

注:

• ソースインストールは、このリストにないオペレーティングシステムでも実行でき、ベストエフォートベースでサポートされている可能性があります。

• Agent テストのバージョン: 6.15.0
• CPU: 平均で CPU の約 1.5% を使用
• メモリ: 約 95 MB の RAM 使用。
• ネットワーク帯域幅: 約 14KB/秒 ▲

• Agent テストのバージョン: 6.15.0
• CPU: 平均で CPU の約 1% を使用
• メモリ: 約 95 MB の RAM 使用。
• ネットワーク帯域幅: 約 20KB/秒 ▲

• Agent テストのバージョン: 6.15.0
• CPU: 平均で CPU の約 0.7 % を使用
• メモリ: 約 90 MB の RAM を使用 (RSS メモリ)
• ネットワーク帯域幅: 約 200KB/秒 ▲