This page describes the following types of Cloud SQL Enterprise Plus edition recommenders:
- Upgrade to Cloud SQL Enterprise Plus edition and enable data cache to improve read performance
- Upgrade to Cloud SQL Enterprise Plus edition with memory-optimized machine to improve performance
The following sections describe how these recommenders work and how to use them.
Pricing
The recommenders described on this page are all in the standard Recommender pricing tier.
Before you begin
Before you can view recommendations and insights, do the following:
- To get the permissions to view and work with insights and recommendations,
ensure that you have the required roles.
Tasks Roles View recommendations One of these roles: recommender.cloudsqlViewer
orcloudsql.viewer
.Apply recommendations One of these roles: recommender.cloudsqlAdmin
,cloudsql.editor
, orcloudsql.admin
. -
Enable the Recommender API.
Upgrade to Cloud SQL Enterprise Plus edition and enable data cache to improve read performance
The upgrade to Cloud SQL Enterprise Plus edition and enable data cache to improve read performance recommender helps you detect instances which are critical and whose cache hit rate is low.
The upgrade to Cloud SQL Enterprise Plus edition and enable data cache to improve read performance recommender analyzes instance metadata and metrics about cache hit rate. If the instance is a production instance and its cache hit rate is low, it is recommended to upgrade to Cloud SQL Enterprise Plus edition and enable the data cache to improve read performance. Recommendations are generated daily.
List instances that can be upgraded to Cloud SQL Enterprise Plus edition with enabling data cache to improve read performance recommendations
You can list upgrade to Cloud SQL Enterprise Plus edition with enabling data cache to improve read performance recommendations
using the Google Cloud console, gcloud CLI
, or the Recommender API.
Console
To list upgrade to Cloud SQL Enterprise Plus edition recommendations, follow these steps:
-
Go to the Cloud SQL Instances page.
On the Improve instance health by investigating issues and acting on recommendations banner, click Expand Details.
Alternatively, follow these steps:
-
Go to the Recommendation Hub. See also Find and apply recommendations with the Recommendations.
For more information, see Getting started with the Recommendation Hub.
In the All recommendations card, click Performance.
gcloud
To list upgrade to Cloud SQL Enterprise Plus edition with enabling data cache to improve read performance recommendations, run the
gcloud recommender recommendations list
command as follows:
gcloud recommender recommendations list \ --project=PROJECT_ID \ --location=LOCATION \ --recommender=google.cloudsql.instance.PerformanceRecommender \ --filter=recommenderSubtype=UPGRADE_TO_ENTERPRISE_PLUS_DATA_CACHE
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
API
To list upgrade to Cloud SQL Enterprise Plus edition with enabling data cache to improve read performance recommendations, call the
recommendations.list
method as follows:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
.
If the recommender detects instances that can be upgraded to Cloud SQL Enterprise Plus edition, they are listed in a table showing the instance name, a brief recommendation, the current machine type, the recommended machine type, the location, and the last refresh date.
View insights and detailed recommendations
You can view insights and detailed recommendations about instances that can be upgraded to Cloud SQL Enterprise Plus edition using the Google Cloud console, gcloud CLI
, or the Recommender API.
Console
Do one of the following:
- On the Performance Recommendations page, click the Performance recommendations card and then click Read intensive workload.
The recommendation panel appears, which contains insights and detailed recommendations for the instance.
- On the Instances page, click Read intensive workload.
The list of instances displays only those instances for which the recommendation applies.
gcloud
To view insights and detailed recommendations about an instance that can be upgraded, run the
gcloud recommender insights list
command as follows:
gcloud recommender insights list \ --project=PROJECT_ID \ --location=LOCATION \ --insight-type=google.cloudsql.instance.PerformanceInsight \ --filter=insightSubtype=READ_HEAVY_WORKLOAD
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
API
Call the insights.list
method as follows:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
A panel appears showing insights about metrics or information that the Insights highlight.
Apply recommendations
To implement this recommendation, do the following:
- To upgrade to Cloud SQL Enterprise Plus edition, click Read intensive workload in the Issues column. An Upgrade to Enterprise Plus edition window displays providing a recommendation. To proceed with an upgrade, click Edit > Upgrade. For more information on upgrading your instance, see Upgrade an instance to Cloud SQL Cloud SQL Enterprise Plus edition by using in-place upgrade. For more information on zero downtime, see data cache.
Upgrade to Cloud SQL Enterprise Plus edition with a memory-optimized machine to improve performance
The upgrade to Cloud SQL Enterprise Plus edition recommender provides the following benefits:
- Provides memory-optimized machine performance.
- Helps you detect instances critical to your workloads and detects when their memory-to-CPU utilization is high.
This recommender analyzes instance metadata and metrics about CPU and memory utilization. If the instance is a production instance with a high memory-to-CPU utilization ratio and has high memory pressure, it is recommended to upgrade to Cloud SQL Enterprise Plus edition with a memory-optimized machine to improve performance. Recommendations are generated daily.
You can list recommendations
using the Google Cloud console, gcloud CLI
, or the Recommender API.
Console
To list upgrade to Cloud SQL Enterprise Plus edition recommendations, follow these steps:
-
Go to the Cloud SQL Instances page.
On the Improve instance health by investigating issues and acting on recommendations banner, click Expand Details.
Alternatively, follow these steps:
-
Go to the Recommendation Hub. See also Find and apply recommendations with the Recommendations.
For more information, see Getting started with the Recommendation Hub.
In the All recommendations card, click Performance.
gcloud
To list instances recommended for upgrade, run the
gcloud recommender recommendations list
command as follows:
gcloud recommender recommendations list \ --project=PROJECT_ID \ --location=LOCATION \ --recommender=google.cloudsql.instance.PerformanceRecommender \ --filter=recommenderSubtype=SQLSERVER_UPGRADE_TO_ENTERPRISE_PLUS_MEMORY_OPTIMIZED
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
API
To list instances recommended for upgrade, call the
recommendations.list
method as follows:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
.
If the recommender detects instances that can be upgraded to Cloud SQL Enterprise Plus edition, they are listed in a table showing the instance name, a brief recommendation, the current machine type, the recommended machine type, the location, and the last refresh date.
View insights and detailed recommendations
You can view insights and detailed recommendations about instances that can be
upgraded to Cloud SQL Enterprise Plus edition using the Google Cloud console, gcloud CLI
,
or the Recommender API.
Console
Do one of the following:
- On the Performance Recommendations page, click the Performance recommendations card and then click Memory nearing tier limit.
The recommendation panel appears, which contains insights and detailed recommendations for the instance.
- On the Instances page, click Memory nearing tier limit.
The list of instances displays only those instances for which the recommendation applies.
gcloud
To view insights and detailed recommendations about an instance that can be upgraded, run the
gcloud recommender insights list
command as follows:
gcloud recommender insights list \ --project=PROJECT_ID \ --location=LOCATION \ --insight-type=google.cloudsql.instance.PerformanceInsight \ --filter=insightSubtype="SQLSERVER_HIGH_LAZY_WRITES_HIGH_MEMORY_TO_CPU_UTILIZATION_RATIO OR SQLSERVER_HIGH_FREE_LIST_STALLS_HIGH_MEMORY_TO_CPU_UTILIZATION_RATIO"
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
API
Call the insights.list
method as follows:
GET https://recommender.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights
Replace the following:
PROJECT_ID
: your project IDLOCATION
: a region where your instances are located, such asus-central1
A panel appears showing insights about metrics or information that the insights highlight.
Apply recommendations
To implement this recommendation, do the following:
- To upgrade to Cloud SQL Enterprise Plus edition, click Memory nearing tier limit in the Issues column. An Upgrade to Enterprise Plus edition window displays providing a recommendation. To proceed with an upgrade, click Edit > Upgrade. For more information on upgrading your instance, see Upgrade an instance to Cloud SQL Cloud SQL Enterprise Plus edition by using in-place upgrade.