You can view the usage metrics of your Hyperdisk Storage Pool on theStorage pools page ofthe Google Cloud console, or inCloud Monitoring,Google Cloud's monitoring solution.

You can programmatically retrieve and calculate storage pool metricsusing:

• REST
• Client libraries
• Promethus Query Language (PromQL)

This document discusses the metrics Compute Engine automatically collectsfor each storage pool and how to view them in Cloud Monitoring.

Before you begin

• If you haven't already, set upauthentication. Authentication verifies your identity for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine by selecting one of the following options:

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI. After installation,initialize the Google Cloud CLI by running the following command:

     gcloudinit

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update.
  2. Set a default region and zone.

  REST

  To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

  Install the Google Cloud CLI. After installation,initialize the Google Cloud CLI by running the following command:

  gcloudinit

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Note: If you installed the gcloud CLI previously, make sure you have the latest version by runninggcloud components update.

  For more information, seeAuthenticate for using REST in the Google Cloud authentication documentation.

Required roles and permissions

To get the permissions that you need to view metrics for a storage pool, ask your administrator to grant you the following IAM roles on the project:

• Monitoring Viewer (roles/monitoring.viewer)
• To modify a metric's scope, you need the following role for the scoping project and each resource container that you want to add:Monitoring Admin (roles/monitoring.admin)

For more information about granting roles, seeManage access to projects, folders, and organizations.

You might also be able to get the required permissions throughcustom roles or otherpredefined roles.

Overview of Hyperdisk Storage Pool metrics

The Hyperdisk Storage Pool performance metrics can help you answer questions about yourstorage pool usage, such as the following:

Available storage pool metrics

The following table lists the metrics available for Hyperdisk Storage Pools. For a fulllist of storage pool metrics, seeCompute Engine metrics.

Each metric type in this table must be prefixed withcompute.googleapis.com/,which has been omitted from the table for readability.

Review storage pool metrics

You can view the metrics for a storage pool on theStorage pools pagein the console, and on theMonitoring tab of theManage storage pool page for a specific storage pool.

Go to the Storage pools page

On theStorage pools page, you can view the following for eachstorage pool:

• Provisioned capacity and the remaining capacity
• Provisioned IOPS and the remaining IOPS
• The number of disks in the storage pool

If you click the name of a storage pool, theManage storage pool pageopens. There are two tabs on this page. On theDetails tab you can view thefollowing information:

• At the top of the page are tiles that show the provisioned and used capacity,throughput, and IOPS.
• In theStorage pool settings section, there is a table that shows theutilization percentages for capacity, IOPS, and throughput.

Visualize storage pool metrics on a chart

You can visualize the storage pool metrics by plotting any ofthe metrics listed previously with Metrics Explorer.Metrics Explorer is part of Cloud Monitoring.

Example: Visualize storage pool capacity utilization

To visualize the storage pool used capacity on a chart, follow theseinstructions. You can follow the same procedure for the otherstorage pool metrics.

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

   Go toMetrics explorer

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

2. In the toolbar of the Google Cloud console, select your Google Cloud project. ForApp Hub configurations, select the App Hub host project or the app-enabled folder's management project.
3. In theMetric element, expand theSelect a metric menu, enterStorage Pool in the filter bar, and then use the submenus to select a specific resource type and metric:
   1. In theActive resources menu, selectStorage Pool.
   2. In theActive metric categories menu, selectStorage_pool.
   3. In theActive metrics menu, selectUsed Capacity.
   4. ClickApply.
   The fully qualified name for this metric iscompute.googleapis.com/storage_pool/used_capacity.

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

5. Configure how the data is viewed. To display only the metrics for a specific storagepool, follow these steps:
   • In theFilter element, clickAdd filter, and then selectstorage_pool_id. For the value, enter a specific storage pool ID.
   • In theAggregation entry, set the first menu toUnaggregated and the second menu tostorage_pool_id.

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

Configure alerts based on storage pool metrics

You can optionally set alerts to trigger when the storage pool hitscertain thresholds, when auto-grow activates, or when other events occur. Foran example of how to configure an alerts based on metrics, seeConfigure alerts for snapshot schedules.

What's next

• Monitor your disk's performance byreviewing disk performance metricsandmonitoring disk health.
• Enable theMonitoring API.
• View all theavailable metrics for Compute Engine.
• Learn more aboutcreating charts with Metric Explorer.
• Learn more aboutCloud Monitoring.
• Learn more aboutstorage pools.