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 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:
| Metric | Description |
|---|---|
Avg Span/trace | Average number of occurrences of the span, for traces including the current resource, where the span is present at least once. |
% of traces | Percentage of traces including the current resource where the span is present at least once. |
Avg duration | Average duration of the span, for traces including the current resource, where the span is present at least once. |
Avg % Exec Time | 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).
Consult the list of traces associated with this resource. Filter/sort this list to see fast/slow and error/non-error traces:
Refer to the dedicated trace documentation to learn more.
