Metrics
The following Bigtable metrics are provided to Cloud Monitoring. For best results, always use server-side metrics in conjunction with client-side metrics for performance debugging.
The "metric type" strings in this table must be prefixed with bigtable.googleapis.com/. That prefix has been omitted from the entries in the table. When querying a label, use the metric.labels. prefix; for example, metric.labels.LABEL="VALUE".
| Metric type Launch stage (Resource hierarchy levels) Display name | |
|---|---|
| Kind, Type, Unit Monitored resources | Description Labels |
backup/bytes_used GA (project) Backup storage used. | |
GAUGE, INT64, By bigtable_backup | Backup storage used in bytes. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. source_table: The source table of the backup. storage_type: Type of disk storage. |
client/application_blocking_latencies GA (project) Application Blocking Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | The total latency introduced by your application when Cloud Bigtable has available response data but your application has not consumed it. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. client_name: Cloud Bigtable client name. |
client/attempt_latencies GA (project) Attempt Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | Client observed latency per RPC attempt. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. streaming: (BOOL) Cloud Bigtable streaming method. status: Cloud Bigtable attempt status. client_name: Cloud Bigtable client name. |
client/client_blocking_latencies GA (project) Client Blocking Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | The latency introduced by the client by blocking on sending more requests to the server when there are too many pending requests in bulk operations. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. client_name: Cloud Bigtable client name. |
client/connectivity_error_count GA (project) Connectivity Error Count | |
DELTA, INT64, 1 bigtable_table | Number of requests that failed to reach the Google network. (Requests without google response headers). Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. status: Cloud Bigtable operation status. client_name: Cloud Bigtable client name. |
client/first_response_latencies GA (project) First Response Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | Latency from operation start until the response headers were received. The publishing of the measurement will be delayed until the attempt response has been received. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. status: Cloud Bigtable operation status. client_name: Cloud Bigtable client name. |
client/operation_latencies GA (project) Operation Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | Distribution of the total end-to-end latency across all RPC attempts associated with a Bigtable operation. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. streaming: (BOOL) Cloud Bigtable streaming method. status: Cloud Bigtable operation status. client_name: Cloud Bigtable client name. |
client/retry_count GA (project) Retry Count | |
DELTA, INT64, 1 bigtable_table | The number of additional RPCs sent after the initial attempt. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. status: Cloud Bigtable operation status. client_name: Cloud Bigtable client name. |
client/server_latencies GA (project) Server Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | The latency measured between the time when Google frontend receives an RPC and sending back the first byte of the response. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. streaming: (BOOL) Cloud Bigtable streaming method. status: Cloud Bigtable operation status. client_name: Cloud Bigtable client name. |
cluster/autoscaling/max_node_count GA (project) Maximum nodes | |
GAUGE, INT64, 1 bigtable_cluster | Maximum number of nodes in an autoscaled cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. storage_type: Storage type for the cluster. |
cluster/autoscaling/min_node_count GA (project) Minimum nodes | |
GAUGE, INT64, 1 bigtable_cluster | Minimum number of nodes in an autoscaled cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. storage_type: Storage type for the cluster. |
cluster/autoscaling/recommended_node_count_for_cpu GA (project) Recommended nodes based on CPU | |
GAUGE, INT64, 1 bigtable_cluster | Recommended number of nodes in an autoscaled cluster based on CPU usage. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. |
cluster/autoscaling/recommended_node_count_for_storage GA (project) Recommended nodes based on storage | |
GAUGE, INT64, 1 bigtable_cluster | Recommended number of nodes in an autoscaled cluster based on storage usage. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. |
cluster/cpu_load GA (project) CPU load | |
GAUGE, DOUBLE, 1 bigtable_cluster | CPU load of a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. |
cluster/cpu_load_by_app_profile_by_method_by_table GA (project) CPU load by app profile, method, and table | |
GAUGE, DOUBLE, 1 bigtable_cluster | CPU load of a cluster. Split by app profile, method, and table. Contains the same underlying data as bigtable.googleapis.com/cluster/cpu_load. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. app_profile: Cloud Bigtable application profile. method: Cloud Bigtable API method. table: Cloud Bigtable table name. |
cluster/cpu_load_hottest_node GA (project) CPU load (hottest node) | |
GAUGE, DOUBLE, 1 bigtable_cluster | CPU load of the busiest node in a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. |
cluster/cpu_load_hottest_node_high_granularity GA (project) CPU load (hottest node) high granularity | |
GAUGE, DOUBLE, 1 bigtable_cluster | CPU load of the busiest node in a cluster sampled at a high granularity. Sampled every 60 seconds. After sampling, data is not visible for up to 300 seconds. |
cluster/disk_load GA (project) Disk load | |
GAUGE, DOUBLE, 1 bigtable_cluster | Utilization of HDD disks in a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. |
cluster/node_count GA (project) Nodes | |
GAUGE, INT64, 1 bigtable_cluster | Number of nodes in a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. storage_type: Storage type for the cluster. |
cluster/storage_utilization GA (project) Storage utilization | |
GAUGE, DOUBLE, 1 bigtable_cluster | Storage used as a fraction of total storage capacity. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. storage_type: Storage type for the cluster. |
disk/bytes_used GA (project) Data stored | |
GAUGE, INT64, By bigtable_cluster | Amount of compressed data for tables stored in a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. storage_type: Type of disk storage. |
disk/per_node_storage_capacity EARLY_ACCESS (project) Storage capacity per node | |
GAUGE, INT64, By bigtable_cluster | Capacity of compressed data for tables that can be stored per node in the cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. storage_type: Storage type for the cluster. |
disk/storage_capacity GA (project) Storage capacity | |
GAUGE, INT64, By bigtable_cluster | Capacity of compressed data for tables that can be stored in a cluster. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. storage_type: Storage type for the cluster. |
materialized_view/intermediate_storage BETA (project) Data for intermediate processing. | |
GAUGE, INT64, By bigtable_materialized_view | Amount of data used by intermediate processing for the materialized view in bytes. Sampled every 60 seconds. After sampling, data is not visible for up to 60 seconds. storage_type: Type of disk storage. |
materialized_view/max_delay BETA (project) Maximum processing delay | |
GAUGE, INT64, s bigtable_materialized_view | Upper bound of processing delay for the materialized view. Sampled every 60 seconds. After sampling, data is not visible for up to 60 seconds. |
materialized_view/storage BETA (project) Materialized view data. | |
GAUGE, INT64, By bigtable_materialized_view | Amount of data used for the materialized view storage in bytes. Sampled every 60 seconds. After sampling, data is not visible for up to 60 seconds. storage_type: Type of disk storage. |
materialized_view/system_errors BETA (project) System error count | |
DELTA, INT64, 1 bigtable_materialized_view | Number of errors from system for the materialized view. Sampled every 60 seconds. After sampling, data is not visible for up to 60 seconds. canonical_status: Canonical error status. |
materialized_view/user_errors BETA (project) User error count | |
DELTA, INT64, 1 bigtable_materialized_view | Number of errors from user data for the materialized view. Sampled every 60 seconds. After sampling, data is not visible for up to 60 seconds. canonical_status: Canonical error status. |
replication/latency GA (project) Replication latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | Distribution of the replication latencies of mutations to a table, measured as the difference between the commit time at the source and destination clusters. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. source_cluster: Source cluster of the replicated data. source_zone: Source zone of the replicated data. |
replication/max_delay GA (project) Replication maximum delay | |
GAUGE, DOUBLE, s bigtable_table | Upper bound for replication delay between clusters of a table. Indicates the time frame during which latency information may not be accurate. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. source_cluster: Source cluster of the replicated data. source_zone: Source zone of the replicated data. |
server/data_boost/eligibility_count GA (project) Data Boost traffic eligibility count | |
DELTA, INT64, 1 bigtable_table | Current Bigtable requests that are eligible and ineligible for Data Boost. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. app_profile: Cloud Bigtable application profile. eligibility: Whether request is eligible for Data Boost. |
server/data_boost/ineligible_reasons GA (project) Data Boost traffic ineligible reasons | |
GAUGE, INT64, 1 bigtable_table | Reasons that current traffic is ineligible for Data Boost. Sampled every 60 seconds. After sampling, data is not visible for up to 240 seconds. app_profile: Cloud Bigtable application profile. ineligible_reason: Reason that request is ineligible for Data Boost. |
server/data_boost/spu_usage GA (project) Data Boost SPU Usage | |
GAUGE, INT64, 1 bigtable_table | The Serverless-Processing-Units usage (in SPU-seconds) for Data Boost requests. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. app_profile: Cloud Bigtable application profile. method: Cloud Bigtable API method. |
server/error_count GA (project) Error count | |
DELTA, INT64, 1 bigtable_table | Number of server requests for a table that failed with an error. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. error_code: gRPC Error Code. app_profile: Cloud Bigtable application profile. |
server/latencies GA (project) Server Latencies | |
DELTA, DISTRIBUTION, ms bigtable_table | Distribution of server request latencies for a table. The latency is measured between the time when Cloud Bigtable (behind the Google frontend) receives an RPC and the time when it sends back the last byte of the response. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/modified_rows_count GA (project) Modified rows | |
DELTA, INT64, 1 bigtable_table | Number of rows modified by server requests for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/multi_cluster_failovers_count GA (project) Multi-cluster failovers | |
DELTA, INT64, 1 bigtable_table | Number of failovers during multi-cluster requests. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/read_latencies_by_storage_tier BETA (project) Server Read Latencies by Storage Tier | |
DELTA, DISTRIBUTION, ms bigtable_table | Distribution of server read request latencies by storage tier for a table. The latency is measured between the time when Cloud Bigtable (behind the Google frontend) receives an RPC and the time when it sends back the last byte of the response. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. storage_tier: Type of storage tier accessed in the request. |
server/read_request_count_by_storage_tier BETA (project) Read request count by Storage Tier | |
DELTA, INT64, 1 bigtable_table | Number of server read requests by storage tier for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. storage_tier: Type of storage tier accessed in the request. |
server/received_bytes_count GA (project) Received bytes | |
DELTA, INT64, By bigtable_table | Number of bytes of request data received by servers for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/request_count GA (project) Request count | |
DELTA, INT64, 1 bigtable_table | Number of server requests for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/request_max_per_minute_count GA (project) Five-second maximum requests per minute | |
DELTA, INT64, 1 bigtable_table | Maximum number of requests received in a five-second span per minute. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/returned_rows_count GA (project) Returned rows | |
DELTA, INT64, 1 bigtable_table | Number of rows returned by server requests for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
server/sent_bytes_count GA (project) Sent bytes | |
DELTA, INT64, By bigtable_table | Number of bytes of response data sent by servers for a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. method: Cloud Bigtable API method. app_profile: Cloud Bigtable application profile. |
table/bytes_transferred_to_infrequent_access BETA (project) Data moved to Infrequent Access | |
GAUGE, INT64, By bigtable_table | Amount of data moved to IA storage. Sampled every 60 seconds. After sampling, data is not visible for up to 180 seconds. |
table/bytes_used GA (project) Data stored | |
GAUGE, INT64, By bigtable_table | Amount of compressed data stored in a table. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. storage_type: Type of disk storage. |
table/change_stream_log_used_bytes GA (project) Change stream data | |
GAUGE, INT64, By bigtable_table | Amount of disk storage used by the change stream logs. Sampled every 60 seconds. After sampling, data is not visible for up to 120 seconds. storage_type: Type of disk storage. |
Table generated at 2025-11-06 21:06:21 UTC.
What's next
- Learn more about Bigtable Monitoring.
- Explore metrics available in Key Visualizer.
- View the full list of Google Cloud metrics.