Set up alerts for paused backup plans

Autopilot Standard

This page describes how to set up alerts for the paused backup plans based on the logs viewable from the Logs Explorer.

Backup plans can be paused automatically or manually as listed in the Pause a backup schedule. To receive notifications when critical backup plans are paused, it's important to set up alerts. This procedure is similar to configuring alerts for failed backups. For instructions, see Set up alerts for failed backups.

Before you begin

Before setting up an alert policy, ensure you have an appropriate notification channel.

Create an alert for paused backup plans

To create general log-based alert policies, see Configure log-based alerts. Or, to create an alert policy specifically for Backup for GKE paused backup plans:

Go to the Logs Explorer page.

Go to Logs Explorer
Enter the following filter criteria in the Query pane:
```
logName="projects/PROJECT_ID/logs/gkebackup.googleapis.com%2Fbackup_plan_change"
resource.type="gkebackup.googleapis.com/BackupPlan"
resource.labels.backup_plan_id=BACKUP_PLAN"
resource.labels.location="LOCATION"
jsonPayload.inputBackupPlan.backupSchedule.paused="true"
```
Replace the following:
- PROJECT_ID: the ID of your Google Cloud project.
- BACKUP_PLAN: the name of the backup plan for which you want to generate alerts.
- LOCATION: the compute region of the backup plan for which you want to generate alerts. For example, us-central1.
  
  Note: If you want to set up alerts for any backup plans across all locations, then you can omit the resource.labels.backup_plan_id and resource.labels.location fields from the filter.
Click Run query to validate the query.
In the Query results toolbar, expand the Actions menu and select Create log alert.
In the Alert details pane, enter a name for your alerting policy in the Alert Policy Name field. For example, alert for paused backup plan.
Select an option from the Policy severity level drop-down. Incidents and notifications display the severity level. We recommend setting the severity level to Critical.
Enter a description for your alerting policy. You can also include information that might help the recipient of a notification diagnose the problem. For information about how you can format and refine the content of this field, see Using Markdown and variables in documentation templates.
Click Next.
Set the Time between notifications and Incident autoclose duration. We suggest setting notification to one day and autoclose duration to seven days.

Note: A notification is only triggered when a backup plan status changes to paused. A single status change will generate a single notification. If the backup plan becomes active and then pauses again, a new notification will be sent only after 24 hours have passed since the previous notification.
Click Next.
Select one or more notification channels for your alerting policy.
Click Save.

After you save the policy, you receive alerts to your notification channels whenever a backup plan matching your filter is paused.