Google Cloud Platform
Stackdriver Monitoring

Supported Metrics

This page lists the predefined Google Cloud Platform metric types as defined by the Google Monitoring API v3, part of Stackdriver Monitoring. For a larger but less detailed list of metrics, including those from third party applications, see Available Metrics Summary. For more details about metric types, see the API reference for operations on MetricDescriptor and TimeSeries objects. To create your own custom metric types, see Custom Metrics.

Metric kinds

Each metric type has one of the metric kinds listed in the following table. For more information, see MetricKind in the API reference.

Metric kind Description Available in custom metrics?
cumulative The value is a total, accumulated since a given start time. For example, the total number of errors detected since a process started. Yes
delta The value is a change over a specified time period. For example, the number of errors detected in a minute. No
gauge The value is an instantaneous sample of a continuously-varying metric at a specific time. For example, a CPU's current temperature. Yes

Value types

Each metric type has one of the value types listed in the following table. For more information, see ValueType in the API reference.

Value type Description Available in custom metrics?
bool A Boolean value, either "true" or "false". Yes
distribution A distribution, consisting of a list of buckets and optionally an underflow bucket and an overflow bucket. Each bucket has an upper bound, a lower bound, and a count. The distribution can be used to create a histogram. Yes
double A double-precision floating-point value. Yes
int64 An integer value in the range [-263..263-1]. Yes
string A Unicode string with backslash escaping. No

Metrics

The following table lists the predefined Google Cloud Platform metric types.

Metric type and description Metric kind Value type Label keys
appengine.googleapis.com/
http/server/dos_intercept_count

Delta count of interceptions performed to prevent DoS attacks.

delta int64
appengine.googleapis.com/
http/server/quota_denial_count

Delta count of requests that failed due to the app being over quota.

delta int64
appengine.googleapis.com/
http/server/response_count

Delta HTTP response count.

delta int64

loading: Indicates whether the request was loading.

response_code: HTTP status code for the request.

appengine.googleapis.com/
http/server/response_latencies

Distribution of latencies.

delta distribution

loading: Indicates whether the request was loading.

response_code: HTTP status code for the request.

appengine.googleapis.com/
http/server/response_style_count

Delta counts on the HTTP serve style.

delta int64

dynamic: Indicates if the request was a static or dynamic request.

cached: Indicates if the response was cached.

appengine.googleapis.com/
memcache/centi_mcu_count

Memcache utilization in one hundredth of Memcache Compute Unit grouped by command.

delta int64

command:

appengine.googleapis.com/
memcache/operation_count

Count of memcache key operations, grouped by memcache command.

delta int64

command: Name of the memcache command.

appengine.googleapis.com/
memcache/received_bytes_count

Number of bytes received by app from the memcache API, grouped by status and memcache command.

delta int64

status: RPC status for that request.

command: Name of the memcache command.

appengine.googleapis.com/
memcache/sent_bytes_count

Number of bytes sent by app through the memcache API, grouped by memcache command.

delta int64

command: Name of the memcache command.

appengine.googleapis.com/
system/cpu/usage

CPU Usage in megacycles

delta int64

source: The source of the CPU usage (api or runtime).

appengine.googleapis.com/
system/instance_count

Number of instances that exist.

gauge int64

state: State of instance (active, idle, etc).

appengine.googleapis.com/
system/memory/usage

Memory usage of all instances.

gauge int64
appengine.googleapis.com/
system/network/received_bytes_count

Delta count of incoming network bandwidth.

delta int64

cached: Indicates if response was cached.

appengine.googleapis.com/
system/network/sent_bytes_count

Delta count of outgoing network bandwidth.

delta int64

cached: Indicates if response was cached.

cloudsql.googleapis.com/
database/disk/bytes_used

Data utilization in bytes.

gauge int64
cloudsql.googleapis.com/
database/disk/write_ops_count

Delta count of disk write IO operations.

delta int64
cloudsql.googleapis.com/
database/mysql/innodb_data_fsyncs

Delta count of InnoDB fsync() calls.

delta int64
cloudsql.googleapis.com/
database/mysql/innodb_os_log_fsyncs

Delta count of InnoDB fsync() calls to the log file.

delta int64
cloudsql.googleapis.com/
database/mysql/innodb_pages_read

Delta count of InnoDB pages read.

delta int64
cloudsql.googleapis.com/
database/mysql/innodb_pages_written

Delta count of InnoDB pages written.

delta int64
cloudsql.googleapis.com/
database/mysql/queries

Delta count of statements executed by the server.

delta int64
cloudsql.googleapis.com/
database/mysql/questions

Delta count of statements executed by the server sent by the client.

delta int64
cloudsql.googleapis.com/
database/mysql/replication/available_for_failover

This is true if the failover operation is available on the master instance.

