This product is not supported for your selected
Datadog site. (
).
Fleet Automation for OpenTelemetry Collectors is currently in preview.
Overview
Datadog Fleet Automation allows you to centrally govern and remotely manage Datadog Agents and OpenTelemetry (OTel) Collectors at scale to support your evolving observability needs.
Use cases
With the Fleet Automation platform, you can:
- View the latest Agent and OTel Collector configurations along with historical changes to help confirm deployment updates and ensure configuration consistency.
- Ensure your fleet of Agents and OTel Collectors are using the latest feature enhancements by identifying and upgrading outdated versions.
- Send a flare from within your organization, reducing the time it takes to debug issues on an Agent or DDOT Collector.
- Help rotate API keys and ensure old keys can be disabled with no impact by identifying which Agents, and how many Agents, are using a particular key.
- Remotely Upgrade and Configure Agents: For information on supported Agent versions and configuration steps, see Enable Remote Agent Management.
- View Agent and OTel Collector configurations:
- The Agent and Datadog Distribution of OTel Collector (DDOT) configuration view is enabled by default in Agent versions 7.47.0 or later. To enable Agent configuration manually, set
inventories_configuration_enabled in your Agent configuration file to true. Alternatively, use the DD_INVENTORIES_CONFIGURATION_ENABLED environment variable. - The upstream OTel Collector configuration view is enabled by setting the Datadog Extension in your collector configuration file.
- View Agent integration configuration: Agent integration configuration is enabled by default on Agent versions 7.49 or later. To enable Agent integration configuration manually, set
inventories_checks_configuration_enabled in your Agent configuration file to true. Alternatively, use the environment variable DD_INVENTORIES_CHECKS_CONFIGURATION_ENABLED.
Observe your fleet
Use the Fleet Automation page to gain insight into observability gaps on your hosts, outdated Agents or OTel Collectors, and Agents with integration issues.
For each Agent, you can see:
- The Agent version
- Whether the Agent has any unconfigured or misconfigured integrations
- The services that the Agent is monitoring
- The Agent’s Remote Configuration status
- The products that are enabled on the Agent
- Agent Audit Trail events including configuration changes, upgrades and flares
For each OTel Collector, you can see:
- The Collector version
- The distribution of the Collector
- The configuration YAML of the Collector
Examine an Agent or OpenTelemetry Collector
Selecting an Agent or OTel Collector gives you more information about it, including its configuration, connected integrations, audit events, and a support tab that you can use to send a remote flare.
View Agent Audit Trail events
The Audit Events tab displays Audit Trail events associated with the selected Agent.
Use this tab to:
- Identify configuration changes, API key updates, installs, upgrades and support flares.
- Determine when changes were made and from where
Audit Trail event visibility depends on your plan. When Audit Trail is enabled in your organization, you can view Agent events for up to 90 days based on your Audit Trail retention settings. If Audit Trail is not enabled in your organization, you can view the past 24 hours of events.
Send a remote flare
You can send a flare from the Datadog Agent or DDOT Collector after enabling Remote Configuration on the Agent. For instructions on sending a flare, see Send a flare from the Datadog site.
When contacting Datadog Support with Remote Configuration enabled for an Agent, the Support team may initiate a flare from your environment in order to better assist you in a timely manner. Flares provide troubleshooting information to Datadog Support to help you resolve your issue.
Remote Agent Management
Remote Agent Management simplifies the process of upgrading your Agent fleet by reducing the need to coordinate with multiple deployment or configuration management tools. For more information, see Remote Agent Management.
Control access to Fleet Automation
Fleet Automation is available to all users in a Datadog organization. You can control access to specific functionality:
| Permission | Description |
|---|
API Keys Read | Restricts which users can view and search Agents by API key. |
Agent Flare Collection | Restricts which users can remotely send flares from Fleet Automation. |
Agent Upgrade | Restricts which users have access to upgrade Agents from Fleet Automation. |
Agent Configuration Management | Restricts which users have access to configure Agents from Fleet Automation. |
For information on setting up roles and permissions, see Access Control.
Further Reading
Additional helpful documentation, links, and articles: