Prevent data loss for your instance by increasing backup retention

MySQL   |  PostgreSQL   |  SQL Server

Preview — Gemini in Databases

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This page describes the Cloud SQL increase backup retention recommender which helps you detect instances which are critical and have a risk of data loss.

The Cloud SQL increase backup retention recommender analyzes instance metadata. If the instance is a production instance, has automated backups enabled, and has less than 21 retained backups, it is recommended to increase its backup retention.

Recommendations are generated daily.

Important: This recommender is only available if you have enabled Gemini in Databases. For more information on enabling Gemini in Databases, see Set up Database Center.

Pricing

The Cloud SQL increase backup retention recommender is 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 Identity and Access Management (IAM) roles.

  Tasks	Roles
  View recommendations	One of these roles: recommender.cloudsqlViewer or cloudsql.viewer.
  Apply recommendations	One of these roles: recommender.cloudsqlAdmin, cloudsql.editor, or cloudsql.admin.

  For more information about IAM roles, see IAM basic and predefined roles reference and Manage access to projects, folders, and organizations.

• Enable the Recommender API.

  Enable the API

List reliability recommendations for increasing backup retention

You can list the increase backup retention recommendations by using the Google Cloud console, gcloud CLI, or the Recommender API.

Console

To list increase backup retention recommendations using the Google Cloud console, follow these steps:

1. Go to the Recommendation Hub.

   Go to the Recommendation Hub

   For more information, see Getting started with Recommendation Hub.

2. In the Increase Cloud SQL instance reliability card, click View all.

3. Select instances with the Increase backup retention recommendation.

gcloud CLI

To list increase backup retention recommendations using gcloud CLI, run the gcloud recommender recommendations list command as follows:

gcloud recommender recommendations list \
--project=PROJECT_ID \
--location=LOCATION \
--recommender=google.cloudsql.instance.ReliabilityRecommender \
--filter=recommenderSubtype=INCREASE_BACKUP_RETENTION

Replace the following:

• PROJECT_ID: Your project ID.
• LOCATION: A region where your instances are located, such as us-central1.

API

To list increase backup retention recommendations using the Recommendations API, call the recommendations.list method as follows:

GET https://recommender.googleapis.com/v1/projects/PROJECT-ID/locations/LOCATION/recommenders/google.cloudsql.instance.ReliabilityRecommender/recommendations

Replace the following:

• PROJECT_ID: Your project ID.
• LOCATION: A region where your instances are located, such as us-central1.

If the recommender detects instances for the increase backup retention recommendation, it lists them in a table. Each row shows 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 require increasing their backup retention using the Google Cloud console, gcloud CLI, or the Recommender API.

Console

To view insights and detailed recommendations about instances that require increasing their backup retention, click the recommendation link in the list of instances.

gcloud CLI

To view insights and detailed recommendations about instances that require increasing their backup retention, run the gcloud recommender insights list command as follows:

gcloud recommender insights list \
--project=PROJECT-ID \
--location=LOCATION \
--insight-type=google.cloudsql.instance.ReliabilityInsight \
--filter=insightSubtype=CRITICAL_INSTANCE_INSUFFICIENT_BACKUP_RETENTION

Replace the following:

• PROJECT_ID: Your project ID.
• LOCATION: A region where your instances are located, such as us-central1.

API

To view insights and detailed recommendations about instances that require increasing their backup retention, use the Recommendations API, call the insights.list method as follows:

GET https://recommender.googleapis.com/v1/projects/PROJECT-ID/locations/LOCATION/insightTypes/google.cloudsql.instance.ReliabilityInsight/insights

Replace the following:

• PROJECT_ID: Your project ID.
• LOCATION: A region where your instances are located, such as us-central1.

Apply recommendation

To implement this recommendation, do the following:

• To increase backup retention:

  1. Click Increase backup retention in the Issues column. An Increase backup retention window displays providing a recommendation.

  2. Click Edit instance > Data protection > Number of backups.

     For more information, see Automated backup and transaction log retention.

What's next

• Google Cloud recommenders
• About database observability