Hide
Cloud Monitoring

Supported Metrics

The following tables list the metrics that are available through the Cloud Monitoring API, and the labels attached to these metrics that provide information specific to your query.

Common metric labels for all metrics

Label name Description
cloud.googleapis.com/service Identifies the Cloud service. Examples: "appengine.googleapis.com", "pubsub.googleapis.com".

Common metric labels for App Engine metrics

Label name Description
cloud.googleapis.com/location The geographic location, using the service's naming convention for locations. Example: "us3" (an App Engine zone).
appengine.googleapis.com/module The module name of the app. Example: "default".
appengine.googleapis.com/version The version id of the app. Example: "2".

Common metric labels for Compute Engine metrics

Label name Description
cloud.googleapis.com/location The geographic location, using the service's naming convention for locations. Example: "europe-west1-c" (a Compute Engine zone).
compute.googleapis.com/resource_type The type of resource. Example: "instance" (a virtual machine instance).
compute.googleapis.com/resource_id The identifier for the resource. Example: "13486444024145940021" (a particular instance).

Common metric labels for Cloud SQL metrics

Label name Description
cloud.googleapis.com/location The geographical location, using the service's naming convention for locations.. Example: "europe-west1-a".
cloudsql.googleapis.com/resource_type The type of resource. Example: "instance" (a Cloud SQL instance).
cloudsql.googleapis.com/resource_id The identifier for the resource. Example: "my-gcp-project-id:my-cloud-sql-id".

Common metric labels for Cloud PubSub metrics

Label name Description
pubsub.googleapis.com/resource_type The type of resource. Examples: "topic", "subscription".
pubsub.googleapis.com/resource_id The resource name within the project. Example: "a_topic_name".

Metric types

Metric type 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. No
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

Metric value types

Metric type Description Available in custom metrics
bool A Boolean value, either "true" or "false". No
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. No
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

Metric name/Description Type Value Related labels
appengine.googleapis.com/http/server/dos_intercept_count

Delta count of interceptions performed to prevent DoS attacks.

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

Delta count of HTTP responses to a pagespeed entity.

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 appengine.googleapis.com/loading

Indicates whether the request was loading.

appengine.googleapis.com/response_code

HTTP status code for the request.

appengine.googleapis.com/http/server/response_latencies

Distribution of latencies.

delta distribution appengine.googleapis.com/loading

Indicates whether the request was loading.

appengine.googleapis.com/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 appengine.googleapis.com/dynamic

Indicates if the request was a static or dynamic request.

appengine.googleapis.com/cached

Indicates if the response was cached.

appengine.googleapis.com/system/instance_count

Number of instances that exist.

gauge int64 appengine.googleapis.com/state

State of instance (active, idle, etc).

appengine.googleapis.com/system/network/pagespeed_sent_bytes_count

Outgoing network bandwidth delta.

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

Delta count of incoming network bandwidth.

delta int64 appengine.googleapis.com/cached

Indicates if response was cached.

appengine.googleapis.com/system/network/sent_bytes_count

Delta count of outgoing network bandwidth.

delta int64 appengine.googleapis.com/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/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 cloudsql.googleapis.com/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 compute.googleapis.com/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 compute.googleapis.com/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 compute.googleapis.com/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 compute.googleapis.com/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 compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/throttle_reason

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

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/throttle_reason

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

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/throttle_reason

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

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/throttle_reason

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

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/device_name

The name of the disk device.

compute.googleapis.com/storage_type

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

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

compute.googleapis.com/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 compute.googleapis.com/instance_name

The name of the VM instance.

datastore.googleapis.com/entity/read_sizes

Distribution of sizes of read entities, grouped by type.

gauge distribution datastore.googleapis.com/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 datastore.googleapis.com/op

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

network.googleapis.com/loadbalancer/backend_latencies

A distribution of the latency calculated from when the request was received by the load balancer until the load balancer has sent the response.

delta distribution network.googleapis.com/response_code_class

the class of the http response code. This can be 200, 300, 400, 500 or 0. 0 indicates no response code was returned.

network.googleapis.com/loadbalancer/request_bytes_count

The number of bytes sent to a load-balanced backend.

delta int64
network.googleapis.com/loadbalancer/request_count

The number of requests sent to a load-balanced backend.

delta int64 network.googleapis.com/response_code_class

the class of the http response code. This can be 200, 300, 400, 500 or 0. 0 indicates no response code was returned.

network.googleapis.com/loadbalancer/response_bytes_count

The number of bytes sent from a load-balanced backend.

delta int64
pubsub.googleapis.com/subscription/config_updates_count

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

delta int64 pubsub.googleapis.com/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/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 pubsub.googleapis.com/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.

delta int64 pubsub.googleapis.com/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 pubsub.googleapis.com/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.

delta int64 pubsub.googleapis.com/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.

delta int64 pubsub.googleapis.com/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/delivery_type

Push delivery mechanism.

pubsub.googleapis.com/subscription/push_request_latencies

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

delta distribution pubsub.googleapis.com/response_code

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

pubsub.googleapis.com/delivery_type

Push delivery mechanism.

pubsub.googleapis.com/topic/config_updates_count

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

delta int64 pubsub.googleapis.com/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/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 pubsub.googleapis.com/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.

delta int64 pubsub.googleapis.com/response_code

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