The following Spanner metrics are provided to Cloud Monitoring. For the best performance debugging results, use server-side metrics with client-side metrics .
The "metric type" strings in this table must be prefixed
with spanner.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
"
.
Display name
Monitored resources
Labels
api/adapter_request_count
BETA
(project)
Adapter API requests
database
:
Target database.status
:
Request call result, ok=success.method
:
Cloud Spanner Adapter API method.protocol
:
Adapter protocol.message_type
:
Adapter protocol message type.adapter_status
:
Adapter protocol request result.op_type
:
Operation type.api/adapter_request_latencies
BETA
(project)
Adapter request latencies
database
:
Target database.method
:
Cloud Spanner Adapter API method.protocol
:
Adapter protocol.message_type
:
Adapter protocol message type.op_type
:
Operation type.api/api_request_count
GA
(project)
API requests
database
:
Target database.status
:
Request call result, ok=success.method
:
Cloud Spanner API method.api/read_request_count_by_serving_location
BETA
(project)
Read API request by serving location
database
:
Target database.method
:
Cloud Spanner API method.is_change_stream
:
(BOOL)
TRUE if it is a change stream query.is_directed_read
:
(BOOL)
TRUE if it is a directed read query.status
:
Request call result, OK=success.serving_location
:
The location of serving replicas.api/read_request_latencies_by_change_stream
GA
(project)
Read request latencies by change stream
database
:
Target database.method
:
Cloud Spanner API method.is_change_stream
:
(BOOL)
TRUE if it is a change stream query.api/read_request_latencies_by_serving_location
BETA
(project)
Read API request latencies by serving location
database
:
Target database.method
:
Cloud Spanner API method.is_change_stream
:
(BOOL)
TRUE if it is a change stream query.is_directed_read
:
(BOOL)
TRUE if it is a directed read query.serving_location
:
The location of serving replicas.api/received_bytes_count
GA
(project)
Bytes received by Cloud Spanner
database
:
Target database.method
:
Cloud Spanner API method.api/request_count
GA
(project)
API request rate
database
:
Target database.status
:
Request call result, ok=success.method
:
Cloud Spanner API method.api/request_latencies
GA
(project)
Request latencies
database
:
Target database.method
:
Cloud Spanner API method.api/request_latencies_by_transaction_type
GA
(project)
Request latencies by transaction type
database
:
Target database.method
:
Cloud Spanner API method.transaction_type
:
Transaction type ("READ_ONLY" or "READ_WRITE").is_leader_involved
:
(BOOL)
TRUE if the leader roundtrip call is issued.api/sent_bytes_count
GA
(project)
Bytes sent by Cloud Spanner
database
:
Target database.method
:
Cloud Spanner API method.client/afe_connectivity_error_count
GA
(project)
AFE Connectivity Error Count
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/afe_latencies
GA
(project)
AFE Latencies
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/attempt_count
GA
(project)
Attempt Count
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner attempt status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/attempt_latencies
GA
(project)
Attempt Latencies
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner attempt status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/gfe_connectivity_error_count
GA
(project)
GFE Connectivity Error Count
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/gfe_latencies
GA
(project)
GFE Latencies
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/operation_count
GA
(project)
Operation Count
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.client/operation_latencies
GA
(project)
Operation Latencies
method
:
Cloud Spanner API method.database
:
Target database.status
:
Cloud Spanner operation status.client_name
:
Cloud Spanner client name.directpath_enabled
:
(BOOL)
True if directpath is enabled.directpath_used
:
(BOOL)
True if directpath is used for the RPC request.graph_query_stat/total/bytes_returned_count
GA
(project)
Graph query bytes returned count
database
:
Target database.graph_query_stat/total/execution_count
GA
(project)
Graph query execution count
database
:
Target database.graph_query_stat/total/failed_execution_count
GA
(project)
Graph query failures
database
:
Target database.status
:
failed status, one of [cancelled, timeout, error].graph_query_stat/total/query_latencies
GA
(project)
Graph query latencies
database
:
Target database.graph_query_stat/total/returned_rows_count
GA
(project)
Graph query rows returned count
database
:
Target database.graph_query_stat/total/scanned_rows_count
GA
(project)
Graph query rows scanned count
database
:
Target database.instance/autoscaling/high_priority_cpu_utilization_target
GA
(project)
Autoscaling high priority cpu utilization target
instance/autoscaling/max_node_count
GA
(project)
Autoscaling max nodes
instance/autoscaling/max_processing_units
GA
(project)
Autoscaling max processing units
instance/autoscaling/min_node_count
GA
(project)
Autoscaling min nodes
instance/autoscaling/min_processing_units
GA
(project)
Autoscaling min processing units
instance/autoscaling/storage_utilization_target
GA
(project)
Autoscaling storage utilization target
instance/backup/used_bytes
GA
(project)
Backup storage used
database
:
Target database.backup
:
Target backup.instance/cpu/smoothed_utilization
GA
(project)
Smoothed CPU utilization
database
:
Target database.instance/cpu/utilization
GA
(project)
CPU utilization
database
:
Target database.instance/cpu/utilization_by_operation_type
GA
(project)
CPU utilization by operation type
database
:
Target database.is_system
:
(BOOL)
TRUE if the number is system CPU utilization.priority
:
Task priority ("high" or "medium" or "low").category
:
Operation type ("read_readonly", "beginorcommit" etc).instance/cpu/utilization_by_priority
GA
(project)
CPU utilization by priority
database
:
Target database.is_system
:
(BOOL)
TRUE if the number is system CPU utilization.priority
:
Task priority ("high", "medium", or "low").instance/cross_region_replicated_bytes_count
GA
(project)
Cross region replicated bytes
database
:
Target database.source_region
:
Preferred leader region.destination_region
:
Cloud Spanner region the data is replicated to.tag
:
Type of transaction contributing to replication.instance/data_boost/processing_unit_second_count
GA
(project)
Processing unit second
credential_id
:
The IAM credential ID.instance/disk_load
GA
(project)
Disk load
database
:
Target database.instance/dual_region_quorum_availability
GA
(project)
Dual Region Quorum Availability
quorum_availability
:
Quorum availability level.instance/edition/feature_usage
BETA
(project)
Feature usage
feature
:
Edition feature.database
:
Database using the feature, if any.used_in_query_path
:
(BOOL)
Used in query path, or not.instance/leader_percentage_by_region
GA
(project)
Leader percentage by region
database
:
Target database.region
:
Cloud region containing the leaders.instance/node_count
GA
(project)
Nodes
instance/peak_split_cpu_usage_score
GA
(project)
Peak split cpu usage score
database
:
Target database.instance/placement_row_limit
GA
(project)
Placement row limit
instance/placement_row_limit_per_processing_unit
GA
(project)
Placement row limit per processing unit
instance/placement_rows
GA
(project)
Placement row count by database
database
:
Target database.instance/processing_units
GA
(project)
Processing units
instance/replica/autoscaling/high_priority_cpu_utilization_target
GA
(project)
Autoscaling high priority cpu utilization target for replica
location
:
Replica location.replica_type
:
Replica type.instance/replica/autoscaling/max_node_count
GA
(project)
Autoscaling max nodes for replica
location
:
Replica location.replica_type
:
Replica type.instance/replica/autoscaling/max_processing_units
GA
(project)
Autoscaling max processing units for replica
location
:
Replica location.replica_type
:
Replica type.instance/replica/autoscaling/min_node_count
GA
(project)
Autoscaling min nodes for replica
location
:
Replica location.replica_type
:
Replica type.instance/replica/autoscaling/min_processing_units
GA
(project)
Autoscaling min processing units for replica
location
:
Replica location.replica_type
:
Replica type.instance/replica/cmek/total_keys
BETA
(project)
CMEK keys
database
:
Target database.is_key_revoked
:
(BOOL)
True if the CloudKMS key is revoked.instance/replica/node_count
GA
(project)
Replica nodes
location
:
Replica location.replica_type
:
Replica type.instance/replica/processing_units
GA
(project)
Replica processing units.
location
:
Replica location.replica_type
:
Replica type.instance/schema_object_count_limit
GA
(project)
Schema objects count limit
instance/schema_objects
GA
(project)
Schema object count
database
:
Target database.instance/session_count
GA
(project)
Sessions
database
:
Target database.instance/storage/columnar_used_bytes
BETA
(project)
Storage used (logical) for columnar storage
database
:
Target database.storage_class
:
Storage type.instance/storage/columnar_used_bytes_by_region
BETA
(project)
Storage used (logical) for columnar storage by region
database
:
Target database.storage_class
:
Storage type.instance/storage/combined/limit_bytes
GA
(project)
Storage limit (combined)
instance/storage/combined/limit_bytes_per_processing_unit
GA
(project)
Storage limit (combined) per processing unit
instance/storage/combined/utilization
GA
(project)
Storage utilization (combined)
instance/storage/limit_bytes
GA
(project)
Storage limit
storage_class
:
Storage type.instance/storage/limit_bytes_per_processing_unit
GA
(project)
Storage limit per processing unit
storage_class
:
Storage type.instance/storage/used_bytes
GA
(project)
Storage used
database
:
Target database.storage_class
:
Storage type.instance/storage/utilization
GA
(project)
Storage utilization
storage_class
:
Storage type.lock_stat/total/lock_wait_time
GA
(project)
Lock wait time
database
:
Target database.pending_restore_count
GA
(project)
Pending restore count
query_count
GA
(project)
Count of queries
database
:
Target database.status
:
Request call result, ok=success.query_type
:
Type of query.optimizer_version
:
(INT64)
Optimizer version used by the query.query_stat/total/bytes_returned_count
GA
(project)
Bytes returned count
database
:
Target database.query_stat/total/cpu_time
GA
(project)
Query cpu time
database
:
Target database.query_stat/total/execution_count
GA
(project)
Query execution count
database
:
Target database.query_stat/total/failed_execution_count
GA
(project)
Query failures
database
:
Target database.status
:
failed status, one of [cancelled, timeout, error].query_stat/total/query_latencies
GA
(project)
Query latencies
database
:
Target database.query_stat/total/remote_service_calls_count
GA
(project)
Remote service calls count
database
:
Target database.service
:
Target remote service.response_code
:
(INT64)
HTTP response code received, such as 200 or 500.query_stat/total/remote_service_calls_latencies
GA
(project)
Remote service calls latencies
database
:
Target database.service
:
Target remote service.response_code
:
(INT64)
HTTP response code received, such as 200 or 500.query_stat/total/remote_service_network_bytes_sizes
GA
(project)
Remote service network bytes
database
:
Target database.service
:
Target remote service.direction
:
Direction of traffic: sent or received.query_stat/total/remote_service_processed_rows_count
GA
(project)
Remote service rows count
database
:
Target database.service
:
Target remote service.response_code
:
(INT64)
HTTP response code received, such as 200 or 500.query_stat/total/remote_service_processed_rows_latencies
GA
(project)
Remote service rows latencies
database
:
Target database.service
:
Target remote service.response_code
:
(INT64)
HTTP response code received, such as 200 or 500.query_stat/total/returned_rows_count
GA
(project)
Rows returned count
database
:
Target database.query_stat/total/scanned_rows_count
GA
(project)
Rows scanned count
database
:
Target database.quota/pending_restore_count/exceeded
GA
(project)
Pending restore count quota exceeded error
limit_name
:
The limit name.quota/pending_restore_count/limit
GA
(project)
Pending restore count quota limit
limit_name
:
The limit name.quota/pending_restore_count/usage
GA
(project)
Pending restore count quota usage
limit_name
:
The limit name.read_stat/total/bytes_returned_count
GA
(project)
Bytes returned count
database
:
Target database.read_stat/total/client_wait_time
GA
(project)
Client wait time
database
:
Target database.read_stat/total/cpu_time
GA
(project)
Read cpu time
database
:
Target database.read_stat/total/execution_count
GA
(project)
Read execution count
database
:
Target database.read_stat/total/leader_refresh_delay
GA
(project)
Leader refresh delay
database
:
Target database.read_stat/total/locking_delays
GA
(project)
Locking delays
database
:
Target database.read_stat/total/returned_rows_count
GA
(project)
Rows returned count
database
:
Target database.row_deletion_policy/deleted_rows_count
GA
(project)
Rows deleted
database
:
Target database.row_deletion_policy/processed_watermark_age
GA
(project)
Processed watermark age
database
:
Target database.row_deletion_policy/undeletable_rows
GA
(project)
Total number of undeletable rows
database
:
Target database.transaction_stat/total/bytes_written_count
GA
(project)
Bytes written
database
:
Target database.transaction_stat/total/commit_attempt_count
GA
(project)
Transaction commit attempts
database
:
Target database.status
:
Commit status ("success", "abort", or "precondition_failure")transaction_stat/total/commit_retry_count
GA
(project)
Transaction commit retries
database
:
Target database.transaction_stat/total/participants
GA
(project)
Transaction participants
database
:
Target database.transaction_stat/total/transaction_latencies
GA
(project)
Transaction latencies
database
:
Target database.Table generated at 2025-09-05 02:07:49 UTC.