Stay organized with collections
Save and categorize content based on your preferences.
This document provides an overview of the local SSD quota per machine family. It
also describes how to update your monitoring dashboards, alerting policies, and
queries to use the quota metric for local SSD quota per machine family.
About the local SSD quota per machine family
Local SSD quota defines the total
combined size of local SSD disk partitions attached to VMs in a region
based on the machine type for each VM.
Metric and limits for the local SSD quota per machine family
Compute Engine local SSD quota is migrated to use the local SSD per machine
family quota metric. Use the quota metric
compute.googleapis.com/local_ssd_total_storage_per_vm_familyBETA
instead of compute.googleapis.com/local_ssd_total_storage to view
the quota usage and limits.
You can use Google Cloud console to
view your current quota values for the local SSD
quota per machine family for each region. The limit for local SSD quota per
machine family is calculated based on your existing limit and usage for local
SSD quota and any submitted Quota Increase Requests (QIRs).
In the gcloud CLI
and the API, this quota is referred as LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY.
Migrate Cloud Monitoring metrics
If you're using Cloud Monitoring to monitor the local SSD quota usage over
time and to receive alerts, you must manually update the Cloud Monitoring
dashboards, alerts, and queries to use the metric for local SSD quota per machine
family.
Monitor the usage of local SSD quota per machine family
To update a chart on the Cloud Monitoring dashboard to use the local SSD
quota per machine family metric, do the following:
In the Google Cloud console, select Monitoring.
In the navigation pane, select Dashboards.
Select the dashboard that you want to edit to use the per machine family
quota metric for local SSD.
Click Edit dashboard.
Select the chart you want to modify and click Edit from the More chart options
menu.
In the Resource & Metric section, click Select a metric.
Select Compute Location > Quota > Local SSD disk per VM family (GB). quota usage, and then click Apply.
Alternatively, select Local SSD disk per VM family (GB). quota limit to
create a chart to monitor the local SSD quota limit.
Optional: Specify a filter criteria for the chart:
Click add_boxAdd filter, and
then in the Label menu, select one of the following options:
limit_name: to filter local SSD quota usage across all machine types
in a region or a zone. Possible values are:
Create alerting policies for local SSD quota usage per machine family
To change an alerting policy that monitors the existing local SSD quota metric,
do the following:
In the Google Cloud console, select Monitoring.
In the navigation pane, select Alerting.
The Alerting page displays panes that list summary information, incidents,
and alerting policies.
Click the alerting policy that you want to change to use the new metric.
Click Copy to copy the alerting policy conditions to a new policy.
Click Select a metric and select Compute Location > Quota > Local SSD disk per VM family (GB). quota usage, and then click Apply.
Alternatively, select Local SSD disk per VM family (GB). quota limit to
create an alerting policy for the local SSD quota limit.
Optional: Edit the filter that corresponds to the metric that you want to migrate:
Click add_boxAdd filter, and
then in the Label menu, select one of the following options:
limit_name: to filter local SSD quota usage across all machine types
in a region or a zone. Possible values are:
To change the quota metric in an MQL-based alerting policy or a chart in
a dashboard, use the Query Editor and edit the query filter. See
Using the Query Editor.
Open the Query Editor and edit the following query:
Update the metric name and add a filter for the machine family as shown in the
following example:
[[["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-08-29 UTC."],[[["\u003cp\u003eThis document explains the new local SSD quota per machine family, which defines the total combined size of local SSD disk partitions attached to VMs based on their machine type in a region.\u003c/p\u003e\n"],["\u003cp\u003eThe local SSD quota metric is changing to \u003ccode\u003ecompute.googleapis.com/local_ssd_total_storage_per_vm_family\u003c/code\u003e and should be used to view quota usage and limits, instead of \u003ccode\u003ecompute.googleapis.com/local_ssd_total_storage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUsers can view their current local SSD quota per machine family limits in the Google Cloud console and the limit is calculated based on existing local SSD quota and any Quota Increase Requests.\u003c/p\u003e\n"],["\u003cp\u003eExisting Cloud Monitoring dashboards, alerts, and queries must be updated to use the new local SSD quota per machine family metric, either \u003ccode\u003eLocal SSD disk per VM family (GB).quota usage\u003c/code\u003e or \u003ccode\u003eLocal SSD disk per VM family (GB). quota limit\u003c/code\u003e, by modifying charts, filtering options and policy conditions.\u003c/p\u003e\n"],["\u003cp\u003eThe gcloud CLI and API reference the quota as \u003ccode\u003eLOCAL_SSD_TOTAL_GB_PER_VM_FAMILY\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# View and manage local SSD quota\n\n*** ** * ** ***\n\nThis document provides an overview of the local SSD quota per machine family. It\nalso describes how to update your monitoring dashboards, alerting policies, and\nqueries to use the quota metric for local SSD quota per machine family.\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nAbout the local SSD quota per machine family\n--------------------------------------------\n\n[Local SSD quota](/compute/resource-usage#disk_quota) defines the total\ncombined size of local SSD disk partitions attached to VMs in a region\nbased on the machine type for each VM.\n\nMetric and limits for the local SSD quota per machine family\n------------------------------------------------------------\n\nCompute Engine local SSD quota is migrated to use the local SSD per machine\nfamily quota metric. Use the quota metric\n`compute.googleapis.com/local_ssd_total_storage_per_vm_family`^BETA^\ninstead of `compute.googleapis.com/local_ssd_total_storage` to view\nthe quota usage and limits.\n\nYou can use Google Cloud console to\n[view your current quota values](/docs/quotas/view-manage) for the local SSD\nquota per machine family for each region. The limit for local SSD quota per\nmachine family is calculated based on your existing limit and usage for local\nSSD quota and any submitted Quota Increase Requests (QIRs).\n\nIn the gcloud CLI\nand the API, this quota is referred as `LOCAL_SSD_TOTAL_GB_PER_VM_FAMILY`.\n\nMigrate Cloud Monitoring metrics\n--------------------------------\n\nIf you're using Cloud Monitoring to monitor the local SSD quota usage over\ntime and to receive alerts, you must manually update the Cloud Monitoring\ndashboards, alerts, and queries to use the metric for local SSD quota per machine\nfamily.\n\n### Monitor the usage of local SSD quota per machine family\n\nTo update a chart on the Cloud Monitoring dashboard to use the local SSD\nquota per machine family metric, do the following:\n\n1. In the Google Cloud console, select **Monitoring**.\n\n2. In the navigation pane, select **Dashboards**.\n\n3. Select the dashboard that you want to edit to use the per machine family\n quota metric for local SSD.\n\n4. Click **Edit dashboard**.\n\n5. Select the chart you want to modify and click **Edit** from the **More chart options**\n menu.\n\n6. In the **Resource \\& Metric** section, click **Select a metric**.\n\n7. Select **Compute Location \\\u003e Quota \\\u003e Local SSD disk per VM family (GB). quota usage** , and then click **Apply** .\n Alternatively, select **Local SSD disk per VM family (GB). quota limit** to\n create a chart to monitor the local SSD quota limit.\n\n8. Optional: Specify a filter criteria for the chart:\n\n 1. Click add_box **Add filter** , and\n then in the **Label** menu, select one of the following options:\n\n - **limit_name**: to filter local SSD quota usage across all machine types\n in a region or a zone. Possible values are:\n\n - `LOCAL-SSD-TOTAL-GB-PER-VM-FAMILY-per-project-region`\n - `LOCAL-SSD-TOTAL-GB-PER-VM-FAMILY-per-project-zone`\n\n - **vm_family** : to filter local SSD quota usage for a specific machine\n family such as `N1`,`N2D`, and `C1`. See [Local SSDs and supported machine types](/compute/docs/disks#localssds).\n\n 2. Click **Done** to save changes.\n\n9. Click **Close editor**.\n\n### Create alerting policies for local SSD quota usage per machine family\n\nTo change an alerting policy that monitors the existing local SSD quota metric,\ndo the following:\n\n1. In the Google Cloud console, select **Monitoring**.\n\n2. In the navigation pane, select **Alerting**.\n The Alerting page displays panes that list summary information, incidents,\n and alerting policies.\n\n3. Click the alerting policy that you want to change to use the new metric.\n\n4. Click **Copy** to copy the alerting policy conditions to a new policy.\n\n5. Click **Select a metric** and select **Compute Location \\\u003e Quota \\\u003e Local SSD disk per VM family (GB). quota usage** , and then click **Apply** .\n Alternatively, select **Local SSD disk per VM family (GB). quota limit** to\n create an alerting policy for the local SSD quota limit.\n\n6. Optional: Edit the filter that corresponds to the metric that you want to migrate:\n\n 1. Click add_box **Add filter** , and\n then in the **Label** menu, select one of the following options:\n\n - **limit_name**: to filter local SSD quota usage across all machine types\n in a region or a zone. Possible values are:\n\n - `LOCAL-SSD-TOTAL-GB-PER-VM-FAMILY-per-project-region`\n - `LOCAL-SSD-TOTAL-GB-PER-VM-FAMILY-per-project-zone`\n\n - **vm_family** : to filter local SSD quota usage for a specific machine\n family such as `N1`,`N2D`, and `C1`. See [Local SSDs and supported machine types](/compute/docs/disks#localssds).\n\n 2. Click **Done** to save changes in the filter.\n\n7. Click **Create policy**.\n\n### Update Cloud Monitoring queries\n\nTo change the quota metric in an MQL-based alerting policy or a chart in\na dashboard, use the Query Editor and edit the query filter. See\n[Using the Query Editor](/monitoring/mql/query-editor).\n\nOpen the Query Editor and edit the following query:\n\nUpdate the metric name and add a filter for the machine family as shown in the\nfollowing example:"]]
