エージェントの構成

ドキュメント > Agent > Fleet Automation > エージェントの構成

Fleet Automation を使用して、Datadog Agent の構成を大規模に展開、管理します。UI のガイド付きワークフロー、またはカスタム YAML ファイルを使用して、構成変更を適用します。

前提条件

Remote Configuration が組織で有効になっていること
Agent および OTel Collector の構成には Agent バージョン 7.73 以降が必要です (インテグレーションおよびシークレットの構成にはバージョン 7.76 以降が必要です)。Agent をアップグレードするには、Agent のアップグレードを参照してください。
インストールスクリプトまたは Ansible Datadog Role でインストールした Linux VM、または Windows VM

複数の Agent を構成

Fleet Automation で Configuration タブを開き、Configure Agents をクリックします。
対象の Agent に構成のスコープを設定します。ホスト情報またはタグでフィルタリングして、特定のグループを対象にします。
対象の Agent で実行する製品 (Logs、APM、NDM など) を選択します。
展開計画を確認し、対象の Agent と展開の同時実行数などの展開設定を確認します。
Deploy Configuration をクリックして展開を開始し、Deployments page から進捗状況を追跡します。

単一の Agent の構成を編集

Fleet View に移動します。
(オプション) ホスト情報またはタグでフィルタリングして、一覧を絞り込みます。
ホストを選択してサイドパネルを開き、Configuration タブをクリックします。
Edit をクリックして構成を変更します。
Deploy Changes をクリックして更新を適用します。

注: 一部の構成フィールド (例: api_key、site、notable_events) は変更できません。

以下の例では、logs_enabled フィールドが false から true に変更されています。これにより、デプロイ後に Agent でのログ収集が有効になります。

API を使用して Agent を構成

Fleet Automation は、構成の更新をプログラムで適用するための API を提供します。フィルタークエリを使用して任意のホストグループに変更をデプロイし、完全な構成ファイルまたは対象を絞ったパッチを指定します。オンデマンドで構成をプッシュするか、既存の自動化ワークフローに統合します。詳細については、Fleet Automation API を参照してください。

注: API はすべての Agent 構成フィールドをサポートしているわけではありません。Agent の接続やシークレットに関連する設定 (site、api_key、およびその他の認証パラメーター) は、API を通じて管理できません。

構成の優先順位

Fleet Automation を通じてデプロイされた構成変更は、対象に応じて異なるルールに従います。

Agent の構成 (datadog.yaml): Fleet Automation はマージパッチを使用して変更を適用します。指定されたフィールドのみが更新され、指定されていないフィールドは変更されません。フィールドレベルで競合が発生した場合、Fleet Automation の値がローカルの値より優先されます。
インテグレーションおよびカスタムログ設定: Fleet Automation は 2 つのモードをサポートしています。
- 新しい構成ファイルをデプロイします。
- マージパッチを使用して既存のファイルを更新し、特定のフィールドのみを変更します。マージパッチを使用せずに既存のファイル名を対象とする変更をデプロイすると、ファイルは完全に上書きされます。
いずれの場合も、Fleet Automation、構成管理ツール、ホスト上での直接編集など、変更元に関係なく、最新の変更が Agent のアクティブな構成になります。

Fleet Automation Audit Trail を使用して、Agent の最近の構成変更を追跡し、それらの変更に関するアラートを設定します。