To view trace data in dashboards, your organization must purchase
distributed tracing
and have it enabled in your tenant.
Enable trace querying
Before you can query traces from a dashboard, you must enable the trace query feature, which adds a Query traces button in your dashboard. After enabling the feature, you can click this button to display a dialog for querying traces directly from the dashboard. To enable trace querying from a dashboard:- In the navigation menu select Dashboards. Alternatively, you can search for a dashboard from anywhere in Observability Platform.
- Select the dashboard where you want to enable queries for trace data.
- Click Settings, and then click General to display the dashboard settings.
- In the Dashboard settings page, in the Select a tag field, type and then select tracing-context.
- Click Apply, and then click Save in your dashboard.
Query traces from a dashboard
After enabling trace querying, you can display a query builder and search traces directly from a dashboard where trace querying is active. To search traces from a dashboard:- In the dashboard where you enabled trace querying, click Query traces to open the Traces drawer.
- In the Query builder, enter a service, operation, tag, or combination of those criteria to query trace data. For more information about how to construct a trace query, see Search and filter trace data.
- Select a filter to apply to your query. For example, you can choose to filter the query results to only traces where the selected service or operation contains an error.
-
Click Run to run the defined query.
The Query builder section collapses, and the timeline graph updates based on
the query results.
The time window displays the last 24 hours by default. You can query data up to 30
days in the past.
If you click Run without defining any criteria in the query, results display for all traces in the last 24 hours.
-
Explore the results of your trace query. When selecting one of these options,
Observability Platform applies the context from your query to Trace Explorer:
- View trace details: To open the full trace details for an individual trace in Trace Explorer, click any trace in the table.
- Explore queries: To open the defined query in Trace Explorer, click Open in Trace Explorer.
- Differential diagnosis: To identify trends and scan through all related tags and values in the defined query, click Differential diagnosis. See Differential diagnosis for more information.