Chart uptime-check metrics

To understand the responsiveness of the service being monitored, chart the latency metric of an uptime check. Similarly, to understand which regions are responding successfully to an uptime check, chart the status metric of an uptime check.

This document describes how to chart metrics generated by uptime checks by using Metrics Explorer . For information about how to save these charts to a custom dashboard, see Save a chart for future reference .

Before you begin

You must have an uptime check to use these instructions. If you haven't created an uptime check, then see Create public uptime checks or Create private uptime checks .

Chart uptime-check status

You can use the Cloud Monitoring uptime_check/check_passed metric as the basis for a chart that displays the status of an uptime check. The following example charts, by location, the number of passed checks in a one-minute window:

1. In the Google Cloud console, go to the leaderboard Metrics explorer page:

   Go to Metrics explorer

   If you use the search bar to find this page, then select the result whose subheading is Monitoring .

2. In the toolbar of the Google Cloud console, select your Google Cloud project. For App Hub configurations, select the App Hub host project or the app-enabled folder's management project.
3. In the Metric element, expand the Select a metric menu, enter Check passed in the filter bar, and then use the submenus to select a specific resource type and metric:
   1. In the Active resources menu, select the resource monitored by the uptime check.
   2. In the Active metric categories menu, select Uptime_check .
   3. In the Active metrics menu, select Check passed .
   4. Click Apply .
   The fully qualified name for this metric is monitoring.googleapis.com/uptime_check/check_passed .

4. To add filters, which remove time series from the query results, use the Filter element .

5. Configure how the data is viewed.
   1. In the Filter element, expand the menu and select check_id , and then select a specific checker.
   2. In the Aggregation element, expand the first menu and select Configure aligner . The Alignment function and Grouping elements are added.
   3. In the Alignment function element, expand the menu and select Next older .
   4. In the Grouping element, expand the first menu and select Count true .

   For more information about configuring a chart, see Select metrics when using Metrics Explorer.

Because the uptime check is configured to execute every minute, it is expected that every location responds approximately 10 times in a 10-minute alignment period.

Chart uptime-check latency

You can use the Monitoring uptime_check/request_latency metric as a basis for uptime-check latency charts. Your choices for the grouping fields let you create different charts. You can, for example, set these fields to display the maximum latency or to display the total latency:

1. In the Google Cloud console, go to the leaderboard Metrics explorer page:

   Go to Metrics explorer

   If you use the search bar to find this page, then select the result whose subheading is Monitoring .

2. In the toolbar of the Google Cloud console, select your Google Cloud project. For App Hub configurations, select the App Hub host project or the app-enabled folder's management project.
3. In the Metric element, expand the Select a metric menu, enter Request latency in the filter bar, and then use the submenus to select a specific resource type and metric:
   1. In the Active resources menu, select the resource monitored by the uptime check.
   2. In the Active metric categories menu, select Uptime_check .
   3. In the Active metrics menu, select Request latency .
   4. Click Apply .
   The fully qualified name for this metric is monitoring.googleapis.com/uptime_check/request_latency .

4. To add filters, which remove time series from the query results, use the Filter element .

5. Configure how the data is viewed.
   1. In the Filter element, expand the menu and select check_id , and then select a specific checker.
   2. In the Aggregation element, expand the first menu and select Mean , and then expand the second menu and select checker_location .

   For more information about configuring a chart, see Select metrics when using Metrics Explorer.

What's next

• Create and manage custom dashboards
• Uptime check metrics