---
isPrivate: true
title: Configure Custom Logs
description: Remotely configure custom log collection at scale with Fleet Automation.
breadcrumbs: Docs > Agent > Fleet Automation > Configure Custom Logs
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Configure Custom Logs

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

Use [Fleet Automation](https://app.datadoghq.com/fleet/agent-management) to manage custom log collection settings on your Agents remotely at scale.

## Prerequisites{% #prerequisites %}

- [Remote Configuration](https://docs.datadoghq.com/agent/guide/setup_remote_config.md) 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

{% alert level="info" %}
Configuring custom logs on Agents in containerized workloads is not supported.
{% /alert %}

## Configure custom logs across multiple Agents{% #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 [Configuration](https://app.datadoghq.com/fleet/agent-management) tab and click Configure Agents.

1. Scope the configuration to the target Agents. Filter by host information or tags to target a specific group.

1. Choose Custom Logs.

1. Select an operation (for more information, see How configuration changes are applied):

   - Add New. Specify the filename for the new configuration file, and fill in the configuration as prompted. You can add additional log collection settings by clicking + Add Log Collection.
   - Edit & Replace. Click Select a File and choose the configuration file you want to replace, then update the log collection settings.
   - Delete. Click Select a File to Delete.
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 Deploy Configuration to start the deployment. Track progress from the [Deployments page](https://app.datadoghq.com/fleet/deployments).

## How configuration changes are applied{% #how-configuration-changes-are-applied %}

Each operation applies changes to custom log collection on an Agent differently:

- Add New: Deploys a new configuration file.

- Edit & Replace: Replaces the entire configuration file. Include all desired values in your update. Any values you omit are removed.

- Delete: Removes the configuration file from the target Agents.

## Further Reading{% #further-reading %}

- [Fleet Automation](https://docs.datadoghq.com/agent/fleet_automation.md)
- [Configure Agent Integrations](https://docs.datadoghq.com/agent/fleet_automation/configure_integrations.md)
- [Configure Agents](https://docs.datadoghq.com/agent/fleet_automation/configure_agents.md)
- [Fleet Automation API](https://docs.datadoghq.com/api/latest/fleet-automation.md)