Access monitoring data in Cloud Storage

This page describes how to access monitoring data from your Cloud Storage buckets, including request rates and bandwidth usage. For information about monitoring in Cloud Storage, see Overview of monitoring.

Monitor bucket data for individual buckets

1. In the Google Cloud console, go to the Cloud Storage Buckets page.
   

   Go to Buckets

2. In the list of buckets, click the name of the bucket for which you want to see monitoring data.

3. In the Bucket details page, click the Observability tab.

   Monitoring charts are displayed.

Monitor bucket data for all buckets within a project

1. In the Google Cloud console, go to the Cloud Storage Buckets page.
   

   Go to Buckets

2. In the Cloud Storage navigation pane, click Monitoring.

   Monitoring charts are displayed.

The Monitoring page can also be directly accessed using the following URL:

https://console.cloud.google.com/storage/monitoring?project=PROJECT_ID

Where PROJECT_ID is the ID of the project whose metrics you want to monitor.

Monitor bandwidth usage

Before you begin

In order to track bandwidth monitoring:

• You must have the Cloud Storage service storage.googleapis.com enabled for your project.

• The usage must be by Google Cloud resources other than Cloud Storage buckets.

• If the bucket is located in a region, the usage must be by resources located in the same region.

• If the bucket is located in a dual-region, the usage must be by resources located in either of the regions that makes up the dual-region.

• The usage must be from either a JSON API GET Object request or a XML API GET Object request.

To monitor bandwidth usage:

Console

You can view egress bandwidth usage for your project's buckets using the Quotas and system limits page with the appropriate metric. For information about bandwidth monitoring metrics and what data they return, see Bandwidth monitoring metrics.

Open Cloud Storage Quotas and systems limits

• Google Egress Bandwidth per second per region

• Dualregion Google Egress Bandwidth per second per region per dualregion_location

• MultiRegion Google Egress Bandwidth per second per region

• Internet Egress Bandwidth per second per region

• Dualregion Internet Egress Bandwidth per second per region per dualregion_location

• Multiregion Internet Egress Bandwidth per second per region

You can also view the Google egress bandwidth usage of buckets in your project that are located in regions on the Cloud Storage monitoring page.

For more information on viewing and managing quotas, see View and manage quotas.

Command line

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

1. Use the following command to return Cloud Storage quota information for a project:

   gcloud alpha services quota list --service=storage.googleapis.com --consumer=projects/PROJECT_ID

   Where PROJECT_ID is the project ID.

2. In the YAML response, look for the following:

   • storage.googleapis.com/google_egress_bandwidth

   • storage.googleapis.com/dualregion_google_egress_bandwidth

   • storage.googleapis.com/multiregion_google_egress_bandwidth

   • storage.googleapis.com/internet_egress_bandwidth

   • storage.googleapis.com/dualregion_internet_egress_bandwidth

   • storage.googleapis.com/multiregion_internet_egress_bandwidth

   For information about bandwidth monitoring metrics and what data they represent, see Bandwidth monitoring metrics.

For more information, see Manage your quota using the Google Cloud CLI.

JSON API

For information on programmatically retrieving time series information for non dual-region quotas, see the ListTimeSeries command, using the following values for filter:

• metric.type="serviceruntime.googleapis.com/quota/rate/net_usage"

• resource.type="consumer_quota"

• One of the following:

  • metric.label.quota_metric="storage.googleapis.com/google_egress_bandwidth"

  • metric.label.quota_metric="storage.googleapis.com/internet_egress_bandwidth"

  • metric.label.quota_metric="storage.googleapis.com/multiregion_google_egress_bandwidth"

  • metric.label.quota_metric="storage.googleapis.com/multiregion_internet_egress_bandwidth"

For information on programmatically retrieving time series information for dual-region quotas, see the ListTimeSeries command, using the following values for filter:

• resource.type="storage.googleapis.com/Project"

• One of the following:

  • metric.type="storage.googleapis.com/quota/dualregion_google_egress_bandwidth/usage"

  • metric.type="storage.googleapis.com/quota/dualregion_internet_egress_bandwidth/usage"

For information about bandwidth monitoring metrics and what data they represent, see Bandwidth monitoring metrics.