Skip to main content

Traces Summary

The Traces tab in the Trace Explorer page displays a searchable list of sampled spans matching your current filters. Each row represents a trace root span with summary information.

Traces Summary

Trace List Columns

Each trace in the list displays:

ColumnDescription
Root SpanThe operation name of the trace's root span
ServiceThe service that generated the root span
TypeHTTP method (GET, POST) or protocol (gRPC)
Start TimeWhen the trace began
DurationTotal trace duration
SummaryVisual bar showing span count and timing breakdown per service

Searching and Filtering

Filter from Selection

After selecting a region on the distribution heatmap:

  1. The trace list automatically filters to matching spans
  2. Duration and time constraints are applied
  3. Use this to focus on slow or anomalous requests

Filter Bar

The filter bar above the list has two modes over the same filters:

  • Builder adds one row per filter. Pick a label name (for example span::http.status_code_int or resource::service.name), pick an operator, then enter or select the values to match.
  • Code writes the same filter as a query, with autocomplete over the labels and values your traces carry: resource::service.name = checkout AND span_status = Error.

Filters are combined with AND, so every one has to match. To match any of several values on one label, use label in (a, b).

Ask AI writes the query for you: describe the filter you want and the assistant fills the bar in.

See Filter Query Language for the full syntax, the operators, and worked examples.

Trace Row Details

Summary Bar

The summary bar on each row visualizes:

Span Distribution

Span Distribution gives a color-coded summary of how many times each span is occurring in the trace.

Span Distribution

This can quickly help you identify N+1 queries/api calls as repeated queries would be surfaced higher in the summary distribution.

N+1 Query Pattern

N+1 Query pattern is a performance problem in which the application makes repeated calls to Database or another service in a loop instead of using batched APIs.

Duration by Service

Duration breakdown by Service gives a color-coded summary of time spent by each service involved in the trace.

Duration by Service

This can quickly help you identify the offending service which is causing higher latency.

Expanding a Trace

Click on any trace row to open the Trace View panel, which shows:

  • Full span waterfall
  • Span attributes and metadata
  • Related logs and metrics
  • Service graph context

Best Practices

  1. Start broad, then narrow: Begin with a time range, then add service or status filters
  2. Use the heatmap selection: Drag on the distribution chart to quickly isolate slow or problematic traces
  3. Check the summary bar: A trace with many spans or long duration may indicate N+1 queries or cascading delays.
  4. Drill down into a trace: To identify what's causing the slowness or error in the execution.

Support

If you need assistance or have any questions, please reach out to us through: