Shape the future of software operations and make your voice heard by taking the 2021 State of DevOps survey.

Metrics Explorer

Metrics Explorer is a stand-alone charting tool that lets you build charts for any (numeric) metric collected by your project. With Metrics Explorer, you can do all of the following:

  • You can save charts to a custom dashboard.
  • You can share charts by their URL.
  • You can view the JSON representation for charts.
  • You can explore metric data that you don't need on a dashboard.

The following screenshot shows a metric charted on the Metrics Explorer page:

Metric charted using Metrics Explorer

The Metrics Explorer interface consists of two primary regions:

  • A configuration region with two tabs:
    • Use the Metric tab to select the metric that you want to explore further. This tab opens the metric-selector dialog. For detailed information about how to select the metric of interest, see Selecting metrics.
    • Use the View Options tab to change the display characteristics of the chart. This tab opens the chart-configuration dialog.
  • A chart showing the selected metric.

Using Metrics Explorer

To view the metrics for a monitored resource using Metrics Explorer, do the following:

  1. In the Google Cloud Console, go to Monitoring or use the following button:

    Go to Monitoring

  2. In the Monitoring navigation pane, click Metrics Explorer.

  3. Specify the data to appear on the chart. For detailed information about the fields set in this step, see Selecting metrics.

    1. Ensure the Metric tab is selected:

      Display the metric-selection tab.

    2. Complete the Find resource type and metric box. You can select values from the menus, or you can enter the name.

    3. (Optional) To specify a subset of data to include, add filters to the Filter field.

    4. (Optional) To define define how multiple time series are combined and how each time series is processed, update the aggregation fields:

      • To group time series by a label, use the Group By field. Selecting a value for this field automatically selects a value for the Aggregator field.
      • To specify how multiple time series are combined, set the Aggregator field.
      • To configure the processing algorithm for individual time series, click Advanced Options.
  4. (Optional) The default view option for a chart is a line chart displayed in color mode. However, you can change both of these settings:

    • To change the chart mode, select the View options tab, and then select from the chart-mode menu. For more information on your choices, see View options.

    • To change the display-style for a chart, click Line to expand the pull-down menu. After you make a selection, that selection is listed adjacent to the pull-down menu. For examples of all chart types, see Dashboard widgets.

  5. (Optional) You can display multiple metrics on a single chart. If you want to display another metric, click Add Metric and repeat the previous two steps. A chart can display a maximum of 10 metrics.

Saving a chart for future reference

Metrics Explorer lets you create a chart that you can use to explore a metric. However, the charts created by this tool aren't persistent. If you navigate away from the Metrics Explorer page, the chart you've configured is discarded unless you save the chart to a custom dashboard or capture the chart's URL.

If you want to add the chart you've configured with Metrics Explorer to a custom dashboard, then do one of the following:

  • If you use the Google Cloud Console to manage your custom dashboards, then click Save Chart and complete the dialog. You can save the chart to an existing custom dashboard or you can create a dashboard.

  • If you use the Cloud Monitoring API to manage your custom dashboards, then you specify a JSON file that defines the dashboard layout and the structure of each widget that appears on the dashboard. To view the JSON representation of the chart being displayed in Metrics Explorer, click More options, and then select View as JSON. To save this representation in your clipboard, click Copy JSON.

    For detailed information about using the API to manage your custom dashboards, see Managing dashboards by API.

If you don't want to save the chart to a custom dashboard but you do want to keep a reference to the chart, then save the chart URL. Because the chart URL encodes the chart configuration, when you paste this URL into a browser the chart you configured is displayed.

To obtain the chart's URL, click More options, and then select Share by URL.

What's next