---
title: Google Cloud Bigtable monitoring integration
source: https://docs.newrelic.com/docs/infrastructure/google-cloud-platform-integrations/gcp-integrations-list/google-cloud-bigtable-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 Bigtable](https://cloud.google.com/bigtable) data to New Relic. This document explains how to activate the GCP Bigtable integration and describes the data it reports.

## Features

Cloud Bigtable is Google Cloud's fully managed, wide-column NoSQL database service. New Relic Bigtable integration collects CPU, storage, replication, and request metrics at both cluster and table scope.

## 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 Bigtable 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 Bigtable resources 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 Bigtable 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 Bigtable metrics documentation](https://cloud.google.com/monitoring/api/metrics_gcp#gcp-bigtable) for the complete list.

#### Entities

**Bigtable entities**

| Entity  | Entity type          | Resource type      |
| ------- | -------------------- | ------------------ |
| Cluster | `GCPBIGTABLECLUSTER` | `bigtable_cluster` |
| Table   | `GCPBIGTABLETABLE`   | `bigtable_table`   |

### Metric data [#metrics-wif]

#### Key metrics — Cluster

| Metric name                                  | Unit    | Description                                          |
| -------------------------------------------- | ------- | ---------------------------------------------------- |
| `gcp.bigtable.cluster.cpu_load`              | Percent | Average CPU load across nodes in the cluster.        |
| `gcp.bigtable.cluster.cpu_load_hottest_node` | Percent | CPU load on the hottest node in the cluster.         |
| `gcp.bigtable.cluster.disk_load`             | Percent | Fraction of HDD disk capacity in use by the cluster. |
| `gcp.bigtable.cluster.storage_utilization`   | Percent | Fraction of storage capacity in use by the cluster.  |
| `gcp.bigtable.cluster.node_count`            | Count   | Number of nodes in the cluster.                      |

#### Key metrics — Table

| Metric name                                | Unit         | Description                                                           |
| ------------------------------------------ | ------------ | --------------------------------------------------------------------- |
| `gcp.bigtable.server.request_count`        | Count        | Number of server-side requests against the table, faceted by method.  |
| `gcp.bigtable.server.error_count`          | Count        | Number of server-side errors returned for requests against the table. |
| `gcp.bigtable.server.sent_bytes_count`     | Bytes        | Uncompressed response bytes returned by the table.                    |
| `gcp.bigtable.server.received_bytes_count` | Bytes        | Uncompressed request bytes received by the table.                     |
| `gcp.bigtable.replication.latency`         | Milliseconds | Replication latency observed for the table between clusters.          |
| `gcp.bigtable.table.storageUtilization`    | Percent      | Fraction of storage capacity in use by the table.                     |

For the complete list of Bigtable metrics, see [Google's Bigtable metrics documentation](https://cloud.google.com/monitoring/api/metrics_gcp#gcp-bigtable).

### Metrics-only resource types [#metrics-only]

New Relic also collects metrics for the following Bigtable resource types. These resource types don't create entities in the entity explorer, so query their metrics directly on the `Metric` event type.

**Materialized View — 5 metrics**

| Metric name                                           | Unit    | Description                                                                        |
| ----------------------------------------------------- | ------- | ---------------------------------------------------------------------------------- |
| `gcp.bigtable.materialized_view.intermediate_storage` | Bytes   | Amount of data used by intermediate processing for the materialized view in bytes. |
| `gcp.bigtable.materialized_view.max_delay`            | Seconds | Upper bound of processing delay for the materialized view.                         |
| `gcp.bigtable.materialized_view.storage`              | Bytes   | Amount of data used for the materialized view storage in bytes.                    |
| `gcp.bigtable.materialized_view.system_errors`        | Count   | Number of errors from system for the materialized view.                            |
| `gcp.bigtable.materialized_view.user_errors`          | Count   | Number of errors from user data for the materialized view.                         |

**Backup — 1 metric**

| Metric name                      | Unit  | Description                   |
| -------------------------------- | ----- | ----------------------------- |
| `gcp.bigtable.backup.bytes_used` | Bytes | Backup storage used in bytes. |

## Service account or user account [#service-account]

### Find and use data [#find-data]

To find your integration data, go to [one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Infrastructure > GCP and select the integration.

Data is attached to the following [event types](https://docs.newrelic.com/docs/data-apis/understand-data/new-relic-data-types/#event-data):

| Entity  | Event Type                 | Provider             |
| ------- | -------------------------- | -------------------- |
| Cluster | `GcpBigtableClusterSample` | `GcpBigtableCluster` |
| Table   | `GcpBigtableTableSample`   | `GcpBigtableTable`   |

For more on how to use your data, see [Understand and use integration data](https://docs.newrelic.com/docs/infrastructure/integrations/find-use-infrastructure-integration-data).

## Metric data [#metrics]

This integration collects GCP Bigtable data for Cluster and Table.

### Bigtable Cluster data

| Metric                       | Unit  | Description                                                             |
| ---------------------------- | ----- | ----------------------------------------------------------------------- |
| `cluster.CpuLoad`            | Count | CPU load of a cluster.                                                  |
| `cluster.CpuLoadHottestNode` | Count | CPU load of the busiest node in a cluster.                              |
| `cluster.DiskLoad`           | Count | Utilization of HDD disks in a cluster.                                  |
| `cluster.Node`               | Count | Number of nodes in a cluster.                                           |
| `cluster.StorageUtilization` | Count | Storage used as a fraction of total storage capacity.                   |
| `disk.BytesUsed`             | Bytes | Amount of compressed data for tables stored in a cluster.               |
| `disk.StorageCapacity`       | Bytes | Capacity of compressed data for tables that can be stored in a cluster. |

### Bigtable Table data

| Metric                         | Unit         | Description                                                                                                                                   |
| ------------------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `replication.Latency`          | Milliseconds | Distribution of replication request latencies for a table. Includes only requests that have been received by the destination cluster.         |
| `replication.MaxDelay`         | Seconds      | Upper bound for replication delay between clusters of a table. Indicates the time frame during which latency information may not be accurate. |
| `server.Error`                 | Count        | Number of server requests for a table that failed with an error.                                                                              |
| `server.Latencies`             | Milliseconds | Distribution of server request latencies for a table, measured when calls reach Cloud Bigtable.                                               |
| `server.ModifiedRows`          | Count        | Number of rows modified by server requests for a table.                                                                                       |
| `server.MultiClusterFailovers` | Count        | Number of failovers during multi-cluster requests.                                                                                            |
| `server.ReceivedBytes`         | Bytes        | Number of uncompressed bytes of request data received by servers for a table.                                                                 |
| `server.Request`               | Count        | Number of server requests for a table.                                                                                                        |
| `server.ReturnedRows`          | Count        | Number of rows returned by server requests for a table.                                                                                       |
| `server.SentBytes`             | Bytes        | Number of uncompressed bytes of response data sent by servers for a table.                                                                    |
| `table.BytesUsed`              | Bytes        | Amount of compressed data stored in a table.                                                                                                  |