El recommender de instancias con aprovisionamiento insuficiente te ayuda a detectar instancias que tienen un uso alto de memoria o CPU.
Luego, proporciona recomendaciones para optimizar la instancia.
En esta página, se describe cómo funciona este recomendador y cómo usarlo.
Cómo funciona
Cuando se detecta un uso alto de CPU o memoria, verás una recomendación para aumentar el tamaño de la instancia a fin de reducir el uso de memoria o CPU al máximo.
En la tarjeta Cambiar el tamaño de las instancias de Cloud SQL para mejorar el rendimiento, haz clic en Ver todo.
Haz clic en las instancias con la recomendación Cambiar el tamaño de la instancia de Cloud SQL.
gcloud
Para mostrar una lista de recomendaciones sobre instancias con aprovisionamiento insuficiente, ejecuta el comando gcloud recommender recommendations list de la siguiente manera:
gcloud recommender recommendations list \
--project=PROJECT_ID \
--location=LOCATION \
--recommender=google.cloudsql.instance.UnderprovisionedRecommender
Reemplaza lo siguiente:
PROJECT_ID: ID del proyecto
LOCATION: Es una región, como us-central1.
API
Para mostrar una lista de recomendaciones sobre las instancias con aprovisionamiento insuficiente mediante la API de Recomendaciones, llama al método recommendations.list de la siguiente manera:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.UnderprovisionedRecommender/recommendations
Reemplaza lo siguiente:
PROJECT_ID: ID del proyecto
LOCATION: Es una región, como us-central1.
Si el recomendador detecta instancias con aprovisionamiento insuficiente, las enumera en una tabla. En cada fila, se muestra el nombre de la instancia, una recomendación breve, el tipo de máquina actual, el tipo de máquina recomendado, la ubicación y la última fecha de actualización.
Visualiza las estadísticas y las recomendaciones detalladas
Console
Para obtener estadísticas y recomendaciones detalladas sobre una instancia con aprovisionamiento insuficiente mediante la consola de Google Cloud, haz clic en el botón de recomendaciones en la lista de instancias.
gcloud
Para ver estadísticas y recomendaciones detalladas sobre las instancias con aprovisionamiento insuficiente mediante gcloud, ejecuta el comando gcloud recommender insights list de la siguiente manera:
gcloud recommender insights list \
--project=PROJECT_ID \
--location=LOCATION \
--insight-type=google.cloudsql.instance.INSIGHT_TYPE
Reemplaza lo siguiente:
PROJECT_ID: ID del proyecto
LOCATION: Es una región, como us-central1.
INSIGHT_TYPE: es el ID del tipo de estadística es UnderprovisionedCpuUsageInsight, UnderprovisionedMemoryUsageInsight o OomProbabilityInsight, que proporciona estadísticas sobre el uso de CPU, memoria y probabilidad de OOM, respectivamente.
API
Para ver estadísticas y recomendaciones detalladas sobre las instancias con aprovisionamiento insuficiente mediante la API de Recomendaciones, llama al método insights.list de la siguiente manera:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT-ID/locations/LOCATION/insightTypes/google.cloudsql.instance.INSIGHT_TYPE/insights
Reemplaza lo siguiente:
PROJECT_ID: ID del proyecto
LOCATION: Es una región, como us-central1.
INSIGHT_TYPE: es el ID del tipo de estadística, como UnderprovisionedCpuUsageInsight, UnderprovisionedMemoryUsageInsight o OomProbabilityInsight, que proporciona estadísticas sobre el uso de CPU, memoria y probabilidad de OOM, respectivamente.
En la siguiente tabla, se enumeran las estadísticas y recomendaciones que el recomendador de instancias con aprovisionamiento insuficiente de Cloud SQL podría generar para ayudarte a evitar cuellos de botella por el uso elevado de memoria y CPU y a minimizar la probabilidad de eventos de memoria insuficiente.
Los subtipos se pueden ver en los resultados de gcloud y la API.
Estadísticas
Recomendaciones
Según las tendencias de uso de CPU actuales, la instancia se marca como con alto uso de CPU.
Subtipo: HIGH_CPU_UTILIZATION
Aumenta el tamaño de la CPU o reduce el uso de CPU.
Subtipo: CHANGE_INSTANCE_SIZE
Según las tendencias de uso de memoria actuales, la instancia se marca como que tiene uso de memoria alto.
Subtipo: HIGH_MEMORY_UTILIZATION.
Aumenta el tamaño de la memoria o reduce el uso de memoria.
Subtipo: CHANGE_INSTANCE_SIZE
Según las tendencias de uso actuales, la instancia se marca como en riesgo de incurrir en eventos de OOM futuros.
Subtipo: HIGH_OOM_PROBABILITY.
Aumenta el tamaño de la memoria o reduce el uso de memoria.
Subtipo: CHANGE_INSTANCE_SIZE
Aplicar recomendaciones
Evalúa las recomendaciones con cuidado y realiza una de las siguientes acciones:
Para examinar la recomendación, haz clic en Ver instancia.
Aparecerá un banner en la parte superior de la página que proporciona una recomendación.
Para descartar la recomendación, de modo de restarle énfasis y que aparezca atenuada, haz clic en Descartar.
Para cerrar el panel sin aplicar ni descartar la recomendación, haz clic en Cancelar.
Optimiza el rendimiento de la instancia
Para optimizar el rendimiento de tu instancia, haz lo siguiente:
Si es necesario, edita la instancia para reducir las CPU virtuales o la memoria. Como alternativa, puedes cambiar a un tipo de máquina con menos CPU virtuales y más memoria. No es necesario que redimensiones la instancia de la manera exacta en que se recomienda. Usa tu criterio y cambia el tamaño según la forma en la que deseas aprovisionar la instancia.
Ten en cuenta que cuanto mayor sea el tamaño, mayor será la latencia operativa.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Reduce underprovisioned Cloud SQL instances\n\n\u003cbr /\u003e\n\nMySQL \\| [PostgreSQL](/sql/docs/postgres/recommender-underprovisioned \"View this page for the PostgreSQL database engine\") \\| [SQL Server](/sql/docs/sqlserver/recommender-underprovisioned \"View this page for the SQL Server database engine\")\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/mysql/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/mysql/optimize-high-memory-usage)\n\n- [Optimize high CPU usage](/sql/docs/mysql/optimize-cpu-usage)\n\n- [Create read replicas](/sql/docs/mysql/replication/create-replica).\n\n | **Caution:** This operation can lead to an increase in cost.\n\n\u003c!-- --\u003e\n\n- [Edit](/sql/docs/mysql/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/mysql/using-ood-recommender)\n- [Reduce idle Cloud SQL instances](/sql/docs/mysql/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)"]]
