Resource Page

Ressource

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:

  • Key health metrics
  • Monitor status for all monitors associated with this service
  • List and metrics for all resources associated with this service

Out-of-the-box graphs

Datadog provides out-of-the-box graphs for any given resource:

  • Requests - Choose to display:

    • The Total amount of requests
    • The amount of Requests per second
  • Latency - Choose to display:

    • The Avg/p75/p90/p95/p99/Max latency of your traced requests
  • Error - Choose to display:

    • The Total amount of errors
    • The amount of Errors per second
    • The % Error Rate
  • 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.

Out of the bow resource graphs

Export to dashboard

On the upper-right corner of each graph, click on the up arrow in order to export your graph into a pre-existing Dashboard.

Latency distribution

The resource page also displays a resource latency distribution graph:

Latency distribution

Use the top right percentile selectors to zoom into a given percentile, or hover over the sidebar to view percentile markers.

latency distribution selector

Dependency Map

You can also view a map of all of a resource’s upstream and downstream service dependencies. With the Dependency Map, you can quickly see the flow of services with spans that go through the specific resource (such as endpoints or database queries) end-to-end.

The dependency map is only available for resources containing service entry spans.

resource dependency map

Hover over a node to view metrics of each service including requests/second, error rate, and average latency.

The highlight color of the node indicates the service’s monitor status. If a service has more than one configured monitor, the status of the most severe monitor is shown.

Click on a node to open a context menu with options to view the Service Page, related traces, and more.

Span summary

For a given resource, Datadog provides you a span analysis breakdown of all matching traces:

Span statistics

The displayed metrics represent, per span:

Avg Spans/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 (in other words, spans without children).

The span summary table is only available for resources containing service entry spans.

Traces

Consult the list of traces associated with this resource in the Trace search modal already filtered on your environment, service, operation, and resource name:

Traces list

Further Reading