When you install the Cloud Monitoring and Cloud Logging agents on your VM instances, the agents transmit data for the metric types listed in this document to Monitoring. For information about choosing the right agent, see Ops Agent overview.
For a general explanation of the entries in the tables, including information about values like
DELTAandGAUGE, see Metric types.To chart or monitor metric types with values of type
STRING, you must use Monitoring Query Language (MQL), and you must convert the value into a numeric value. For information about MQL string-conversion methods, seeString.For information about the units used in the metric lists, see the
unitfield in theMetricDescriptorreference.For information about statements of the form “Sampled every x seconds” and “After sampling, data is not visible for up to y seconds”, see Additional information: metadata.
The resource-hierarchy level tells you if the metric is written at the project, organization, or folder level(s). When the level is not specified in the metric descriptor, the metric writes at the project level by default.
- The metric types in the table titled "agent" are free; the other types are chargeable. For pricing information, see Cloud Monitoring pricing summary.
- For information about the meaning of launch stages such as
GA(General Availability) andBETA(Preview), see Product launch stages.
Metrics from the Ops Agent and the Monitoring agent
The Monitoring agent has two entirely different implementations, one for Linux VMs and one for Windows VMs. The Ops Agent runs on both Linux and Windows VMs.
Differences in metric collection
The following table describes differences in the data ingested by the Ops Agent and the Monitoring agent.Metric type, omittingagent.googleapis.com |
Ops Agent (GA)† | Ops Agent (Preview)† | Monitoring agent |
|---|---|---|---|
cpu_state |
The possible values for Windows are
idle, interrupt, system and user. |
The possible values for Windows are
idle, interrupt, system and user. |
The possible values for Windows are
idle and used.
|
disk/bytes_used anddisk/percent_used |
Ingested with the full path in the device label;
for example, /dev/sda15.Not ingested for virtual devices like tmpfs and udev. |
Ingested without /dev in the path in the
device label; for example, sda15.Ingested for virtual devices like tmpfs and udev. |
Ingested without /dev in the path in the
device label; for example, sda15.Ingested for virtual devices like tmpfs and udev. |
Agent metrics
Metrics from the Monitoring agent and from the Logging agent running on VM instances in Google Cloud and AWS.
The following list was last generated at 2025-09-25 18:39:38 UTC. For more information about this process, see About the lists.
agent
Metrics from the default configuration for the Linux Monitoring agent. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/agent/. 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 |
api_request_count
GA
(project)
Monitoring Agent API Request Count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Count of API requests from the Monitoring agent. Linux only. Sampled every 60 seconds.
state:
Request state.
|
log_entry_count
GA
(project)
Logging Agent Log Entry Count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Count of log entries written by the Logging agent. Linux only. Sampled every 60 seconds.
response_code:
Numeric response code from both the gRPC and HTTP error spaces.
|
log_entry_retry_count
GA
(project)
Logging Agent Retried Log Entry Writes Count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Count of log-entry writes that were retried by the Logging agent. Linux only. Sampled every 60 seconds.
response_code:
Numeric response code from both the gRPC and HTTP error spaces.
|
memory_usage
GA
(project)
Monitoring Agent Memory Usage |
|
GAUGE, DOUBLE, By
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Memory in use by the Monitoring agent. Linux only. Sampled every 60 seconds. |
monitoring/point_count
GA
(project)
Monitoring Agent Metric Point Count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Count of metric points written by the agent to Cloud Monitoring. Linux only. Sampled every 60 seconds.
status:
gRPC response code.
|
request_count
GA
(project)
Logging Agent API Request Count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Count of API requests from the Logging agent. Linux only. Sampled every 60 seconds.
response_code:
Numeric response code from both the gRPC and HTTP error spaces.
|
streamspace_size
GA
(project)
Monitoring Agent Process Labels Size |
|
GAUGE, DOUBLE, By
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Estimated total size of process labels written by the Monitoring agent over a 24-hour window. Linux only. Sampled every 60 seconds. |
streamspace_size_throttling
GA
(project)
Monitoring Agent is Throttling Processes |
|
GAUGE, DOUBLE, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Whether the Monitoring agent is currently throttling process metrics. Linux only. Sampled every 60 seconds. |
uptime
GA
(project)
Monitoring/Logging Agent Uptime |
|
CUMULATIVE, INT64, s
aws_ec2_instance baremetalsolution.googleapis.com/Instance gae_app gce_instance k8s_container |
Uptime of Monitoring agent or Logging agent. Linux only. Sampled every 60 seconds.
version:
Agent version.
|
apache
Metrics from apache. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/apache/. 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 |
connections
GA
(project)
Open connections |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
The number of active connections currently attached to the HTTP server. Sampled every 60 seconds.
server_name:
The name of the Apache HTTP server.
|
idle_workers
GA
(project)
Idle workers |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
The number of idle workers currently attached to the HTTP server. Sampled every 60 seconds.
server_name:
The name of the Apache HTTP server.
|
request_count
GA
(project)
Requests |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Total requests serviced by the HTTP server. Sampled every 60 seconds.
server_name:
The name of the Apache HTTP server.
|
scoreboard
GA
(project)
Scoreboard |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
Apache HTTP server scoreboard values. Sampled every 60 seconds.
server_name:
The name of the Apache HTTP server.
state:
The scoreboard state name.
|
traffic
GA
(project)
Traffic |
|
CUMULATIVE, INT64, By
aws_ec2_instance gce_instance |
Total HTTP server traffic. Sampled every 60 seconds.
server_name:
The name of the Apache HTTP server.
|
cassandra
Metrics from cassandra. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/cassandra/. 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 |
cache/hits
GA
(project)
Hit count |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Key cache hit count for the table. Sampled every 60 seconds.
cache:
The name of the cache.
|
client_request/latency/50p
GA
(project)
Read latency |
|
GAUGE, DOUBLE, us
aws_ec2_instance gce_instance |
Latency of standard read requests. Sampled every 60 seconds.
operation:
The storage operation name.
|
client_request/latency/95p
GA
(project)
Read latency |
|
GAUGE, DOUBLE, us
aws_ec2_instance gce_instance |
Latency of standard read requests. Sampled every 60 seconds.
operation:
The storage operation name.
|
client_request/latency/99p
GA
(project)
Read latency |
|
GAUGE, DOUBLE, us
aws_ec2_instance gce_instance |
Latency of standard read requests. Sampled every 60 seconds.
operation:
The storage operation name.
|
client_request/latency/max
GA
(project)
Read latency |
|
GAUGE, DOUBLE, us
aws_ec2_instance gce_instance |
Latency of standard read requests. Sampled every 60 seconds.
operation:
The storage operation name.
|
column_family/compression_ratio
GA
(project)
Compression ratio |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
Current compression ratio for all SSTables. Sampled every 60 seconds. |
column_family/max_row_size
GA
(project)
Max row size |
|
GAUGE, DOUBLE, By
aws_ec2_instance gce_instance |
Size of the largest compacted row. Sampled every 60 seconds. |
commitlog_total_size
GA
(project)
Commit log size |
|
GAUGE, DOUBLE, By
aws_ec2_instance gce_instance |
Current data size of all commit log segments. Sampled every 60 seconds. |
completed_tasks
GA
(project)
Completed tasks |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Number of completed tasks in queue. Sampled every 60 seconds.
stage_name:
The name of the queue stage.
|
current_tasks
GA
(project)
Tasks |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
Number of tasks in queue with the given task status. Sampled every 60 seconds.
stage_name:
The name of the queue stage.
task_status:
The status of the task (pending, active).
|
dropped_message/dropped_count
GA
(project)
Dropped messages |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Total number of dropped messages for the mutation. Sampled every 60 seconds.
operation:
The storage operation name.
|
storage_service_exception_count
GA
(project)
Exceptions |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
The number of exceptions thrown by the storage operations. Sampled every 60 seconds. |
storage_service_load
GA
(project)
Storage load |
|
GAUGE, DOUBLE, By
aws_ec2_instance gce_instance |
Total disk space used for this node. Sampled every 60 seconds. |
couchdb
Metrics from couchdb. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/couchdb/. 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 |
average_request_time
GA
(project)
Request latency |
|
GAUGE, DOUBLE, ms
aws_ec2_instance gce_instance |
Average request time. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
httpd/bulk_request_count
GA
(project)
Bulk requests |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Bulk requests count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
httpd/request_count
GA
(project)
Requests |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Requests count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
httpd/request_method_count
GA
(project)
Request methods |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
HTTP request method count. Sampled every 60 seconds.
server_name:
The couchdb server name.
http_method:
An HTTP request method.
|
httpd/response_code_count
GA
(project)
Response codes |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
HTTP response status code count. Sampled every 60 seconds.
server_name:
The couchdb server name.
response_code:
An HTTP status code.
|
httpd/temporary_view_read_count
GA
(project)
Temp view reads |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Temporary view reads count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
httpd/view_read_count
GA
(project)
View reads |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
View reads count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
open_databases
GA
(project)
Open databases |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
Number of open databases. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
open_files
GA
(project)
Open files |
|
GAUGE, DOUBLE, 1
aws_ec2_instance gce_instance |
Number of open files. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
read_count
GA
(project)
Reads |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Database read count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
write_count
GA
(project)
Writes |
|
CUMULATIVE, INT64, 1
aws_ec2_instance gce_instance |
Database write count. Sampled every 60 seconds.
server_name:
The couchdb server name.
|
cpu
Metrics from the default configuration for the Ops Agent and the Monitoring agent. Compute Engine also reports similar metrics, but those come from the hypervisor rather than from inside the VM. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/cpu/. 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 |
load_15m
GA
(project)
CPU load (15m) |
|
GAUGE, DOUBLE, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Load average over the last 15 minutes. Linux only. Sampled every 60 seconds. |
load_1m
GA
(project)
CPU load (1m) |
|
GAUGE, DOUBLE, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Load average over the last 1 minute. Linux only. Sampled every 60 seconds. |
load_5m
GA
(project)
CPU load (5m) |
|
GAUGE, DOUBLE, 1
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Load average over the last 5 minutes. Linux only. Sampled every 60 seconds. |
usage_time
GA
(project)
CPU usage time (OS reported) |
|
CUMULATIVE, INT64, s{CPU}
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Total time the CPU spent in different states. This value is reported from inside the VM and can differ from `compute.googleapis.com/instance/cpu/usage_time`, which is reported by the hypervisor for the VM. Linux only. Sampled every 60 seconds.
cpu_number:
CPU number, for example, "0", "1", or "2". This label is only set with certain Monitoring configurations.
cpu_state:
CPU state, one of [idle, interrupt, nice, softirq, steal, system, user, wait].
|
utilization
GA
(project)
CPU utilization (OS reported) |
|
GAUGE, DOUBLE, %
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Percentage of the total CPU capacity spent in different states. This value is reported from inside the VM and can differ from `compute.googleapis.com/instance/cpu/utilization`, which is reported by the hypervisor for the VM. Sampled every 60 seconds.
cpu_number:
CPU number, for example, "0", "1", or "2". This label is only set with certain Monitoring configurations. Linux only.
cpu_state:
CPU state, one of [idle, interrupt, nice, softirq, steal, system, user, wait] on Linux, or [idle, interrupt, system, user] from Windows Ops Agent, or [idle, used] from Windows Monitoring agent.
|
disk
Metrics from the default configuration for the Ops Agent and the Monitoring agent. Launch stages of these metrics: GA
The "metric type" strings in this table must be prefixed
with agent.googleapis.com/disk/. 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 |
bytes_used
GA
(project)
Disk bytes used |
|
GAUGE, DOUBLE, By
aws_ec2_instance baremetalsolution.googleapis.com/Instance gce_instance |
Current number of disk bytes used by state and by partition. Summing the values of all states yields the total available disk space. Linux only. Sampled every 60 seconds.
device:
Device name.
state:
Type of usage, one of [free, used, reserved].
|
io_time
GA
(project)
Disk I/O time |
|
CUMULATIVE, INT64, ms
aws_ec2_instance baremetalsolution.googleapis.com/Instance | |