For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/agent/fleet_automation/fleet_view.md. A documentation index is available at /llms.txt.

Fleet View

Fleet View is in Preview on Datadog Government sites (US1-FED and US2-FED).

Additional Fleet Automation functionality such as Configuring Agents, Upgrading Agents and Upgrading SDKs are not supported for your selected Datadog site ().

Use Fleet View to gain insight into observability gaps on your hosts, outdated Agents or OTel Collectors, and Agents with integration issues.

For each Datadog 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
  • Pipeline and topology views of the Collector

Prerequisites

  • Configuration view is enabled by default for Agents and OTel Collectors with version 7.47.0 and later. To enable it manually for older versions, set inventories_configuration_enabled to true in your Agent configuration file, or use the DD_INVENTORIES_CONFIGURATION_ENABLED environment variable.
  • Agent integration configuration is enabled by default in Agent version 7.49.0 or later. To enable it manually on older versions, set inventories_checks_configuration_enabled to true in your Agent configuration file, or use the DD_INVENTORIES_CHECKS_CONFIGURATION_ENABLED environment variable.
Fleet Automation requires the Datadog Extension to display OpenTelemetry Collector configuration, pipelines, and topology. Configure the extension before using the OTel Collector features described on this page.

Examine a Datadog Agent or OpenTelemetry Collector

Select a Datadog Agent or OTel Collector to view its configuration, connected integrations, audit events, and a support tab for sending a remote flare.

The Agent detail panel showing configuration, connected integrations, and audit events.

Visualize OTel pipelines

The Configuration tab for an OTel Collector includes Pipeline and Topology views. These views provide end-to-end visibility into how telemetry flows through your OTel pipelines.

To access these views:

  1. Navigate to Fleet Automation.
  2. Filter for OTel Collectors.
  3. Select a Collector to open the detail panel.
  4. Click the Configuration tab.
  5. Select Pipeline or Topology from the View as options.

Pipeline view

The Pipeline view displays the telemetry pipeline for a single OTel Collector. Use the pipeline view to:

  • Validate telemetry routing between configured receivers, processors, and exporters.
  • Identify data flow issues, such as data drops and bottlenecks, by enabling the Show traffic toggle.
  • Investigate pipeline alerts by examining active monitor alerts surfaced on component nodes.
Pipeline view showing telemetry routing between OTel Collector components.

Topology view

The Topology view displays the forwarding chain across OTel Collectors deployed as DaemonSets and gateways. Use the topology view to:

  • Validate telemetry routing across Collectors in a DaemonSet-to-gateway architecture.
  • Spot data drops and bottlenecks by enabling the Show traffic toggle to overlay data flow rates on each edge.
  • Investigate pipeline issues by examining active monitor alerts surfaced on Collector nodes.
Topology view showing DaemonSet Collectors forwarding through gateway Collectors to Datadog.

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 and where changes were made

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, see Send a flare from the Datadog site.

When you contact Datadog Support with Remote Configuration enabled, the Support team may initiate a flare from your environment to help resolve your issue faster.

The support tab for an Agent with the Send Flare button.

Further Reading

Additional helpful documentation, links, and articles: