From b647e87678f3a80e35cb288df99a24b20a359d04 Mon Sep 17 00:00:00 2001 From: Eva Parish Date: Wed, 8 Jul 2026 12:50:40 -0400 Subject: [PATCH 1/4] [DOCS-14455] Add custom log config to Fleet Automation --- config/_default/menus/main.en.yaml | 9 ++- .../agent/fleet_automation/configure_logs.md | 72 +++++++++++++++++++ 2 files changed, 79 insertions(+), 2 deletions(-) create mode 100644 content/en/agent/fleet_automation/configure_logs.md diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index b3050748f95..215e8ae45b5 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -565,16 +565,21 @@ menu: url: agent/fleet_automation/configure_integrations parent: agent_fleet_automation weight: 803 + - name: Configure Custom Logs + identifier: configure_logs + url: agent/fleet_automation/configure_logs + parent: agent_fleet_automation + weight: 804 - name: Upgrade Agents identifier: upgrade_agents url: agent/fleet_automation/upgrade_agents parent: agent_fleet_automation - weight: 804 + weight: 805 - name: Upgrade SDKs identifier: upgrade_sdks url: agent/fleet_automation/upgrade_sdks parent: agent_fleet_automation - weight: 805 + weight: 806 - name: Troubleshooting url: agent/troubleshooting/ parent: agent diff --git a/content/en/agent/fleet_automation/configure_logs.md b/content/en/agent/fleet_automation/configure_logs.md new file mode 100644 index 00000000000..e9a65714601 --- /dev/null +++ b/content/en/agent/fleet_automation/configure_logs.md @@ -0,0 +1,72 @@ +--- +title: Configure Custom Logs +description: "Remotely configure custom log collection at scale with Fleet Automation." +private: true +further_reading: +- link: "/agent/fleet_automation/" + tag: "Documentation" + text: "Fleet Automation" +- link: "/agent/fleet_automation/configure_integrations/" + tag: "Documentation" + text: "Configure Agent Integrations" +- link: "/agent/fleet_automation/configure_agents/" + tag: "Documentation" + text: "Configure Agents" +- link: "/api/latest/fleet-automation/" + tag: "Documentation" + text: "Fleet Automation API" +site_support_id: fleet-automation-standard-features +--- + +{{< callout url="#" btn_hidden="true" >}} +Configuring custom log collection with Fleet Automation is in Preview. +{{< /callout >}} + +Use [Fleet Automation][2] to manage custom log collection settings on your Agents remotely at scale. + +## Prerequisites + +- [Remote Configuration][1] enabled for your organization +- Agent version 7.76 or later +- Linux VMs (installed with the install script or the Ansible Datadog Role) or Windows VMs + +
+Configuring custom logs on Agents in containerized workloads is not supported. +
+ +## Configure custom logs across multiple Agents + +
As you step through the configuration wizard, the Configuration Summary panel shows your current selected scope of Agents. Use this to check how a change would affect an Agent by previewing configuration diffs on a specific Agent in scope.
+ +1. In Fleet Automation, open the [{{< ui >}}Configuration{{< /ui >}}][2] tab and click {{< ui >}}Configure Agents{{< /ui >}}. +1. Scope the configuration to the target Agents. Filter by host information or tags to target a specific group. +1. Chose {{< ui >}}Custom Logs{{< /ui >}}. +1. Select an operation (see [How configuration changes are applied](#how-configuration-changes-are-applied) for more information about each operation): + + - {{< ui >}}Add New{{< /ui >}}. Specify the filename for the new configuration file, and fill in the configuration as prompted. You can add additional log collection settings by clicking {{< ui >}}+ Add Log Collection{{< /ui >}}. + - {{< ui >}}Edit & Replace{{< /ui >}}. Click {{< ui >}}Select a File{{< /ui >}} and choose the configuration file you want to replace, then update the log collection settings. + - {{< ui >}}Delete{{< /ui >}}. Click {{< ui >}}Select a File to Delete{{< /ui >}}. + +
Toggle between Visual and YAML mode when filling out the log collection configuration. Use YAML mode to paste in YAML directly.
+ +1. Review the deployment plan. Fleet Automation generates a configuration diff for each affected Agent so you can verify the exact changes. +1. Click {{< ui >}}Deploy Configuration{{< /ui >}} to start the deployment. Track progress from the [Deployments page][3]. + +## How configuration changes are applied + +Each operation applies changes to custom log collection on an Agent differently: + +- {{< ui >}}Add New{{< /ui >}}: Deploys a new configuration file. + + +- {{< ui >}}Edit & Replace{{< /ui >}}: Replaces the entire configuration file. Include all desired values in your update. Any values you omit are removed. + +- {{< ui >}}Delete{{< /ui >}}: Removes the configuration file from the target Agents. + +## Further Reading + +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /agent/guide/setup_remote_config +[2]: https://app.datadoghq.com/fleet/agent-management +[3]: https://app.datadoghq.com/fleet/deployments From d2849aadb272d694a20fb2e7a1d8b74193545fd8 Mon Sep 17 00:00:00 2001 From: Eva Parish Date: Wed, 8 Jul 2026 13:16:30 -0400 Subject: [PATCH 2/4] Remove comment --- content/en/agent/fleet_automation/configure_logs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/en/agent/fleet_automation/configure_logs.md b/content/en/agent/fleet_automation/configure_logs.md index e9a65714601..283719dcfb1 100644 --- a/content/en/agent/fleet_automation/configure_logs.md +++ b/content/en/agent/fleet_automation/configure_logs.md @@ -57,7 +57,6 @@ Configuring custom logs on Agents in containerized workloads is not supported. Each operation applies changes to custom log collection on an Agent differently: - {{< ui >}}Add New{{< /ui >}}: Deploys a new configuration file. - - {{< ui >}}Edit & Replace{{< /ui >}}: Replaces the entire configuration file. Include all desired values in your update. Any values you omit are removed. From fa7d1ad14c0cc80b0c492468a2ed496286dc46eb Mon Sep 17 00:00:00 2001 From: Eva Parish Date: Fri, 10 Jul 2026 10:30:55 -0400 Subject: [PATCH 3/4] Remove preview banner --- content/en/agent/fleet_automation/configure_logs.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/content/en/agent/fleet_automation/configure_logs.md b/content/en/agent/fleet_automation/configure_logs.md index 283719dcfb1..d7e98d20457 100644 --- a/content/en/agent/fleet_automation/configure_logs.md +++ b/content/en/agent/fleet_automation/configure_logs.md @@ -18,10 +18,6 @@ further_reading: site_support_id: fleet-automation-standard-features --- -{{< callout url="#" btn_hidden="true" >}} -Configuring custom log collection with Fleet Automation is in Preview. -{{< /callout >}} - Use [Fleet Automation][2] to manage custom log collection settings on your Agents remotely at scale. ## Prerequisites From a028d04835437de0374f486ed43ef41c750f5f8d Mon Sep 17 00:00:00 2001 From: Eva Parish Date: Fri, 10 Jul 2026 11:08:29 -0400 Subject: [PATCH 4/4] Apply suggestions from code review Co-authored-by: Esther Kim --- content/en/agent/fleet_automation/configure_logs.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/agent/fleet_automation/configure_logs.md b/content/en/agent/fleet_automation/configure_logs.md index d7e98d20457..79237fbb4cb 100644 --- a/content/en/agent/fleet_automation/configure_logs.md +++ b/content/en/agent/fleet_automation/configure_logs.md @@ -36,8 +36,8 @@ Configuring custom logs on Agents in containerized workloads is not supported. 1. In Fleet Automation, open the [{{< ui >}}Configuration{{< /ui >}}][2] tab and click {{< ui >}}Configure Agents{{< /ui >}}. 1. Scope the configuration to the target Agents. Filter by host information or tags to target a specific group. -1. Chose {{< ui >}}Custom Logs{{< /ui >}}. -1. Select an operation (see [How configuration changes are applied](#how-configuration-changes-are-applied) for more information about each operation): +1. Choose {{< ui >}}Custom Logs{{< /ui >}}. +1. Select an operation (for more information, see [How configuration changes are applied](#how-configuration-changes-are-applied)): - {{< ui >}}Add New{{< /ui >}}. Specify the filename for the new configuration file, and fill in the configuration as prompted. You can add additional log collection settings by clicking {{< ui >}}+ Add Log Collection{{< /ui >}}. - {{< ui >}}Edit & Replace{{< /ui >}}. Click {{< ui >}}Select a File{{< /ui >}} and choose the configuration file you want to replace, then update the log collection settings.