Once you create a query you can use panels to visualize that data in notebooks, dashboards, and alerts (alerts only support line charts). You can also adjust the Y axis for a chart.

Visualization types

This page lists and describes Cloud Observability’s visualization types.

Alerts list

Available in dashboards for alerts on logs, metrics, and traces.

Displays alerts and their statuses in a sortable table. Use alerts lists to view specific alerts and track system health in dashboards.

Alerts list

Set up and use alerts lists

Follow these steps to create alerts lists:

  1. In a dashboard, click + Add > Alerts list.
  2. Configure the list:
    1. Enter a title.
    2. Filter alerts by label. You can include or exclude labels, and you can combine filters with or and and.
    3. Sort the list by column and in ascending or descending order.
    4. Click Save to return to the dashboard.
  3. On the dashboard, view the relevant alerts and their statuses. To learn more about an alert and its configuration, click an alert.

Expandable end

Alerts lists don’t yet work with these dashboard features: time picker and template variables.

Area chart

Available for metrics and logs in dashboards and notebooks.

Displays a shaded area for the value. Area charts are helpful when you’re charting more than one metric.Area chart

Bar chart

Available for metrics and logs in dashboards and notebooks.

Displays a bar for the value at a given time point. Bar charts are good for displaying discrete values, like the number of requests.Bar chart

Big number

Available for metrics in dashboards and notebooks.

Displays an aggregated value over time as a number. Big number charts are useful when you only need to know the current value of a metric and don’t expect to investigate any changes. When creating a big number chart, note the following:

  • Click under the number to add a subtitle.
  • Because a big number chart displays a single value, you can’t group by an attribute. If you use more than one metric for your chart, you need to combine them using a formula. Big number chart

Dependency map

Available for spans in dashboards and notebooks. Multiple queries aren’t supported.

Displays a map showing services (and optionally operations) dependent on the queried data. You can query on services, operations, and other attributes.Dependency map Learn more about dependency maps.

Heatmap

Available for span latency and distribution-type metrics in dashboards and notebooks. Multiple queries aren’t supported.

Heatmaps allow you to see the distribution of values over time. Unlike a line chart, you can see the number of data points for a particular value, at a particular point in time. Color saturation in the map represents the amount of data points - the darker the color, the more data points for that value, at the point in time.

For example, in the following heatmap, you can see that there are 300 points with a value between 500ms and 600ms around 9:10 am. Heatmap with many data points

But starting at around 9:18 am, the distribution of data points shifts. There are now a number of points in the higher range of latency and fewer data points at the lower range (many of the dark blue cells changed to a lighter blue). The legend on the right shows the range of color values. Heatmap change

Line chart

Available for all data types.

Displays a line that connects the charted values.Line chart

Logs list

Available for logs queries in dashboards and notebooks.

Displays individual logs matching certain conditions. Logs lists show timestamps and body values of up to 1000 logs.

To get more information about a log, click the log to open the Log details panel. The panel shows the log’s fields in tabular and JSON format. You can also use the panel to open linked traces and see logs in context.

Logs list

Ordered list

Available for all data types in notebooks and dashboards. Multiple queries and formulas are not supported.

The ordered list chart displays the results of your query in descending/ascending order of value using a bar graph. The highest value is shaded to 100% and subsequent values are shaded to a relative percent. Use the Sort by dropdown to change the sort order. Click the time series icon to copy a row’s query to a notebook where you can view span samples and start your investigation. Ordered list

Pie/donut chart

Available for all data types in notebooks and dashboards. Multiple queries and formulas are not supported.

The pie chart displays the result of a query in proportional values that fill up a circle. A legend shows the colors assigned to each value in the chart (the legend may only display when you expand the chart if there isn’t enough room).

You can display a pie chart as a donut chart by activating the Donut hole option.

Pie/donut chart

Scatter plot

Available for spans_sample queries in dashboards and notebooks. Scatter plots don’t support multiple queries.

Scatter plots display spans_sample results, visualizing spans and the traces they come from.

In the example below, the query returns spans from traces where at least one span has operation == GET. The scatter plot visualizes the results:

  • Green points are spans without errors.
  • Red triangles are spans with errors.

Scatter plot with spans

Visit Use scatter plots and UQL reference to learn more about spans_sample queries and scatter plots.

Service health panel

The Service health panel is currently in Beta.

Available for span data emitted by services. Queries aren’t supported.

The Service health panel displays performance SLIs emitted from services. Unlike other visualizations, you don’t use a query to create the panel. Any service emitting relevant span data appears in the table.

By default, the panel lists the services alphabetically and shows the p50 latency, error, and rate for each, along with the percentage change in those SLIs over the last hour. You can change the latency percentile, the time period, and the sort order.

The Service health panel always shows data from the past 10 minutes and doesn’t reflect the time window set for the dashboard.

Service health panel

Table

Available for all data types. Multiple queries and formulas are not supported.

The table panel shows your data in a tabular format, similar to the table shown below each chart in notebooks and the expanded chart view in dashboards. Tables are useful when your query includes a group-by. Use the Sort by dropdowns to change the attribute to sort by or to change the sort order. Click the time series icon to copy a row’s query to a notebook where you can view span samples and start your investigation.Table

Traces list

Available for spans_sample queries in dashboards and notebooks. Traces list doesn’t support time aggregation, group-by, or percentiles.

The traces list panel shows you sample spans from traces returned by your query. Use this panel when you want to be able to quickly choose a problematic span and view it in the Trace view.

Use the Sort by field to set a global sort order (users can change this locally using the column headers to sort).

Click a span’s row to view the span in the Trace view.

In the example below, the query returns spans from traces where at least one span has customer == "hipcore", sorted by Span latency.

  • Green circles are spans without errors.
  • Red triangles are spans with errors.

Traces list

Adjust the Y axis scale

By default, the Y axis for charts uses a linear scale. You can instead use logarithmic (log) or symlog scales. You can also set the min and max values for the Y axis.

Expand the advanced options section to change the scale.

  • Linear: Value difference between points on the axis are the same.
  • Log: Allows you to chose an exponential scale for the points on the axis (base 10 by default).
  • Symlog: Allows the chart to display negative values.
    Y axis set to log scale base 10

See also

Query your data

Dashboards

Notebooks

Updated Feb 29, 2024