What can I do on the Search and Trace pages?
- Log in to your account and go to Distributed Tracing
- Select a data source for the Distributed Tracing interface
- Search for traces.
- View trace search results on the Search page.
- View a trace on the Trace page.
- Find a specific trace.
- Compare traces
- View Topology diagrams for your system
Log in to your account and go to Distributed Tracing
Your Distributed Tracing account complements your logging ELK stack. To reach it, log into your Logz.io Operations workspace and select the Jaeger or Tracing tab.
By default, your Distributed Tracing account is accessed from your main account.
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.
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:
| Field | Description |
|---|---|
| Service | Select a service in your system |
| Operation | Select an available operation from the list |
| Tags | Each 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 |
| Lookback | Select the time frame for the query |
| Min and Max Duration | Set 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 Results | Set the maximum number of results for the query Up to 500 traces can be returned |
Tag formatting requirements
- Use a space for conjunctions
- Enclose values that contain whitespace in quotes
- Tag formatting requirements are summarized here: logfmt
- A list of recommended tags can be found here: https://github.com/opentracing/specification/blob/master/semantic_conventions.md
Tag examples
error=truereturns the traces with spans that are tagged as an errorerror=true db.statement="select * from User"returns the traces with spans that are tagged aserror=true, which also include the requested db statement.http.status_code=500returns the traces with a communication error
View trace search results on the Search page.
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.
This view helps you find patterns and identify when the returned results happened.
Hover over a trace to see the service and operation associated with the trace.
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.
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:
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.
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.