Mit dem Recommender für unterdimensionierte Instanzen können Sie Instanzen mit einer hohen CPU-Auslastung und/oder Speichernutzung erkennen.
Sie erhalten dann Empfehlungen zur Optimierung der Instanz.
Auf dieser Seite wird beschrieben, wie dieser Recommender funktioniert und wie er verwendet wird.
Funktionsweise
Wenn eine hohe CPU-Auslastung und/oder Speichernutzung erkannt wurde, wird eine Empfehlung angezeigt, die Größe Ihrer Instanz zu erhöhen, um die CPU- und/oder Speichernutzung zu verringern.
Preise
Der Recommender für unterdimensionierte Instanzen befindet sich in der Recommender-Preisstufe „Standard“.
Hinweis
Bevor Sie Empfehlungen und Informationen aufrufen können, müssen Sie Folgendes tun:
Prüfen Sie, ob Sie die erforderlichen Rollen mit den benötigten Berechtigungen zum Aufrufen und Umsetzen von Informationen und Empfehlungen haben.
Aufgaben
Rollen
Empfehlungen aufrufen
Eine der folgenden Rollen: recommender.cloudsqlViewer oder cloudsql.viewer.
Empfehlungen übernehmen
Eine der folgenden Rollen: recommender.cloudsqlAdmin, cloudsql.editor oder cloudsql.admin.
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.UnderprovisionedRecommender/recommendations
Dabei gilt:
PROJECT_ID: Ihre Projekt-ID.
LOCATION: eine Region, z. B. us-central1
Wenn der Recommender unterdimensionierte Instanzen erkennt, listet er diese in einer Tabelle auf. Jede Zeile enthält den Instanznamen, eine kurze Empfehlung, den aktuellen Maschinentyp, den empfohlenen Maschinentyp, den Standort und das letzte Aktualisierungsdatum.
Informationen und detaillierte Empfehlungen anzeigen
Console
Wenn Sie mit derGoogle Cloud Console Informationen und detaillierte Empfehlungen zu einer unterdimensionierten Instanz aufrufen möchten, klicken Sie auf die Schaltfläche „Empfehlung“ in der Liste der Instanzen.
gcloud
Um Informationen und detaillierte Empfehlungen zu unterdimensionierten Instanzen mithilfe von gcloud zu erhalten, führen Sie den Befehl gcloud recommender insights list so aus:
gcloud recommender insights list \
--project=PROJECT_ID \
--location=LOCATION \
--insight-type=google.cloudsql.instance.INSIGHT_TYPE
Dabei gilt:
PROJECT_ID: Ihre Projekt-ID.
LOCATION: eine Region, z. B. us-central1
INSIGHT_TYPE: de ID des Informationstyps ist UnderprovisionedCpuUsageInsight, UnderprovisionedMemoryUsageInsight oder OomProbabilityInsight, der jeweils Informationen zur CPU-Auslastung, zum Arbeitsspeicher oder zur OOM-Wahrscheinlichkeit (Out of Memory, nicht genügend Arbeitsspeicher) liefert.
API
Um Informationen und detaillierte Empfehlungen zu unterdimensionierten Instanzen mithilfe der Recommendations API aufzurufen, rufen Sie die Methode insights.list so auf:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/insightTypes/google.cloudsql.instance.INSIGHT_TYPE/insights
Dabei gilt:
PROJECT_ID: Ihre Projekt-ID.
LOCATION: eine Region, z. B. us-central1
INSIGHT_TYPE: die ID des Informationstyps als UnderprovisionedCpuUsageInsight, UnderprovisionedMemoryUsageInsight oder OomProbabilityInsight, der jeweils Informationen zur CPU-Auslastung, zum Arbeitsspeicher oder zur OOM-Wahrscheinlichkeit liefert.
In der folgenden Tabelle sind die Informationen und Empfehlungen aufgeführt, die der Recommender für unterdimensionierte Cloud SQL-Instanzen generieren kann, um Engpässe durch hohe CPU-Auslastung und Speichernutzung zu vermeiden und die Wahrscheinlichkeit von Ereignissen aufgrund mangelnden Arbeitsspeichers zu minimieren.
Die Untertypen werden in den Ergebnissen von gcloud und der API angezeigt.
Statistiken
Empfehlungen
Basierend auf aktuellen CPU-Auslastungstrends wird die Instanz als eine mit hoher CPU-Auslastung gekennzeichnet.
Untertyp: HIGH_CPU_UTILIZATION
Erhöhen Sie die CPU-Größe oder reduzieren Sie die CPU-Auslastung.
Untertyp: CHANGE_INSTANCE_SIZE
Basierend auf den aktuellen Trends der Arbeitsspeicherauslastung wird die Instanz als solche mit einer hohen Speichernutzung gekennzeichnet.
Untertyp: HIGH_MEMORY_UTILIZATION.
Erhöhen Sie die Speichergröße oder reduzieren Sie die Speichernutzung.
Untertyp: CHANGE_INSTANCE_SIZE
Basierend auf den aktuellen Nutzungstrends besteht das Risiko, dass auf der Instanz in Zukunft OOM-Ereignisse auftreten.
Untertyp: HIGH_OOM_PROBABILITY.
Erhöhen Sie die Speichergröße oder reduzieren Sie die Speichernutzung.
Untertyp: CHANGE_INSTANCE_SIZE
Empfehlungen übernehmen
Sehen Sie sich die Empfehlungen sorgfältig an und führen Sie einen der folgenden Schritte aus:
Klicken Sie zum Ansehen der Empfehlung auf Instanz aufrufen.
Oben auf der Seite wird ein Banner mit einer Empfehlung angezeigt.
Klicken Sie auf Schließen, um die Empfehlung zu verwerfen, sodass sie ausgegraut ist und grau angezeigt wird.
Klicken Sie auf Abbrechen, um das Feld zu schließen, ohne die Empfehlung zu übernehmen oder zu verwerfen.
Bearbeiten Sie die Instanz bei Bedarf, um die vCPUs oder den Arbeitsspeicher zu erhöhen. Alternativ können Sie zu einem Maschinentyp mit mehr vCPUs und mehr Arbeitsspeicher wechseln. Sie müssen die Größe der Instanz nicht genau nach Empfehlung anpassen. Ändern Sie die Größe der Instanz nach Ihrem Ermessen, basierend darauf, wie Sie die Instanz bereitstellen möchten.
Beachten Sie, dass die operative Latenz um so höher ist, je größer die Größe ist.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-19 (UTC)."],[],[],null,["# Reduce underprovisioned Cloud SQL instances\n\n\u003cbr /\u003e\n\n[MySQL](/sql/docs/mysql/recommender-underprovisioned \"View this page for the MySQL database engine\") \\| [PostgreSQL](/sql/docs/postgres/recommender-underprovisioned \"View this page for the PostgreSQL database engine\") \\| SQL Server\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\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\nThe underprovisioned instance [recommender](/recommender/docs/overview)\nhelps you detect instances that have high CPU and/or memory utilization.\nIt then provides recommendations for how to optimize the instance.\nThis page describes how this recommender works and how to use it.\n\nHow it works\n------------\n\nWhen there is high CPU and/or memory utilization detected, you see a recommendation to increase the size of your instance to reduce CPU and/or memory utilization at peak.\n| **Note:** Recommendations are generated daily.\n\nPricing\n-------\n\nThe underprovisioned instance recommender is in the Standard\n[Recommender pricing tier](/recommender/pricing).\n\nBefore you begin\n----------------\n\nBefore you can view recommendations and insights, do the following:\n\n- Ensure that you have the required [roles](/sql/docs/sqlserver/project-access-control#roles) so that you have permission to view and work with insights and recommendations.\n\n For more information about roles, see [understanding roles](/iam/docs/understanding-roles) and [granting IAM permissions](/iam/docs/granting-changing-revoking-access).\n-\n\n\n Enable the Recommender API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=recommender.googleapis.com)\n\nList underprovisioned instance recommendations\n----------------------------------------------\n\n### Console\n\nTo list recommendations about underprovisioned instances, follow these steps:\n\n1. Go to the **Cloud SQL Instances** page.\n\n [Go to Cloud SQL Instances](https://console.cloud.google.com/sql/instances)\n2. Click **View all** on the resize Cloud SQL instance recommender banner.\n\nAlternatively, follow these steps:\n\n1. Go to the **Recommendation Hub**.\n\n [Go to the Recommendation Hub](https://console.cloud.google.com/home/recommendations/)\n\n For more information, see\n [Getting started with Recommendation Hub](/recommender/docs/recommendation-hub/identify-configuration-problems).\n2. In the **Resize Cloud SQL instances to improve performance** card, click **View all**.\n\n3. Click the instances with the **Resize Cloud SQL instance** recommendation.\n\n### gcloud\n\nTo list recommendations about underprovisioned instances, run the\n[`gcloud recommender recommendations list`](/sdk/gcloud/reference/recommender/recommendations/list)\ncommand as follows: \n\n```\ngcloud recommender recommendations list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--recommender=google.cloudsql.instance.UnderprovisionedRecommender\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, such as `us-central1`.\n\n### API\n\nTo list recommendations about underprovisioned instances by using the\n[Recommendations API](/recommender/docs/using-api), call the\n[`recommendations.list`](/recommender/docs/reference/rest/v1beta1/projects.locations.recommenders.recommendations/list)\nmethod as follows: \n\n```\nGET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.UnderprovisionedRecommender/recommendations\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, such as `us-central1`.\n\nIf the recommender detects underprovisioned instances, it lists them in a\ntable. Each row shows the instance name, a brief recommendation, the current machine type,\nthe recommended machine type, the location, and the last refresh date.\n\nView insights and detailed recommendations\n------------------------------------------\n\n### Console\n\nTo view insights and detailed recommendations about an underprovisioned instance by using the\nGoogle Cloud console, click the recommendation button in the list of instances.\n\n### gcloud\n\nTo view insights and detailed recommendations about underprovisioned instances by using `gcloud`, run the\n[`gcloud recommender insights list`](/sdk/gcloud/reference/recommender/insights/list)\ncommand as follows: \n\n```\ngcloud recommender insights list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--insight-type=google.cloudsql.instance.INSIGHT_TYPE\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, such as `us-central1`.\n- \u003cvar translate=\"no\"\u003eINSIGHT_TYPE\u003c/var\u003e: The ID of the insight type is `UnderprovisionedCpuUsageInsight`, `UnderprovisionedMemoryUsageInsight`, or `OomProbabilityInsight`, which provide insights about CPU usage, memory, and OOM probability, respectively.\n\n### API\n\nTo view insights and detailed recommendations about underprovisioned instances by using the\n[Recommendations API](/recommender/docs/using-api), call the\n[`insights.list`](/recommender/docs/reference/rest/v1beta1/projects.locations.insightTypes.insights/list)\nmethod as follows: \n\n```\nGET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/insightTypes/google.cloudsql.instance.INSIGHT_TYPE/insights\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, such as `us-central1`.\n- \u003cvar translate=\"no\"\u003eINSIGHT_TYPE\u003c/var\u003e: The ID of the insight type as \\``UnderprovisionedCpuUsageInsight`, `UnderprovisionedMemoryUsageInsight`, or `OomProbabilityInsight`, which provide insights about CPU usage, memory, and OOM probability, respectively.\n\nThe following table lists the insights and recommendations that the Cloud SQL\nunderprovisioned instance recommender might generate to help you avoid bottlenecks from high CPU and memory\nusage and minimize the likelihood of out-of-memory events.\nThe subtypes are visible in the `gcloud` and API results.\n\nApply recommendations\n---------------------\n\nEvaluate the recommendations carefully and do any of the following:\n\n- To examine the recommendation, click **View instance**.\n\n A banner appears at the top of the page providing a recommendation.\n- To dismiss the recommendation so that it's de-emphasized and appears dimmed,\n click **Dismiss**.\n\n- To close the panel without applying or dismissing the recommendation, click\n **Cancel**.\n\n### Optimize the performance of your instance\n\nTo optimize your instance's performance, do the following:\n\n- [Optimize high memory usage](/sql/docs/sqlserver/optimize-high-memory-usage)\n\n- [Optimize high CPU usage](/sql/docs/sqlserver/optimize-cpu-usage)\n\n\u003c!-- --\u003e\n\n- [Edit](/sql/docs/sqlserver/edit-instance) the instance, if required, to\n increase the vCPUs or memory. Alternatively, switch to a machine type with more\n vCPUs and more memory. You don't need to rightsize the instance exactly as recommended. Use your\n judgement and resize based on how you intend to provision the instance.\n Keep in mind that the bigger the size, the greater the operational latency.\n\n | **Caution:** This operation can lead to an increase in cost. Additionally, it triggers a restart, which brings downtime to the instance.\n\nYou can also [export these recommendations to BigQuery](/recommender/docs/bq-export/export-recommendations-to-bq)\nand then examine them using [Looker Studio](/bigquery/docs/visualize-looker-studio) or [Looker](/bigquery/docs/looker).\n\nWhat's next\n-----------\n\n- [Monitor disk availability](/sql/docs/sqlserver/using-ood-recommender)\n- [Reduce idle Cloud SQL instances](/sql/docs/sqlserver/recommender-sql-idle)\n- [Blog: Maximize your Cloud ROI](https://cloud.google.com/blog/products/management-tools/active-assist-comes-to-google-cloud)\n- [Blog: Do more with less](https://cloud.google.com/blog/products/databases/reduce-cloud-sql-costs-with-optimizations-by-active-assist)\n- [Google Cloud recommenders](/recommender/docs/recommenders)"]]
