管理基于日志的提醒政策的突发事件

突发事件是满足提醒政策条件时生成的记录。通常，当收到与提醒政策条件匹配的日志时，Cloud Monitoring 会开启突发事件并发送通知。不过，在以下情况下，系统不会创建突发事件：

• 政策已延后或停用。
• 提醒政策或突发事件数量超出了现有的提醒方面的限制。
• 另一个日志条目导致满足与未结突发事件相同的条件。在这种情况下，Monitoring 只会针对该相同突发事件发送另一个通知。

对于每个突发事件，Monitoring 都会创建一个突发事件详细信息页面，以便您管理突发事件，并报告可帮助您排查失败问题的突发事件信息。例如，突发事件详细信息页面会显示与基于日志的提醒政策的查询匹配的日志条目列表。您还可以找到指向相关突发事件的链接。

本文档介绍如何查找您的突发事件。还介绍如何使用突发事件详细信息页面管理基于日志的提醒政策的突发事件，这些政策会评估 Cloud Logging 中各个日志中存储的日志条目数据。

此功能仅适用于 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或管理项目。

准备工作

如需获得查看和管理突发事件所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

• 使用 Google Cloud CLI 或 Cloud Monitoring API 查看突发事件： Monitoring Alert Viewer (roles/monitoring.alertViewer)
• 使用 Google Cloud 控制台查看突发事件：
  • Monitoring Cloud Console Incident Viewer (roles/monitoring.cloudConsoleIncidentViewer)
  • Stackdriver Accounts Viewer (roles/stackdriver.accounts.viewer)
• 使用 Google Cloud 控制台管理突发事件：
  • Monitoring Cloud Console Incident Editor (roles/monitoring.cloudConsoleIncidentEditor)
  • Stackdriver Accounts Viewer (roles/stackdriver.accounts.viewer)

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解 Cloud Monitoring 角色，请参阅使用 Identity and Access Management 控制访问权限。

查看突发事件

如需查看项目中的突发事件，请使用 Google Cloud 控制台、gcloud CLI（公开预览版）或 Monitoring API（公开预览版）。

Google Cloud 控制台

如需列出 Google Cloud 项目中的突发事件，请执行以下操作：

1. 在 Google Cloud 控制台中，前往  提醒页面：

   进入提醒

   如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

2. 在 Google Cloud 控制台的工具栏中，选择您的 Google Cloud 项目。对于 App Hub 配置，请选择 App Hub 宿主项目或管理项目。

   提醒页面会显示有关提醒政策、延后和突发事件的信息：

   • 摘要窗格列出了未结突发事件的数量。
   • 突发事件窗格会显示近期的未结突发事件。如需在表中列出近期的突发事件（包括已结突发事件），请点击显示已结突发事件。

3. 如需查看特定突发事件的详细信息，请在列表中选择相应突发事件。

   系统会打开突发事件详细信息页面。如需详细了解突发事件详细信息页面，请参阅本页面中的调查突发事件部分。

查找较早的突发事件

提醒页面上的突发事件窗格会显示近期的未结突发事件。如要查找较早的突发事件，请执行以下任一操作：

• 如需分页浏览突发事件表中的条目，请点击 较新或 较早。

• 如需打开一个可用于列出和过滤突发事件的页面，请点击查看所有突发事件。系统会打开突发事件页面。在该页面上，执行以下操作：

  • 显示所有突发事件，包括已关闭的突发事件。如需显示所有突发事件，请点击显示已关闭的突发事件。
  • 过滤突发事件：如需了解如何添加过滤条件，请参阅过滤突发事件。
  • 确认或关闭突发事件，或是延后其提醒政策。如需访问这些选项，请在突发事件行中点击 更多选项，然后从菜单中选择所需的选项。如需了解详情，请参阅管理突发事件。

过滤突发事件

如需限制表格中显示的突发事件，请添加过滤条件。如果您添加多个过滤条件，则表格只会显示满足所有过滤条件的突发事件。

要过滤突发事件表，请执行以下操作：

1. 在突发事件页面上，点击 过滤表，然后选择过滤条件属性。过滤条件属性包括以下内容：

   • 突发事件的状态
   • 提醒政策的名称
   • 突发事件打开或关闭的时间

