For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/datadog_cloudcraft/overlays/apm.md. A documentation index is available at /llms.txt.
The APM overlay is in Preview and is available for AWS accounts only.

Overview

The APM overlay displays distributed APM traces as arcs between cloud resources on your Cloudcraft diagram. This helps you understand service-to-service request flows across your infrastructure without leaving the architecture view.

To open the overlay, click the APM tab in the overlay selector at the top of your diagram.

Supported resource types

The APM overlay shows connections for resources that include a Cloud Resource ID (CCRID) in their trace data. The following resource types are supported:

  • EC2
  • S3
  • Lambda
  • RDS
APM overlay in Cloudcraft showing green trace arcs connecting services across an AWS architecture diagram, with the Traces count and legend visible in the bottom left.

Prerequisites

APM must be active in your Datadog organization, meaning at least one span has been ingested in the last 30 days. If APM is not set up, Cloudcraft displays an onboarding screen with links to set up APM.

Visualize trace connections

When the APM overlay is active, traces appear as curved arcs between resource nodes on your diagram. Each arc represents distributed tracing traffic between two resources.

Legend

Arc colorStatus
GreenOK
RedError

Use the legend panel at the bottom of the screen to filter traces by status. The legend also displays the count of visible traces. Deselecting all statuses resets the view to show all traces.

Investigate traces

Click a trace arc to open a side panel showing the list of APM traces between those two resources. The side panel includes:

  • A search bar to filter traces by query.
  • A time picker (defaults to the last 30 minutes).
  • A live mode toggle for streaming trace data.
  • A column picker to customize which fields are displayed. Default columns include Duration, Service, Resource Name, and Error Type.
  • An open in APM link to view the same query in the Traces Explorer.

Click a trace row in the side panel to open the trace detail view, which displays the standard APM flame graph.

Further reading