이 페이지는 아직 한국어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우
언제든지 연락주시기 바랍니다.Overview
Remote Agent management with Fleet Automation simplifies how you deploy and upgrade your Datadog Agents. Instead of relying on external deployment or configuration tools, you can perform these actions directly from the Datadog platform. With Fleet Automation, you can:
- Upgrade your Agent
- Configure your Agent
Getting started
Prerequisites
- Verify that Remote Configuration is enabled for your organization.
- Confirm that your Agent version is 7.73 or later.
- Linux VMs installed using the install script or Ansible Datadog Role
- Windows VMs
Remotely upgrading Agents in containerized environments is not supported.
Permissions
Users must have the Agent Upgrade permission within Fleet Automation for upgrades. They must also have the Agent Configuration Management permission to configure Agents remotely. These permissions are enabled by default on the Datadog Admin role.
Upgrade Agents
Disk space requirement
Datadog suggests at least 2GB for the initial Agent install and an additional 2GB to use Fleet Automation to upgrade the Agent. Specifically, the upgrade requires 1.3GB in the /opt/datadog-packages directory on Linux, or C:\ProgramData\Datadog\Installer\packages on Windows. The extra space ensures that there is enough room to maintain two Agent installs temporarily during the upgrade process in case a rollback is needed.
Upgrade steps
From the Upgrade Agents tab, click Upgrade Now.
Select the Agents you want to upgrade. You can target a group of Agents by filtering on host information or tags.
Review the deployment plan and click Upgrade Agents to start the upgrade.
Use the Deployments dashboard to track the upgrade process. Clicking on an Agent in the deployments table gives you more information about the upgrade, including the duration time, progress, and the user who started the upgrade.
From the Upgrade Agents tab, click + Create Schedule.
On the Upgrade Schedule page, add a Schedule name.
Select the Agent version. You have the option to upgrade the Agents to the latest version, to one version behind, or to two versions behind.
Specify the Agents to be upgraded. You can target a group of Agents by filtering on host information or tags.
Set the deployment window for these upgrades. You can select the days, time frame, and timezone for the upgrade.
Set up notifications to receive updates on the status of the deployment. You can notify your team of the deployment status through the services you’ve already connected with Datadog, like Slack, Teams, or PagerDuty.
Click Create Schedule to save the schedule.
See a list of your scheduled upgrades under the Upgrade Agents tab, in the Upgrade Schedules section.
Fleet Automation provides an API to trigger Agent upgrades programmatically or on a recurring schedule. Start upgrades for any set of hosts using filter queries, or create schedules that run during defined maintenance windows with a specified Agent version. For full details, see the Fleet Automation API.
Upgrade process
Similar to a manual upgrade, expect a downtime of 5-30 seconds while the Agent restarts. The full upgrade process takes approximately 5 minutes. Around 2 minutes of this time is used for the upgrade process. The rest of the time is spent monitoring the upgrade to ensure stability and determining if a rollback is necessary. If the upgrade fails and a rollback is necessary, the Agent automatically reverts to the previously running Agent version.
The upgrade process primarily adds files to the following directories:
Linux:
/opt/datadog-packages/etc/datadog-agent/etc/systemd/system
Windows:
C:\ProgramData\Datadog\Installer\packagesC:\Program Files\Datadog\Datadog Agent
The Agent ensures that the appropriate permissions are set for these files. No configuration files are altered during the installation process.
Upgrade precedence
For the most consistent upgrade experience, Datadog recommends managing upgrades from one source at a time. Use either Fleet Automation or a configuration management tool. If you run a configuration management tool on an Agent that has already been upgraded using Fleet Automation, the upgrade reverts the Agent to the DD_AGENT_MINOR_VERSION specified in your configuration. If no DD_AGENT_MINOR_VERSION is set, the Agent is upgraded to the latest available version.
Fleet Automation allows you to roll out and manage Datadog Agent configuration at scale. Configuration changes can be applied using guided workflows in the UI or by providing custom YAML files. Fleet Automation allows you to standardize Agent configuration across environments. With Fleet Automation, you can:
- Set up Datadog product telemetry such as APM, Logs, and NDM
- Enable or adjust Agent integrations
- Manage Agent tags
- Apply consistent configuration across environments
In Fleet Automation, open the Configure Agents tab and click Create Configuration.
Select and configure the products (for example, APM, Logs, or NDM) that you want the target Agents to run.
Review your final configuration and begin scoping deployment to your Agents. Alternatively, you can save the configuration to edit or deploy to your Agents at a later time from the Configure Agents page.
Scope Agents to deploy configuration to (for example, through tags such as host names, site, or environment).
Review the deployment plan to confirm scoped Agents and deployment settings, such as rollout concurrency.
Start deployment and track progress from the Deployments page.
In the Datadog UI, navigate to the Fleet Automation page and select View Agents.
(Optional) You can target a group of Agents by filtering on host information or tags.
Select your host to open a side panel. In the side panel, click on the Configuration tab to access your modifiable configurations.
Click the Edit button to edit your configuration.
Submit these changes by selecting Deploy Changes.
Note: Some configuration fields ( for example, api_key, site, and notable_events) cannot be modified.
In the following example, the logs_enabled field is changed from false to true. After the changes are deployed, log collection on this Agent is enabled.
Fleet Automation provides an API to apply configuration updates to your Agents programmatically. Deploy changes to any group of hosts using filter queries, supplying either full configuration files or targeted patches. Fleet Automation does not support all Agent configuration fields, and settings related to Agent connection or secrets (site, API keys, and other authentication parameters) cannot be managed through the API. Push configuration on demand or integrate it into your existing automation workflows. For full details, see the Fleet Automation API.
Configuration precedence
Configuration changes deployed through Fleet Automation are appended to the Datadog Agent’s local configuration. If a conflict occurs at the configuration-field level, Fleet Automation overrides the local value. In short, the most recent configuration change, whether applied by Fleet Automation, configuration management tools, or directly on the host, becomes the Agent’s active configuration.
You can use Fleet Automation Audit Trail to gain visibility into recent configuration changes to your Agents and to set up alerts on those changes.
Mirrors and proxies
You can use Remote Agent Management along with a proxy or mirrored repositories.
For instructions on configuring your Agent to use a proxy, see Agent Proxy Configuration. After you’ve configured the proxy, restart the Agent to apply the settings.
For instructions on using mirrored or air-gapped repositories, see:
Troubleshooting
Datadog Installer incompatible with Agent (pre-7.66)
If you were a Preview customer and set up remote Agent Management before Agent version 7.66, your Datadog Installer might be incompatible with the Agent.
To support general availability of remote Agent upgrades, the installer component was bundled with the Agent starting in version 7.66. This change ensures that both components stay up to date together, preventing version mismatches and related compatibility issues. Earlier versions of the Agent did not bundle these components, resulting in a possible version mismatch that could prevent automatic updates and remote Agent Management functionality.
To diagnose and fix the issue:
- Use the following query in Fleet Automation to identify affected hosts:
support_remote_upgrade:datadog-installer
- If your setup is impacted, re-run the install script on each affected Agent to manually upgrade them to Agent version 7.66 or higher. This ensures full compatibility with Remote Agent Management features.
Manual Agent upgrades are not required after you’ve updated to 7.66 or higher. Future upgrades are handled automatically without requiring manual intervention.
If you don’t upgrade an earlier Agent version to 7.66 or higher, there is no impact on your existing Agent. However, remote upgrades remain unavailable until you update the Agent.
Further reading
