--- title: Google Cloud Storage monitoring integration source: https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/gcp-integrations-list/google-cloud-storage-monitoring-integration --- [New Relic integrations](https://docs.newrelic.com/docs/infrastructure/introduction-infra-monitoring) with the [Google Cloud Platform (GCP)](https://cloud.google.com/) include one that reports [Google Cloud Storage](https://cloud.google.com/storage) data to New Relic. This document explains how to activate the GCP Cloud Storage integration and describes the data it reports. ## Features Google Cloud Storage is GCP's object storage service for serving website content, archival and disaster recovery, and distributing data objects via direct download. New Relic Cloud Storage integration collects API request, network, object count, and stored-bytes metrics for each bucket. ## Activate integration [#activate] To enable the integration, follow standard procedures to [connect your GCP service to New Relic](https://docs.newrelic.com/docs/connect-google-cloud-platform-services-infrastructure): - [Connect with Workload Identity Federation (recommended)](https://docs.newrelic.com/docs/connect-google-cloud-platform-services-infrastructure) - [Connect with service account or user account](https://docs.newrelic.com/docs/connect-google-cloud-platform-services-infrastructure) ## Polling frequency [#polling] New Relic integrations query your GCP services according to a polling interval that varies by integration. The polling frequency for Google Cloud Storage is 5 minutes. The resolution is 1 data point every minute. ## Workload Identity Federation [#wif] ### Find and use data [#find-data-wif] After you enable the integration, your Cloud Storage buckets appear as entities in the New Relic entity explorer. To see dashboards and manage services, go to [one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > GCP. All Cloud Storage metrics available in GCP Cloud Monitoring are collected as dimensional metrics in the `Metric` event type. Additional metrics beyond this table are collected automatically. See [Google's Cloud Storage metrics documentation](https://cloud.google.com/monitoring/api/metrics_gcp_p_z#gcp-storage) for the complete list. #### Entities **Cloud Storage entities** | Entity | Entity type | Resource type | | ------ | ------------------ | ------------- | | Bucket | `GCPSTORAGEBUCKET` | `gcs_bucket` | ### Metric data [#metrics-wif] #### Key metrics — Bucket | Metric name | Unit | Description | | -------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------- | | `gcp.storage.api.request_count` | Count | Number of Cloud Storage API requests served by the bucket, faceted by `method` and `response_code`. | | `gcp.storage.network.received_bytes_count` | Bytes | Network bytes received by the bucket, faceted by `method`. | | `gcp.storage.network.sent_bytes_count` | Bytes | Network bytes sent from the bucket, faceted by `method`. | | `gcp.storage.storage.object_count` | Count | Total number of objects stored in the bucket, faceted by `storage_class`. | | `gcp.storage.storage.total_bytes` | Bytes | Total bytes stored in the bucket, faceted by `storage_class`. | | `gcp.storage.storage.total_byte_seconds` | Byte-seconds | Time-weighted bytes stored in the bucket, used for billing calculations, faceted by `storage_class`. | | `gcp.storage.authn.authentication_count` | Count | Number of authenticated requests against the bucket, faceted by `authentication_method` and `result`. | | `gcp.storage.authz.acl_operations_count` | Count | Number of ACL-based authorization operations against the bucket, faceted by `acl_operation`. | | `gcp.storage.autoclass.transition_operation_count` | Count | Number of Autoclass transition operations applied to objects in the bucket, faceted by source and target storage class. | For the complete list of Cloud Storage metrics, see [Google's Cloud Storage metrics documentation](https://cloud.google.com/monitoring/api/metrics_gcp_p_z#gcp-storage). ### Metrics-only resource types [#metrics-only] New Relic also collects metrics for the following Cloud Storage resource types. These resource types don't create entities in the entity explorer, so query their metrics directly on the `Metric` event type. **Project — 9 metrics** | Metric name | Unit | Description | | -------------------------------------------------------------------- | ----- | ------------------------------------------------------------------------------------------------- | | `gcp.storage.quota.dualregion_anywhere_cache_egress_bandwidth.limit` | Bits | Current limit for this quota. | | `gcp.storage.quota.dualregion_anywhere_cache_egress_bandwidth.usage` | Bits | Current usage for this quota. | | `gcp.storage.quota.dualregion_google_egress_bandwidth.limit` | Bits | Current limit for this quota. | | `gcp.storage.quota.dualregion_google_egress_bandwidth.usage` | Bits | Current usage for this quota. | | `gcp.storage.quota.dualregion_internet_egress_bandwidth.limit` | Bits | Current limit for this quota. | | `gcp.storage.quota.dualregion_internet_egress_bandwidth.usage` | Bits | Current usage for this quota. | | `gcp.storage.quota.total_core_bytes.exceeded` | Count | Number of attempts to exceed the limit on quota metric `storage.googleapis.com/total_core_bytes`. | | `gcp.storage.quota.total_core_bytes.limit` | GiB | Current limit for this quota. | | `gcp.storage.quota.total_core_bytes.usage` | GiB | Current usage for this quota. | **Storage — 7 metrics** | Metric name | Unit | Description | | ------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------ | | `gcp.storage.anywhere_cache_metering.cache_storage_bytes_count` | Bytes | Number of bytes in cache, broken down by zone. | | `gcp.storage.anywhere_cache_metering.cache_storage_kbsec_count` | KiB-seconds | The delta of Anywhere Cache Storage in Kibibyte-secs broken down by Anywhere Cache zone. | | `gcp.storage.anywhere_cache_metering.eviction_byte_count` | Bytes | Delta number of bytes evicted from cache, broken down by zone. | | `gcp.storage.anywhere_cache_metering.ingested_billable_bytes_count` | Bytes | Delta number of billable bytes (successfully) ingested into the cache, broken down by zone. | | `gcp.storage.quota.anywhere_cache_storage_size.exceeded` | Count | Number of attempts to exceed the limit on quota metric `storage.googleapis.com/anywhere_cache_storage_size`. | | `gcp.storage.quota.anywhere_cache_storage_size.limit` | KiB | Current limit for this quota. | | `gcp.storage.quota.anywhere_cache_storage_size.usage` | KiB | Current usage for this quota. | **Client — 5 metrics** | Metric name | Unit | Description | | --------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `gcp.storage.client.grpc.client.attempt.duration` | Seconds | End-to-end time taken to complete an RPC attempt including the time it takes to pick a subchannel. | | `gcp.storage.client.grpc.client.attempt.rcvd_total_compressed_message_size` | Bytes | Total bytes (compressed but not encrypted) received across all response messages (metadata excluded) per RPC attempt; does not include grpc or transport framing bytes. | | `gcp.storage.client.grpc.client.attempt.sent_total_compressed_message_size` | Bytes | Total bytes (compressed but not encrypted) sent across all request messages (metadata excluded) per RPC attempt; does not include grpc or transport framing bytes. | | `gcp.storage.client.grpc.client.attempt.started` | Count | The total number of RPC attempts started, including those that have not completed. | | `gcp.storage.client.grpc.client.call.duration` | Seconds | This metric aims to measure the end-to-end time the gRPC library takes to complete an RPC from the application’s perspective. | ## Service account or user account [#service-account] ### Find and use data [#find-data] After connecting the integration to New Relic and waiting a few minutes, data will appear in the New Relic UI. To [find and use integration data](https://docs.newrelic.com/docs/telemetry-data-platform/understand-data/new-relic-data-types/), including your dashboards and your alert settings, go to [one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > GCP > Google Cloud Storage. To create custom dashboards for the integration, [create queries](https://docs.newrelic.com/docs/integrations/new-relic-integrations/getting-started/use-integration-data-new-relic-insights) for the `GcpStorageBucketSample` event type with the provider value `GcpStorageBucket`. ### GcpStorageBucketSample [#gcp-storage-bucket-sample] The integration reports [metric data](https://docs.newrelic.com/docs/telemetry-data-platform/understand-data/new-relic-data-types/#metrics) for all values of `method` and `response_code`: - `response_code`: The response code of the requests. - `method`: The name of the API method called. The metric data that New Relic receives from your Google Cloud Storage integration includes: | Metric | Description | | ----------------------- | ----------------------------------------------- | | `api.Requests` | Delta count of API calls. | | `network.ReceivedBytes` | Delta count of bytes received over the network. | | `network.SentBytes` | Delta count of bytes sent over the network. |