2. 从二级菜单中选择一个值，或在过滤条件栏中输入一个值。

   然后，突发事件表格会列出过滤条件。

gcloud

您可以使用 gcloud 获取突发事件和列出突发事件。

预览版

此产品或功能 受服务专用条款的约束。 非正式版产品和功能“按原样”提供，可能只提供有限的支持。 如需了解详情，请参阅发布阶段说明。

获取突发事件

在使用下面的命令数据之前，请先进行以下替换：

• ALERT_NAME：提醒的资源名称。例如 projects/my-project/alerts/my-alert-id。

执行 gcloud alpha monitoring alerts describe 命令：

Linux、macOS 或 Cloud Shell

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts describe ALERT_NAME

该命令会返回包含提醒详细信息的响应，例如提醒状态、附加标签和来源提醒政策。 请注意，在预览期间，响应中的标签可能会发生变化。响应类似于以下内容：

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

列出突发事件

您可以使用 gcloud CLI 列出项目中的突发事件并过滤结果。

在使用下面的命令数据之前，请先进行以下替换：

• PROJECT_ID：项目的标识符。

执行 gcloud alpha monitoring alerts list 命令：

Linux、macOS 或 Cloud Shell

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts list

Windows (PowerShell)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts list

Windows (cmd.exe)

注意：通过运行 gcloud init 或 gcloud auth login 和 gcloud config set project，确保您已使用身份验证和项目初始化了 Google Cloud CLI。

gcloud alpha monitoring alerts list

该命令会返回包含提醒详细信息的响应，例如提醒状态、附加标签和来源提醒政策。 请注意，在预览期间，响应中的标签可能会发生变化。响应类似于以下内容：

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

您还可以使用以下可选标志来过滤、排序或修改输出：

• --filter：提供过滤表达式，按时间或标签过滤提醒。例如，使用 --filter='close_time>="2025-09-10T00:00:00Z"' 按时间过滤，或使用 --filter='resource.labels.key="value"' 按标签过滤。

• --sort-by：用于对输出进行排序的字段的英文逗号分隔列表。例如 --sort-by=open_time。

• --uri：命令输出资源 URI 列表，而不是默认输出。

• --limit：将此标志设置为 2 或更大的值，以限制返回的提醒数量。请勿将此标志与 --filter 标志结合使用。

Monitoring API

您可以使用 Monitoring API 获取突发事件和列出突发事件。

预览版

此产品或功能 受服务专用条款的约束。 非正式版产品和功能“按原样”提供，可能只提供有限的支持。 如需了解详情，请参阅发布阶段说明。

获取突发事件

如需使用 Monitoring API 获取单个突发事件的详细信息，请使用 alerts.get 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的标识符。
• ALERT_ID：提醒的 ID。

HTTP 方法和网址：

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID"

PowerShell (Windows)

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID" | Select-Object -Expand Content

该命令会返回包含提醒详细信息的响应，例如提醒状态、附加的标签和来源提醒政策。请注意，在预览期间，响应中的标签可能会发生变化。响应类似于以下内容：

