如何调用GCP API获取指定告警策略对应生成的告警事件(Incident)

可用查询接口 #

你可以使用以下两种方式查询指定告警策略生成的告警事件：

方式一：直接关联告警策略查询 #

请求方法：GET
请求地址：https://monitoring.googleapis.com/v3/projects/{projectId}/alertPolicies/{alertId}/incidents

• 路径参数projectId替换为你的GCP项目ID，alertId替换为你已有告警策略的ID
• 支持追加查询参数控制返回结果：
  • pageSize: 单页返回的最大事件数量，默认100，最大可选1000
  • filter: 可追加时间、状态等过滤条件，例如仅查询未关闭的事件可添加filter=closed=false，查询指定时间段的事件可添加filter=start_time>="2024-04-20T00:00:00Z"，时间格式采用RFC3339标准

方式二：全局事件列表加过滤条件查询 #

请求方法：GET
请求地址：https://monitoring.googleapis.com/v3/projects/{projectId}/incidents?filter=policy_name="projects/{projectId}/alertPolicies/{alertId}"

• 其中policy_name的取值直接复用你之前查询告警策略接口返回的name字段值即可

调用前置配置要求 #

• 你的请求身份凭证需拥有monitoring.alertIncidents.list权限，可给对应账号/服务账号绑定Monitoring Viewer预置角色获取该权限
• Postman调用配置参考：
  • 认证方式选择OAuth 2.0
  • OAuth scope填写https://www.googleapis.com/auth/monitoring.read
  • 完成身份认证获取有效令牌后，即可正常发起请求

响应内容说明 #

接口返回的incidents数组中包含所有符合条件的告警事件，每个事件字段包含触发时间、关闭时间、事件状态、触发的资源信息、阈值触发详情等你需要的告警事件数据。

内容的提问来源于stack exchange，提问作者Tomas Tesfazghi