This page describes how to access monitoring data from your Cloud Storage
buckets, including request rates, bandwidth usage, and storage usage. For
information about monitoring in Cloud Storage and what metrics to use to find
the data you want, see [Overview of monitoring](https://docs.cloud.google.com/storage/docs/monitoring.md.txt) or
[Overview of bandwidth usage monitoring](https://docs.cloud.google.com/storage/docs/bandwidth-usage.md.txt).

## Monitor bucket data for individual buckets

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

   [Go to Buckets](https://console.cloud.google.com/storage/browser)
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](https://console.cloud.google.com/storage/browser)
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 and storage usage

Use the instructions in this section to monitor bandwidth usage for buckets or
storage usage for zonal buckets or Rapid Cache.

For data egress from a Cloud Storage bucket to Google services:

- 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](https://docs.cloud.google.com/storage/docs/locations.md.txt#location-dr), the usage must be by
  resources located in either of the regions that makes up the dual-region.

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

- The usage must be from either a [JSON API `GET Object`](https://docs.cloud.google.com/storage/docs/json_api/v1/objects/get.md.txt) request or a
  [XML API `GET Object`](https://docs.cloud.google.com/storage/docs/xml-api/get-object-download.md.txt) request.

### Before you begin

In order to track bandwidth monitoring, you must have the [Cloud Storage
service `storage.googleapis.com`](https://console.cloud.google.com/apis/library/storage.googleapis.com) enabled for your project.

To monitor bandwidth or storage usage:

### Console

You can view egress bandwidth usage for your project's buckets or storage
usage for zonal buckets only by 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](https://docs.cloud.google.com/storage/docs/bandwidth-usage.md.txt#bandwidth-monitoring).

[Open Cloud Storage Quotas and systems limits](https://console.cloud.google.com/iam-admin/quotas)

- **Google Egress Bandwidth per second per region**

- **Rapid Zonal Egress Bandwidth per second per zone**

- **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**

- **Rapid Cache Egress Bandwidth per second per zone**

- **Rapid Zonal Bytes per zone**

- **Rapid Cache Storage Size per region per bucket per cache**

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](https://console.cloud.google.com/storage/monitoring).

For more information on viewing and managing quotas, see
[View and manage quotas](https://docs.cloud.google.com/docs/quotas/view-manage.md.txt). For information about bandwidth monitoring
metrics and what data they return, see [Bandwidth monitoring metrics](https://docs.cloud.google.com/storage/docs/bandwidth-usage.md.txt#bandwidth-monitoring).

### Command line

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

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

   Where <var translate="no">PROJECT_ID</var> is the project ID.
2. In the YAML response, look for the following:

   - `storage.googleapis.com/google_egress_bandwidth`

   - `storage.googleapis.com/rapid_zonal_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`

   - `storage.googleapis.com/anywhere_cache_egress_bandwidth`

   - `storage.googleapis.com/rapid_zonal_bytes`

   - `storage.googleapis.com/anywhere_cache_storage_size`

   For information about bandwidth monitoring metrics and what data they
   represent, see [Bandwidth monitoring metrics](https://docs.cloud.google.com/storage/docs/bandwidth-usage.md.txt#bandwidth-monitoring).

For more information, see
[Manage your quota using the Google Cloud CLI](https://docs.cloud.google.com/docs/quotas/view-manage.md.txt#managing_your_quota_gcloud).

### JSON API

For information on programmatically retrieving time series information
for non dual-region quotas, see the [ListTimeSeries command](https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list.md.txt), 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/rapid_zonal_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](https://docs.cloud.google.com/monitoring/api/ref_v3/rest/v3/projects.timeSeries/list.md.txt), 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](https://docs.cloud.google.com/storage/docs/bandwidth-usage.md.txt#bandwidth-monitoring).

## What's next

To request an increase of storage quota for zonal buckets or Rapid Cache,
see [Storage usage monitoring](https://docs.cloud.google.com/storage/docs/storage-usage.md.txt).