此页面由 Cloud Translation API 翻译。

为已存入保险柜的资源配置基于日志的提醒

本页介绍了如何在 Google Cloud 控制台的 Logs Explorer 页面中为已存入保险柜的资源配置基于日志的提醒。

日志浏览器页面将引导您完成以下步骤来创建和修改基于日志的提醒：

提供提醒的名称和说明。
选择您想要接收通知的日志。
设置通知之间的时间间隔。
设置自动关闭突发事件的时间。
指定要通知的人员。

您可以为以下作业类别配置提醒：SCHEDULED_BACKUP、ON_DEMAND_BACKUP 和 RESTORE。您还可以为作业状态设置提醒：SUCCESSFUL、FAILED、SKIPPED 和 RUNNING。

您可以配置一个或多个通知渠道（例如 Google Chat、电子邮件、短信或聊天程序渠道），以便在出现提醒时接收通知。有关说明，请参阅创建和管理通知渠道。

准备工作

为基于日志的提醒政策分配权限。

创建基于日志的提醒

如需接收提醒，您需要拥有通知渠道。您可以在创建提醒之前或创建提醒期间创建通知渠道。

按照以下说明创建基于日志的提醒。

在 Google Cloud 控制台中，前往 Logs Explorer 页面。

转到日志浏览器
在 Query（查询）窗格中，定义您希望收到通知的提醒。

以下查询示例会在每次有安排的备份作业失败时发送通知。
```
  logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
  jsonPayload.jobCategory="SCHEDULED_BACKUP"
  jsonPayload.jobStatus="FAILED"
```
替换以下内容：
- PROJECT_ID：项目的名称。
在查询结果窗格的标题中，点击创建提醒。
在提醒详情部分中，执行以下操作：
1. 在提醒政策名称字段中，输入提醒的名称。此名称会显示在通知标题中。
2. 在文档字段中，输入提醒的说明。如需了解如何设置此字段格式并优化其内容，请参阅在文档模板中使用 Markdown 和变量。
点击下一步。
在选择要包含在提醒中的日志部分中，执行以下操作：
1. 点击预览日志可查看查询和结果。如有必要，您还可以在此窗格中修改查询。
2. 点击添加标签，然后执行以下操作。借助标签，您可以自定义通知，使其更具信息性。
  1. 在显示名称字段中，输入标签的名称。
  2. 从日志字段名称列表中，选择一个日志字段名称。系统会根据所选查询结果显示这些字段。
  3. 在正则表达式字段中，输入一个表达式，用于从字段中提取值，该值必须正好包含一个正则表达式组。
点击下一步。
在设置通知频率和自动关闭时长部分，执行以下操作：
1. 从通知间隔时间列表中，选择通知之间的最短时间间隔。如果此值被多次触发，您可以使用此值来控制从提醒收到的通知数量。
2. 在突发事件自动关闭时长列表中，选择一个时长，当突发时间没有匹配的日志条目达到此时长时，此突发事件将自动关闭。
点击下一步。
从通知渠道列表中，为提醒选择一个或多个通知渠道。如果您尚未配置通知渠道，请点击管理通知渠道以创建一个。有关说明，请参阅创建和管理通知渠道。
点击保存。

测试基于日志的提醒

如需测试您创建的基于日志的提醒，您可以手动写入与查询匹配的日志条目。

请按照以下说明写入日志条目。

转到 logEntries.write 参考页面。

转到 logEntries.write

通过将 PROJECT_ID 变量更改为您的项目 ID，配置以下日志条目。

      {
        "entries": [
          {
            "jsonPayload": {
              "jobCategory": "SCHEDULED_BACKUP",
              "jobStatus": "FAILED"
            }
          }
        ],
        "resource": {
          "type": "backupdr.googleapis.com/BackupDRProject"
        },
        "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbdr_backup_restore_jobs"
      }

替换以下内容：

PROJECT_ID：项目的名称。

复制您之前配置的日志条目。
在试用此 API 窗格中，按以下步骤操作：
1. 在请求正文字段中，将内容替换为您在上一步中复制的日志条目。
2. 点击 Execute。如果出现提示，请按照身份验证流程操作。
如果 logEntries.write 调用成功，您会收到 HTTP 200 响应代码和空响应正文 {}。如需详细了解 API Explorer，请参阅使用 API Explorer。

日志条目与为提醒指定的过滤条件匹配，指定方法如下：
- logName 值指定 Cloud 项目中的备份或恢复作业日志。
- jsonPayload 包含一个失败的作业类别 SCHEDULED_BACKUP，这表示该日志与备份方案安排的备份相关。
- jsonPayload 包含作业状态字段 FAILED，表示作业已失败。
写入日志条目后，会发生以下序列：
1. 新日志条目会显示在日志浏览器中并触发提醒。
2. Cloud Monitoring 页面中会打开一个突发事件。
3. 您会收到突发事件通知。如果您配置了电子邮件通知渠道，系统会显示通知。
  
  您可以点击电子邮件中的查看突发事件，查看 Cloud Monitoring 页面中的突发事件。如需详细了解突发事件（包括如何确认和关闭突发事件），请参阅管理基于日志的提醒的突发事件。