Agent のメイン構成ファイル

Agent チェックとインテグレーションのコンフィギュレーションファイルは conf.d ディレクトリに格納されています。

Agent v6 の構成ファイルは、YAML を使用することで、複雑な構成に対するサポートを強化しています。また、チェックも YAML 構成ファイルを使用するため、一貫性のある構成エクスペリエンスが提供されます。このため、datadog.conf (v5) に代わって datadog.yaml (v6) が使用されます。

conf.d ディレクトリの場所は OS によって異なります。

使用可能なすべての構成オプションの詳細については、サンプル config_template.yaml ファイルを参照してください。

Agent の構成ディレクトリ

Datadog Agent の以前のリリースでは、コンフィギュレーションファイルは /dd-agent/conf.d/ に保存されました。6.0 リリース以降は、コンフィギュレーションファイルは conf.d ディレクトリに保存されます。ディレクトリの場所は OS によって異なります。

チェックのコンフィギュレーションファイル

各 Agent チェックのコンフィギュレーションファイルの例は、対応する <CHECK_NAME>.d/ フォルダーの conf.yaml.example ファイルにあります。関連するチェックを有効にするには、このファイル名を conf.yaml に変更します。注: Agent は、フォルダー /etc/datadog-agent/conf.d/<CHECK_NAME>.d/ に含まれる有効な YAML ファイルを読み込むため、複雑なコンフィギュレーションは複数ファイルに分割することができます。たとえば、http_check のコンフィギュレーションは次のようになります。

/etc/datadog-agent/conf.d/http_check.d/
├── backend.yaml
└── frontend.yaml

特別なケースは、YAML ファイルに .default のサフィックスがある場合です。このようなファイルは、デフォルトで Agent によりロードされ、常に有効であるチェックのコアセットの定義に役立ちます (CPU、メモリ、アップタイムなど)。チェックに他の構成が見つかった場合、それらは無視されるため、安心して無視できます。デフォルトのチェックを無効にするには、該当ファイルを削除します。これらのチェックを構成するには、ベースとして conf.yaml.example を使用します。

オートディスカバリーテンプレートファイルは、auto_conf.yaml ファイルのある構成フォルダーに保存されています。たとえば Redis チェックの場合、redisdb.d/ のコンフィギュレーションは次のとおりです。

/etc/datadog-agent/conf.d/redisdb.d/
├── auto_conf.yaml
└── conf.yaml.example

ログ収集の場合、Datadog に重複ログが送信されないよう Agent は同じログソースを送信先とする複数の YAML ファイルを許可しません。1 つ以上の YAML ファイルが同じログソースを送信先としている場合、Agent はファイルをアルファベット順に処理し、一番上のファイルを使用します。

下位互換性を維持するため、Agent では依然として /etc/dd-agent/conf.d/<CHECK_NAME>.yaml 形式の構成ファイルを処理しますが、新しいレイアウトへの移行を強くおすすめします。

JMX 構成ファイル

JMX Agent チェックには、独自の構成フォルダーに追加の metrics.yaml ファイルがあります。これは、Datadog Agent がデフォルトで収集するすべての Bean のリストです。これにより、Docker ラベルまたは k8s アノテーションによってチェックを構成する際に、すべての Bean を手動でリストする必要がなくなります。