gauge int64
cloudsql.googleapis.com/
database/mysql/replication/seconds_behind_master

Number of seconds the read replica is behind its master (approximation).

gauge int64
cloudsql.googleapis.com/
database/mysql/replication/slave_io_running

Indicates whether the I/O thread for reading the master's binary log is running. Possible values are Yes, No and Connecting.

gauge string
cloudsql.googleapis.com/
database/mysql/replication/slave_sql_running

Indicates whether the SQL thread for executing events in the relay log is running.

gauge string
cloudsql.googleapis.com/
database/network/connections

Number of connections to the Cloud SQL instance.

gauge int64
cloudsql.googleapis.com/
database/network/sent_bytes_count

Delta count of bytes sent through the network.

delta int64

destination:

cloudsql.googleapis.com/
database/state

The current serving state of the Cloud SQL instance. This can be one of the following. RUNNABLE: The instance is running, or is ready to run when accessed. SUSPENDED: The instance is not available, for example due to problems with billing. PENDING_CREATE: The instance is being created. MAINTENANCE: The instance is down for maintenance. UNKNOWN_STATE: The state of the instance is unknown.

gauge string
cloudsql.googleapis.com/
database/up

Indicates if the server is up or not. On-demand instances are spun down if no connections are made for a sufficient amount of time.

gauge int64
cloudsql.googleapis.com/
database/uptime

Delta count of the time in seconds the instance has been running.

delta int64
compute.googleapis.com/
firewall/dropped_bytes_count

Delta count of incoming bytes dropped by the firewall.

delta int64

instance_name: The name of the VM instance.

compute.googleapis.com/
firewall/dropped_packets_count

Delta count of incoming packets dropped by the firewall.

delta int64

instance_name: The name of the VM instance.

compute.googleapis.com/
instance/cpu/reserved_cores

Number of cores reserved on the host of the instance.

gauge double

instance_name: The name of the VM instance.

compute.googleapis.com/
instance/cpu/usage_time

Delta CPU usage time. Units are seconds. You can get the per-core CPU utilization ratio by performing a rate operation on a point: doubleValue/(end-start), then divide by compute.googleapis.com/instance/cpu/reserved_cores at the corresponding end timestamp.

delta double

instance_name: The name of the VM instance.

compute.googleapis.com/
instance/cpu/utilization

The percentage of the allocated CPU that is currently in use on the instance. Note that some machine types allow bursting above 100% usage.

gauge double

instance_name: The name of the VM instance.

compute.googleapis.com/
instance/disk/read_bytes_count

Delta count of bytes read from disk.

delta int64

instance_name: The name of the VM instance.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/read_ops_count

Delta count of disk read IO operations.

delta int64

instance_name: The name of the VM instance.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/throttled_read_bytes_count

Delta count of bytes in throttled read operations.

delta int64

instance_name: The name of the VM instance.

throttle_reason: Specifies the throttle reason, indicates throttling for PER_GB limit or PER_VM limit.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/throttled_read_ops_count

Delta count of throttled read operations.

delta int64

instance_name: The name of the VM instance.

throttle_reason: Specifies the throttle reason, indicates throttling for PER_GB limit or PER_VM limit.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/throttled_write_bytes_count

Delta count of bytes in throttled write operations.

delta int64

instance_name: The name of the VM instance.

throttle_reason: Specifies the throttle reason, indicates throttling for PER_GB limit or PER_VM limit.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/throttled_write_ops_count

Delta count of throttled write operations.

delta int64

instance_name: The name of the VM instance.

throttle_reason: Specifies the throttle reason, indicates throttling for PER_GB limit or PER_VM limit.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/write_bytes_count

Delta count of bytes written to disk.

delta int64

instance_name: The name of the VM instance.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/disk/write_ops_count

Delta count of disk write IO operations.

delta int64

instance_name: The name of the VM instance.

device_name: The name of the disk device.

storage_type: Specifies the storage type, either pd-standard or pd-ssd.

device_type: Specifies the disk type, either ephemeral or permanent.

compute.googleapis.com/
instance/network/received_bytes_count

Delta count of bytes received from network.

delta int64

instance_name: The name of the VM instance.

loadbalanced: Indicates whether traffic was either received from or sent to a load balanced IP address.

compute.googleapis.com/
instance/network/received_packets_count

Delta count of packets received from network.

delta int64

instance_name: The name of the VM instance.

loadbalanced: Indicates whether traffic was either received from or sent to a load balanced IP address.

compute.googleapis.com/
instance/network/sent_bytes_count

Delta count of bytes sent over network.

delta int64

instance_name: The name of the VM instance.

loadbalanced: Indicates whether traffic was either received from or sent to a load balanced IP address.

compute.googleapis.com/
instance/network/sent_packets_count

