Manage dashboard widgets

After you create a custom dashboard, you might want to modify the dashboard. For example, you might want to convert a line chart, which displays every time series, to a stacked-area chart so that you can view the proportion each time series contributes to the sum.

This document describes how to change a widget's type, how to modify which time series a widget displays, and how to delete a widget by using the Google Cloud Console:

Before you begin

Before you create or modify a dashboard, ensure that you have one of the following Identity and Access Management roles:

  • roles/monitoring.dashboardEditor
  • roles/monitoring.editor
  • roles/monitoring.admin
  • roles/owner

For more information about roles, see Access control.

Change a widget's type

When a widget is displaying the correct data but not presenting it in the most useful way, consider changing the widget's type. For example, suppose you have a line chart on your dashboard. To view how each time series contributes to the sum, change that line chart to a stacked-area chart.

You can change a widget's type only if the destination widget can represent the data shown by the source widget. For example, you can always change a line chart into a stacked-area or stacked-bar chart. Similarly, you can always convert a gauge, which shows a single time series, into a line chart. However, you might not be able to convert a line chart, which can show multiple time series, into a gauge.

You can't change the type of an alert chart or a logs panel. You also can't convert a widget to those types.

To change a widget's type, do the following:

  1. In the Cloud Console, select Monitoring or click the following button:
    Go to Monitoring
  2. In the navigation pane, select Dashboards, then select the dashboard that you want to view or edit.
  3. If Editing isn't shown, then click Viewing and select Switch to Editing mode.
  4. Select the widget whose type you want to change, and then do one of the following:

    • To convert a line chart to an alert chart, click More options and select Convert to alert chart.

      When you make this selection, the Create alert policy dialog opens and the metric, filter, and grouping selections from your chart are applied to the alerting condition. Complete the specification of the alerting policy and then click Create. For information about those steps, see Create an alerting policy.

    • To perform any other conversion, in the configuration pane, click the name of the current widget type, and then make a selection from the menu. For example, to change a line chart to a stacked-area chart, click Line chart and then select Stacked area chart.

      The menu lists all widget types that can display metric data; however, a widget type is disabled when it can't display the selected data. For example, when the charted metric isn't distribution valued, the heatmap option is disabled. Similarly, when the current widget displays multiple time series, the gauge and scorecard options are disabled.

Modify a widget's configuration

To change which time series a widget displays or to change how those time series are combined, modify the widget's configuration. For example, when a chart displays many time series, you can improve the chart's performance and visual clarity by grouping time series by one or more labels.

To modify a widget's configuration, do the following:

  1. In the Cloud Console, select Monitoring or click the following button:
    Go to Monitoring
  2. In the navigation pane, select Dashboards, then select the dashboard that you want to view or edit.
  3. If Editing isn't shown, then click Viewing and select Switch to Editing mode.
  4. Select the widget to activate the widget's configuration pane.
  5. Modify the widget by doing one of the following:

    • To use the menu-driven interface, select the Basic tab or Advanced tab. When you select the Basic tab, most fields are automatically set with values that are appropriate for the selected metric.
    • To use Monitoring Query Language (MQL), select the MQL tab.
    • To edit the JSON representation, click JSON editor, and then click Apply changes after your changes are complete.

      The JSON editor only expands the section of the file that applies to the currently selected widget. To view the entire dashboard definition, click Show more:

      Illustrate the expand button on the JSON editor.

For detailed information about how to configure a widget, see Add dashboard widgets.

Delete a widget

To improve the responsiveness of your dashboards, delete widgets whose data doesn't provide value to you.

To delete a widget, do the following:

  1. In the Cloud Console, select Monitoring or click the following button:
    Go to Monitoring
  2. In the navigation pane, select Dashboards, then select the dashboard that you want to view or edit.
  3. If Editing isn't shown, then click Viewing and select Switch to Editing mode.
  4. Select the widget that you want to delete.
  5. In the widget toolbar, select Delete.

What's next