{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

列出突发事件

如需使用 Monitoring API 列出项目中的突发事件并过滤结果，请使用 alerts.list 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：项目的标识符。

HTTP 方法和网址：

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts"

PowerShell (Windows)

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts" | Select-Object -Expand Content

该命令会返回包含提醒详细信息的响应，例如提醒状态、附加的标签和来源提醒政策。请注意，在预览期间，响应中的标签可能会发生变化。响应类似于以下内容：

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

Curl 用户可以添加 --data-urlencode 标志，后跟过滤表达式，按时间或标签过滤提醒。请参见以下示例：

列出过去 1 小时内打开的提醒：

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

列出并过滤过去 1 天内未解决的提醒：

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

列出并过滤在两个时间段内打开的提醒：

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

按用户标签列出和过滤提醒。在此示例中，按名称为 app、值为 my-gke-app 的用户标签进行过滤：

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"

Powershell 用户可以使用以下示例向请求网址添加基于时间的过滤条件：

$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

注意：并非每当满足条件时都会创建突发事件。如需了解详情，请参阅满足条件时未创建突发事件。

调查突发事件

突发事件详细信息页面包含的信息可能会帮助您找出突发事件的原因。

探索日志条目

探索日志条目，找出与调查相关的模式和反复出现的问题。日志窗格会显示与基于日志的提醒政策的查询匹配的日志条目。

• 如需在 Logs Explorer 中查看日志条目，请点击在日志浏览器中查看，然后选择一个范围项目。
• 如需在 Metrics Explorer 中查看“日志”面板，请点击 探索数据。

查看补充信息

标签部分显示了导致突发事件的日志条目中包含的受监控资源的标签和值。此信息可帮助您识别导致突发事件的特定受监控的资源。如需了解详情，请参阅使用标签为突发事件添加注解。

文档部分显示您在创建提醒政策时提供的通知的文档模板。此信息可能包括对提醒政策监控内容的说明，以及关于应对措施的提示。如需了解详情，请参阅使用用户定义的文档为通知添加注解。

如果您没有为提醒政策配置文档，则文档窗格会显示“未配置任何文档”。

探索相关突发事件

如需帮助您发现应用中的潜在问题，您可以探索与其他提醒政策条件相关的突发事件。

相关突发事件部分会显示符合以下情况之一的突发事件列表：

• 在满足同一提醒政策的条件时创建了突发事件。
• 突发事件与突发事件详细信息页面上显示的突发事件共享一个标签。

管理突发事件

突发事件具有以下状态之一：

• 未结：已满足基于日志的提醒政策的条件，并且突发事件仍处于未结状态。如果再次满足相同条件，并且已存在未结突发事件，则不会开启新的突发事件。

• 已确认：该突发事件为未结状态，并被标记为已确认。 通常，此状态表示正在调查突发事件。

• 已关闭：您已手动关闭突发事件，或突发事件已在自动关闭期限到期后自动关闭。

确认突发事件

我们建议您在开始调查突发事件的原因时将突发事件标记为已确认。

如需将突发事件标记为已确认，请执行以下操作：

1. 在提醒页面的突发事件窗格中，点击查看所有突发事件。

2. 在突发事件页面上，找到要确认的突发事件，然后执行以下操作之一：

   • 点击  更多选项，然后选择确认。
   • 打开突发事件的详细信息页面，然后点击确认突发事件。

延后提醒政策

如需防止 Monitoring 在特定时间段内创建突发事件并发送通知，请延后相关提醒政策。当您延后提醒政策时，与提醒政策相关的突发事件会保持未结状态，但不会触发进一步的通知。突发事件会根据提醒政策的自动关闭时长来关闭。

如需为您正在查看的突发事件创建延后，请执行以下操作：

1. 在突发事件详细信息页面上，点击延后政策。

2. 选择延后时长。选择延后时长后，延后会立即开始。

您也可以在突发事件页面上延后提醒政策，方法是找到要延后的突发事件，点击 更多选项，然后选择延后。您可以在服务中断期间延后提醒政策，以避免在问题排查过程中收到进一步的通知。

关闭突发事件

您可以让 Monitoring 为您结束突发事件，或者您自己结束突发事件。

当提醒政策的自动关闭时长到期后，Monitoring 会自动结束突发事件。默认情况下，自动关闭时长为 7 天。自动关闭时长下限为 30 分钟。

自动关闭时长指定在突发事件关闭之前，必须经过的时间（在此期间，突发事件的原因不会重复发生）。因此，当突发事件处于未结状态且导致该突发事件的原因再次发生时，该突发事件未结状态的持续时间可能会超过自动关闭时长。

如需结束突发事件，请执行以下操作：

1. 在提醒页面的突发事件窗格中，点击查看所有突发事件。

2. 在突发事件页面上，找到要结束的突发事件，然后执行以下操作之一：

   • 点击 查看更多，然后选择关闭突发事件。
   • 打开该突发事件的突发事件详细信息页面，然后点击关闭突发事件。

如果您看到 Unable to close incident 消息，请过几分钟后重试。您无法立即关闭新突发事件，因为导致突发事件的条件仍被提醒系统视为有效。

数据保留和限制

如需了解突发事件的限制和保留期限，请参阅提醒方面的限制。

后续步骤

• 如需使用 Cloud Monitoring API 或命令行创建和管理提醒政策，请参阅使用 API 管理提醒政策。