Delta count of packets sent over network.

delta int64

instance_name: The name of the VM instance.

loadbalanced: Indicates whether traffic was either received from or sent to a load balanced IP address.

compute.googleapis.com/
instance/uptime

Indicates the VM running time in seconds.

delta double

instance_name: The name of the VM instance.

container.googleapis.com/
container/cpu/reserved_cores

Number of cores of CPU reserved for the container

gauge double
container.googleapis.com/
container/cpu/usage_time

Cumulative CPU usage on all cores in seconds

cumulative double
container.googleapis.com/
container/cpu/utilization

The percentage of the allocated CPU that is currently in use on the container.

gauge double
container.googleapis.com/
container/disk/bytes_total

Total number of bytes of capacity on the disk identified by label ‘device_name’

gauge int64

device_name:

container.googleapis.com/
container/disk/bytes_used

Total number of bytes used on the disk identified by label ‘device_name’

gauge int64

device_name:

container.googleapis.com/
container/memory/bytes_total

Memory limit of the container in bytes

gauge int64
container.googleapis.com/
container/memory/bytes_used

Memory usage in bytes, broken down by type: evictable and non-evictable

gauge int64

memory_type:

container.googleapis.com/
container/memory/page_fault_count

Number of page faults, broken down by type: major and minor

delta int64

fault_type:

container.googleapis.com/
container/uptime

Number of seconds since the container started

cumulative double
datastore.googleapis.com/
api/request_count

Count of Datastore API calls.

gauge int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

api_method: The API method called (for example: BeginTransaction or Commit).

datastore.googleapis.com/
entity/read_sizes

Distribution of sizes of read entities, grouped by type.

gauge distribution

type: The type of entity read (for example: KEYS_ONLY or ENTITY_SCAN).

datastore.googleapis.com/
entity/write_sizes

Distribution of sizes of written entities, grouped by op.

gauge distribution

op: The operation type (for example: CREATE or DELETE_NOOP).

datastore.googleapis.com/
index/write_count

Count of Datastore index writes.

gauge double
pubsub.googleapis.com/
subscription/byte_cost

Cost of operations per subscription, measured in bytes. This is used to measure utilization for quotas.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

operation_type: Type of operation performed.

pubsub.googleapis.com/
subscription/config_updates_count

Delta count of subscription configuration changes, grouped by operation type and result.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

operation_type: Type of operation performed.

pubsub.googleapis.com/
subscription/num_outstanding_messages

Number of messages delivered to a subscription's push endpoint, but not yet acknowledged.

gauge int64
pubsub.googleapis.com/
subscription/num_undelivered_messages

Number of unacknowledged messages in a subscription.

gauge int64
pubsub.googleapis.com/
subscription/oldest_unacked_message_age

Age (in seconds) of the oldest unacknowledged message in a subscription.

gauge int64
pubsub.googleapis.com/
subscription/pull_ack_message_operation_count

Delta count of acknowledge message operations, grouped by result.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

pubsub.googleapis.com/
subscription/pull_ack_request_count

Delta count of acknowledge requests, grouped by result.

gauge double

response_class: A classification group for the response code (e.g. success, invalid, internal).

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

pubsub.googleapis.com/
subscription/pull_message_operation_count

Delta count of pull message operations, grouped by result.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

pubsub.googleapis.com/
subscription/pull_request_count

Delta count of pull requests, grouped by result.

gauge double

response_class: A classification group for the response code (e.g. success, invalid, internal).

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

pubsub.googleapis.com/
subscription/push_request_count

Delta count of message push attempts, grouped by result.

gauge double

response_class: A classification group for the response code (e.g. success, invalid, internal).

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

delivery_type: Push delivery mechanism.

pubsub.googleapis.com/
subscription/push_request_latencies

Distribution of push request latencies (in microseconds), grouped by result.

delta distribution

response_code: Operation response code, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

delivery_type: Push delivery mechanism.

pubsub.googleapis.com/
topic/byte_cost

Cost of operations per topic, measured in bytes. This is used to measure utilization for quotas.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

operation_type: Type of operation performed.

pubsub.googleapis.com/
topic/config_updates_count

Delta count of topic configuration changes, grouped by operation type and result.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

operation_type: Type of operation performed.

pubsub.googleapis.com/
topic/message_sizes

Distribution of publish request sizes (in bytes).

delta distribution
pubsub.googleapis.com/
topic/send_message_operation_count

Delta count of publish message operations, grouped by result.

delta int64

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).

pubsub.googleapis.com/
topic/send_request_count

Delta count of publish requests, grouped by result.

gauge double

response_class: A classification group for the response code (e.g. success, invalid, internal).

response_code: Operation response code string, derived as a string representation of a HTTP status code (e.g. success, not_found, unavailable).