Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Concepts

Distributed traces provide a way to monitor applications by tracking requests across services. Traces record the details of a request to help understand why an issue is or was happening.

Tracing is best used for analyzing the performance of your system, identifying bottlenecks, monitoring latency, and providing a complete picture of how requests are processed.

To use the Explore Traces app, you should understand these concepts:

Note

Explore Traces is currently in public preview. Grafana Labs offers limited support, and breaking changes might occur prior to the feature being made generally available.

Rate, error, and duration metrics

The Explore Traces app lets you explore rate, error, and duration (RED) metrics generated from your traces by Tempo.

Useful for investigatingMetricMeaning
Unusual spikes in activityRateNumber of requests per second
Overall issues in your tracing ecosystemErrorNumber of those requests that are failing
Response times and latency issuesDurationAmount of time those requests take, represented as a histogram

For more information about the RED method, refer to The RED Method: how to instrument your services.

Traces and spans

A trace represents the journey of a request or an action as it moves through all the nodes of a distributed system, especially containerized applications or microservices architectures. This makes them the ideal observability signal for discovering bottlenecks and interconnection issues.

Traces are composed of one or more spans. A span is a unit of work within a trace that has a start time relative to the beginning of the trace, a duration, and an operation name for the unit of work. It usually has a reference to a parent span in a trace, unless it’s the first span, also known as the root span. It frequently includes key/value attributes that are relevant to the span itself, for example, the HTTP method used in the request, as well as other metadata such as the service name, sub-span events, or links to other spans.

For more information, refer to Use traces to find solutions in the Tempo documentation.

Trace structure

Traces are telemetry data structured as trees. Traces are made of spans (for example, a span tree); there is a root span that can have zero to multiple branches that are called child spans. Each child span can also be a parent span of one or multiple additional child spans.

Trace_and_spans_in_tree_structure

In the specific context of TraceQL, a span has the following associated fields:

  • name: the span name
  • duration: difference between the end time and start time of the span
  • status: enum: {ok, error, unset}. For details, refer to OTel span status documentation.
  • kind: enum: {server, client, producer, consumer, internal, unspecified}. For more details, refer to OTel span kind documentation.
  • Attributes: custom span metadata in the form of key-value pair values. For details, refer to Attribute fields.

For more information, refer to Trace structure and TraceQL in the Tempo documentation.