Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to monitor resources such as CPU, disk, and network used
by Cloud Workstations.
Overview
Cloud Workstations uses
Container-Optimized OS
to back virtual machines (VMs), which are integrated with Cloud Monitoring by
default. The VMs backing workstations are also
labeled
to make them identifiable in Cloud Monitoring.
To view the metrics for the VMs backing your workstations:
Ensure that you have the Metrics Viewer
IAM role (roles/roles/monitoring.viewer).
Navigate to Select a metric and select the metrics that you want to
display. For example, select VM Instance > Instance > CPU Usage > Apply.
To view metrics for the workstations that you are interested in, filter the
VM instance by workstation_cluster_id, workstation_location,
workstation_id, and workstation_config_id.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud Workstations resource monitoring\n\nThis page describes how to monitor resources such as CPU, disk, and network used\nby Cloud Workstations.\n\nOverview\n--------\n\nCloud Workstations uses\n[Container-Optimized OS](/container-optimized-os/docs/concepts/features-and-benefits)\nto back virtual machines (VMs), which are integrated with Cloud Monitoring by\ndefault. The VMs backing workstations are also\n[labeled](/workstations/docs/label-resources#cloud-workstations-resource-labels)\nto make them identifiable in Cloud Monitoring.\n\nTo view the metrics for the VMs backing your workstations:\n\n1. Ensure that you have the [Metrics Viewer](/monitoring/access-control#monitoring_roles)\n IAM role (`roles/roles/monitoring.viewer`).\n\n2. Go to Cloud Monitoring Metrics explorer:\n\n [Go to\n **Metrics explorer**](https://console.cloud.google.com/monitoring/metrics-explorer)\n\n \u003cbr /\u003e\n\n3. Navigate to **Select a metric** and select the metrics that you want to\n display. For example, select **VM Instance** \\\u003e **Instance** \\\u003e **CPU Usage** \\\u003e **Apply**.\n\n4. To view metrics for the workstations that you are interested in, filter the\n VM instance by `workstation_cluster_id`, `workstation_location`,\n `workstation_id`, and `workstation_config_id`.\n\nFor a full metrics list, see [Metrics from\nCompute Engine](/monitoring/api/metrics_gcp_c#gcp-compute).\n\nFor more about using Metrics explorer, see [Create charts with Metrics\nExplorer](/monitoring/charts/metrics-explorer).\n| **Note:** The monitoring agent monitors the VM---not the Docker containers hosted on the Container-Optimized OS VM. Customizing reported metrics for the built-in agent is not supported.\n\nWhat's next\n-----------\n\n- Learn more about [Cloud Monitoring metrics\n dashboards](/monitoring/dashboards).\n- Learn more about [Container-Optimized OS\n Monitoring](/container-optimized-os/docs/how-to/monitoring#viewing_the_collected_metrics)."]]
