Ensure database availability by increasing cluster storage quota
Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to ensure database availability and avoid instance downtime by increasing the cluster storage quota in AlloyDB, how the cluster storage quota recommender works, and how you can use it.
The AlloyDB cluster storage quota recommender helps you detect productions clusters which are at risk of hitting the storage quota.
The AlloyDB cluster storage quota recommender analyzes certain storage related metrics and computes the latest storage quota utilization by the cluster. If the utilization is over a certain threshold, the cluster receives a recommendation to increase the storage quota.
Recommendations are generated daily.
Before you begin
Before you can view recommendations and insights, do the following:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.alloydb.cluster.ReliabilityRecommender/recommendations?filter=recommenderSubtype=INCREASE_CLUSTER_STORAGE_QUOTA
Replace the following:
PROJECT_ID: Your project ID.
LOCATION: A region where your clusters are located, such as us-central1.
View insights and detailed recommendations
You can view insights and detailed recommendations about clusters
that require increasing cluster storage quota using the Google Cloud console,
gcloud CLI, or the Recommender API.
To view insights and detailed recommendations, follow these steps:
Console
On the Clusters page, click the Nearing storage quota recommendation for an instance in the Issues column.
The recommendation panel appears, which contains insights and detailed recommendations.
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.alloydb.cluster.ReliabilityInsight/insights?filter=insightSubtype=HIGH_STORAGE_UTILIZATION
Replace the following:
PROJECT_ID: Your project ID.
LOCATION : A region where your clusters are located, for example, us-central1.
Apply the recommendation
Evaluate the recommendation carefully and do the following:
Console
To implement the recommendation, do the following:
Click Edit Quota for your cluster. This automatically displays the IAM & Admin >
Quotas & System Limits window.
Select the entry for your cluster, and click Edit Quotas.
In the Edit quota window, input the appropriate quota value as per the recommendation.
Fill in the required details in the Request description field and click Done.
[[["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 page outlines how to use the AlloyDB cluster storage quota recommender to prevent database downtime by managing storage capacity.\u003c/p\u003e\n"],["\u003cp\u003eThe AlloyDB cluster storage quota recommender analyzes storage metrics daily and suggests increasing the storage quota for clusters nearing their capacity.\u003c/p\u003e\n"],["\u003cp\u003eYou can list and view detailed recommendations for increasing cluster storage quotas using the Google Cloud console, \u003ccode\u003egcloud CLI\u003c/code\u003e, or the Recommender API.\u003c/p\u003e\n"],["\u003cp\u003eTo apply a storage quota increase recommendation, navigate to the IAM & Admin Quotas section, edit the relevant quota, and submit the request.\u003c/p\u003e\n"]]],[],null,["# Ensure database availability by increasing cluster storage quota\n\nThis page describes how to ensure database availability and avoid instance downtime by increasing the cluster storage quota in AlloyDB, how the cluster storage quota [recommender](/recommender/docs/overview) works, and how you can use it.\n\nThe AlloyDB cluster storage quota [recommender](/recommender/docs/overview) helps you detect productions clusters which are at risk of hitting the storage quota.\n\nThe AlloyDB cluster storage quota recommender analyzes certain storage related metrics and computes the latest storage quota utilization by the cluster. If the utilization is over a certain threshold, the cluster receives a recommendation to increase the storage quota.\nRecommendations are generated daily.\n\nBefore you begin\n----------------\n\nBefore you can view recommendations and insights, do the following:\n\n- Ensure that you [enable the Recommender API](/recommender/docs/enabling).\n\n- To get the permissions to view and work with insights and recommendations,\n ensure that you have the required [Identity and Access Management (IAM) roles](/iam/docs/understanding-roles#cloud-alloydb-roles).\n\n \u003cbr /\u003e\n\n See [Grant access to other users](/alloydb/docs/user-grant-access) for more information.\n\nList the recommendations\n------------------------\n\nYou can list the cluster storage quota recommendations\nusing the Google Cloud console, `gcloud CLI`, or the Recommender API. \n\n### Console\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n\n For more information, see\n [Find recommendations with Recommendation Hub](/recommender/docs/recommendation-hub/identify-configuration-problems).\n2. In the **Availability configuration** card, click **Nearing storage quota**.\n\n A list of clusters to which the **Nearing storage quota** recommendation applies is displayed.\n\n### gcloud CLI\n\nTo list the cluster storage quota recommendations using gcloud CLI, run the [`gcloud recommender recommendations list`](/sdk/gcloud/reference/recommender/recommendations/list) command as follows: \n\n```\ngcloud recommender recommendations list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--recommender=google.alloydb.cluster.ReliabilityRecommender \\\n--filter=recommenderSubtype=INCREASE_CLUSTER_STORAGE_QUOTA\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: Your project ID.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: A region where your clustres are located, such as `us-central1`.\n\n### API\n\nTo list cluster storage quota recommendations using the [Recommendations API](/recommender/docs/using-api), call the\n[`recommendations.list`](/recommender/docs/reference/rest/v1/projects.locations.recommenders.recommendations/list)\nmethod as follows: \n\n```\nGET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.alloydb.cluster.ReliabilityRecommender/recommendations?filter=recommenderSubtype=INCREASE_CLUSTER_STORAGE_QUOTA\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: Your project ID.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: A region where your clusters are located, such as `us-central1`.\n\nView insights and detailed recommendations\n------------------------------------------\n\nYou can view insights and detailed recommendations about clusters\nthat require increasing cluster storage quota using the Google Cloud console,\n`gcloud CLI`, or the Recommender API.\n\nTo view insights and detailed recommendations, follow these steps: \n\n### Console\n\nOn the **Clusters** page, click the **Nearing storage quota** recommendation for an instance in the **Issues** column.\nThe recommendation panel appears, which contains insights and detailed recommendations.\n\n### gcloud CLI\n\nRun the [`gcloud recommender insights list`](/sdk/gcloud/reference/recommender/insights/list) command as follows: \n\n```\n\ngcloud recommender insights list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--insight-type=google.alloydb.cluster.ReliabilityInsight \\\n--filter=insightSubtype=HIGH_STORAGE_UTILIZATION\n\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: Your project ID.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e : A region where your clusters are located, for example, `us-central1`.\n\n### API\n\nCall the [`insights.list`](/recommender/docs/reference/rest/v1beta1/projects.locations.insightTypes.insights/list) method as follows: \n\n```\nGET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.alloydb.cluster.ReliabilityInsight/insights?filter=insightSubtype=HIGH_STORAGE_UTILIZATION\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: Your project ID.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e : A region where your clusters are located, for example, `us-central1`.\n\nApply the recommendation\n------------------------\n\nEvaluate the recommendation carefully and do the following: \n\n### Console\n\nTo implement the recommendation, do the following:\n\n1. Click **Edit Quota** for your cluster. This automatically displays the **IAM \\& Admin** \\\u003e **Quotas \\& System Limits** window.\n2. Select the entry for your cluster, and click **Edit Quotas**.\n3. In the **Edit quota** window, input the appropriate quota value as per the recommendation.\n4. Fill in the required details in the **Request description** field and click **Done**.\n5. Click **Submit Request**.\n\nWhat's next\n-----------\n\n- [Google Cloud recommenders](/recommender/docs/recommenders)"]]
