A resource is a particular action for a given service (typically an individual endpoint or query). Read more about resources in Getting Started with APM. For each resource, APM automatically generates a dashboard page covering:
Datadog provides out of the box graphs for any given resource:
Sub-Services: When there are multiple services involved, a fourth graph is available that breaks down your Total time spent/%of time spent/Avg time per request of your service by services or type.
This represents the total/relative/average time spent by traces from the current service to the other services or type.
Note: For services like Postgres or Redis, which are “final” operations that do not call other services, there is no sub-services graph.
On the upper-right corner of each graph, click on the up arrow in order to export your graph into a pre-existing Timeboard.
In addition to all those graph there is a resource latency distribution graph:
Use the top right selector of this graph to zoom on a given percentile of latency distribution:
Zoom on this graph to filter corresponding traces.
For a given resource, Datadog provides you a span analysis breakdown of all matching traces:
The displayed metrics represent, per span:
|Average number of occurrences of the span, for traces including the current resource, where the span is present at least once.|
|Percentage of traces including the current resource where the span is present at least once.|
|Average duration of the span, for traces including the current resource, where the span is present at least once.|
|Average ratio of execution time for which the span was active, for traces including the current resource, where the span is present at least once.|
Note: A span is considered active when it’s not waiting for a child span to complete. The active spans at a given time, for a given trace, are all the leaf spans (i.e.: spans without children).
Additional helpful documentation, links, and articles: