Configure legends

Configurable legends are available for charts with the following visualization types:

  • Line chart
  • Stacked bar chart
  • Stacked area chart
  • Heatmap chart

The legend looks like a table positioned beneath the graph. It has one column of colored dots, a variable number of data columns, and a Value column. The following screenshot shows a chart with a legend:

Legend showing Columns button

The column of colored dots keys the lines in the graph to the rows in the legend. The Value column displays the values for the metric being charted, and other columns show the values of chosen metric or resource labels. The dashed bar on the chart indicates the time for which values are displayed.

This page describes how to work with these legends. You can:

  • Show or hide the legends.
  • Choose the metric and resource labels to display as columns in the legend.
  • Sort the rows in the legend based on the values in a column.
  • Show both current and past values when using the Compare to past chart-view option. For more information, see the section titled Compare to past.
  • Configure the descriptive strings that appear in the legend. For more information, see Legend template.
  • Access resource-specific dashboards.
  • Apply dashboard-wide filters.

Show and hide legends

You can show or hide the legends of all charts on a dashboard or of each chart individually:

  • To show or hide the legends of every chart in a dashboard, in the dashboard toolbar, click Settings and then select Show all legends or Hide all legends.
  • To show or hide the legend of a particular chart, in the chart toolbar, click Toggle Legend .

    When the chart width isn't sufficient to display the legend toggle in the chart's toolbar, this option is accessible by using chart's Other options menu.

The previous screenshot is an example of a line chart with its legend enabled.

Select legend columns

To change the columns that appear in the legend, click Columns . Clicking the button brings up a configuration panel. This panel lists the metric and resource labels available to display as columns. Required columns have disabled checkboxes. The following screenshot shows the Columns button and the configuration panel for a particular legend:

Legend showing Columns button

When the chart is initially created, the system heuristically chooses a set of labels to show by default. You can select or clear labeled columns. The entries for required columns, most typically Value, are disabled and can't be cleared. When you change the configuration, you must have at least one metric or resource label selected.

The legend displays scrollbars when the legend has too many rows or columns to display. The following screenshot illustrates a legend with scrollbars:

Legend showing scrollbars

Sort legend rows

You can sort the rows of the legend by any of the columns. Rows can be sorted into ascending or descending order. To sort a row, click the header. The most recently sorted column displays an arrow indicating the sort order. The following screenshot shows a legend that has been sorted by zone in descending order:

Legend sorted on "zone"

Legends in Compare to past mode

When you use Compare to Past mode on a chart, the legend is modified to include a second “values” column. The current Value column becomes Today, and the past values column is named appropriately—for example, Last Week. The following screenshot shows a legend for a table comparing current data to that of the last hour:

Legend showing past data

Configure the legend template

The Legend Template field lets you customize a description for the time series on your chart. These descriptions appear on the tooltip for the chart and on the chart legend in the Name column. By default, the descriptions in the legend are created for you from the values of different labels in your time series. Because the system selects the labels, the results might not be helpful to you. To build a template for descriptions, use this field.

To access the legend template for a chart, in the Cloud Console, select the Advanced tab in the chart's configuration pane. The legend template is listed under the heading Additional options.

You can enter plain text and templates in the Legend Template field. When you add a template, you add an expression that is evaluated when the legend is displayed.

To add a template, do the following:

  • Click Insert a template.
  • Select an entry from the menu. After you select an entry, a template is automatically added. For example, if you select response_code, then the template ${} is added.

For example, the following screenshot shows a legend template that contains plain text and the expression ${}:

A template for a simple description.

In the chart legend, the values generated from the template appear in a column with the header Name and in the tooltip:

Descriptions generated from a template.

You can configure the legend template to include multiple text strings and templates; however, the display space available on the tooltip is limited.

Access resource-specific dashboards

When you are viewing a time series, you might want to view more information about the resource against which that time series is written. For some resources, you can go to the management page for that resource by using options in a chart's legend.

To go to the management page for a resource, do the following:

  1. In the Monitoring navigation panel, click Dashboards.
  2. Click the name of the dashboard that you want to view.
  3. If Viewing isn't shown, then click Editing and select Switch to Viewing mode.
  4. Identify the chart and ensure its legend is displayed. If the legend isn't shown, then click Toggle Legend.
  5. Open the management page for the resource:

    1. Scroll through the legend until you find the specific time series of interest.
    2. Click More options.
    3. Select the option that begins with Manage.

The following is a partial list of resources whose management page you can access from the legend options:

  • BigQuery datasets
  • Cloud Storage buckets
  • Compute Engine disks and instances
  • Google Kubernetes Engine clusters, containers, nodes, and pods
  • External HTTP(S) load balancer
  • Pub/Sub subscriptions and topics
  • Cloud Spanner instances

Add dashboard-wide filters

You can apply dashboard-wide filters when, for example, you want to investigate the behavior of one resource in more detail. Dashboard-wide filters configure all widgets on that dashboard to display only those time series that match the filers.

You can add dashboard-wide filters by using the More options of a legend.

For more information, see Dashboard-wide filters.