Span Visualizations

Overview

Visualizations define how the queried span data is displayed. Select relevant visualizations to surface valuable information, such as a list for individual events, or as timeseries or top lists for aggregates.

List view

The list view displays a list of spans that match the selected context, defined by the search bar query filter and a time range.

In the table, choose which information of interest to display as columns. Manage the columns by either:

  • interacting with the table header row to sort, rearrange, or remove columns.
  • selecting a facet from the facet panel on the left, or from the trace side panel after clicking on a specific span, to add a column for a field. You can also add columns from with the Options button.

The default sort for spans in the list visualization is by timestamp, with the most recent spans on top. To surface spans with lowest or highest value for a measure first, or to sort your spans lexicographically for the value of a tag, specify that column as the by column.

The configuration of the columns is stored alongside other elements of your troubleshooting context in saved views.

Timeseries

Use timeseries to visualize the evolution of a measure (or a count of unique tag values) over a selected time frame, and optionally split the data by up to three tags (grouping).

Note: The Live Explorer (15 minutes) allows grouping by only one dimension.

Aggregated views use additional query options, to define the measured tag dimension, the dimensions to group the query by, and the aggregation period. For example:

  1. Choose to view the Duration measure.

    Measured Dimension
  2. Select the aggregation function for the Duration measure. Selecting a measure lets you choose the aggregation function whereas selecting a qualitative attribute displays the unique count.

    Aggregation Function
  3. Group the query by a dimension, for example, Resource.

    Split Dimension
  4. Choose to display a number of either top or bottom values according to the selected tag.

    Top Bottom X values
  5. Choose the rollup period, for example, 10min.

    Rollup Period

The following Trace Explorer timeseries view shows the evolution of the top ten resource names of the service shopist-web-ui according to the 95th percentile of Duration over the past four hours:

Timeseries view

Choose additional display options for timeseries: the roll-up interval, whether you display results as bars (recommended for counts and unique counts), lines (recommended for statistical aggregations) or areas, and the colorset.

Top list

Use a top list to visualize a span count, a count of unique tag values, or a measure split by one tag dimension.

For example, the following top list shows the top ten website customers that experienced an error at checkout over the past day, based on the span count.

Top list view

Table

Use a table to visualize the top values from up to three dimension combinations according to a chosen measure or span count.

Note: A table visualization grouped by a single dimension is the same as a Top List, just with a different display.

The following table shows the error spans count by Env, Service, and Error type.

Table view

Further Reading

Additional helpful documentation, links, and articles: