Skip to main content

The Grand Distributed Tracing Tour

Your Distributed Tracing account complements your logging stack. To reach it, log into your account and select the Jaeger or Tracing tab.

By default, your Distributed Tracing account is accessed from your main account.

tracing tour

Select a data source for the Distributed Tracing interface

To display tracing data from a single data source in the Distributed Tracing tab, use the Source selector. Pick a data source

You cannot select multiple data sources for an aggregated view.

Search for traces.

You search for and view traces on the Search page. Use the following fields to search for traces: Search traces page

ServiceSelect a service in your system
OperationSelect an available operation from the list
TagsEach span has its own set of tags Use the preconfigured tags that were used to enrich your traces to further refine your trace searches. The added business logic information makes for easier debug processes
LookbackSelect the time frame for the query
Min and Max DurationSet the minimum and maximum durations for the traces you want the query to return Use these parameters to obtain more focused results and reveal performance issues
Limit ResultsSet the maximum number of results for the query Up to 500 traces can be returned

Tag formatting requirements

Tag examples

  • error=true returns the traces with spans that are tagged as an error
  • error=true db.statement="select * from User" returns the traces with spans that are tagged as error=true, which also include the requested db statement.
  • http.status_code=500 returns the traces with a communication error

View trace search results on the Search page.

Search results

Results timeline

The trace results timeline visualizes traces over the lookback period you selected for the search.

Each circle represents a trace: The larger the circle, the more spans that trace includes. Click a circle to view the trace. A trace that includes fewer spans may indicate a short end-to-end transaction or may be missing information because the instrumentation was incomplete or missing. results timeline1

This view helps you find patterns and identify when the returned results happened. results timeline1 Hover over a trace to see the service and operation associated with the trace. results timeline1

Trace list

In the trace list, each row represents a single trace and includes the service and operation names, the trace ID, the duration of the trace, and a timestamp of when it occurred.

The colors represent the different services involved in the trace. Each trace shows the number of spans it includes and how many of them were tagged as errors. The trace page shows you the spans that include the errors.

Sort trace results by the time they occured, by duration, or by the number of spans. sort trace list

View a trace on the Trace page.

Click a trace from the trace results timeline or from the trace results list to view its trace page.

By default, the trace opens in the timeline view. Select an option for different perspectives:

pick a trace view

What can I do in the Trace Timeline?

What can I do in the Trace Graph?

What can I do in the Trace Statistics?

What can I do in the Trace Spans Table?

What can I do in the Trace Flamegraph?

Find a specific trace.

After you log in to your Distributed Tracing account, if you need to view a specific trace, you can use trace ID lookup.

  • To investigate specific incidents identified by a unique trace ID, use the search box to retrieve the trace data. Make sure to tag your logs with the proper context to be able to locate the trace ID. If data sampling is configured to occur on the collector side, some traces may not be available in the Jaeger UI.
    traceID lookup

Compare traces

Select traces for comparison and find out how they differ.

View Topology diagrams for your system

Leverage the power of topology diagrams to obtain better observability for your system services and how they interact with each other.