查询和查看未解决的提醒

本页面详细介绍了如何使用 GDC 控制台和 Cortex 端点的 curl 工具查询和直观呈现未解决的提醒，以便及时了解问题并解决问题。

根据 Google Distributed Cloud (GDC) 空气隔离环境中的日志和指标创建提醒规则后，您就可以开始监控项目中的未解决提醒。您可以在 GDC 控制台上直观呈现和过滤系统事件触发的提醒，也可以使用 curl 工具直接从 Cortex 访问这些提醒，以便灵活地编写脚本和实现自动化。

您可以通过以下两种方法之一访问未解决的提醒：

  • GDC 控制台：在集成面板中直观呈现提醒数据，其中包含特定数据源的提醒数量、严重程度、持续时间、状态、消息和标签等信息。GDC 控制台提供了一个用户友好的界面，用于过滤和分析系统组件发出的提醒。
  • Cortex Alertmanager 端点：对于更高级的用例，请使用命令行中的 curl 工具直接查询项目的 Cortex 实例。Cortex 会存储项目的 Alertmanager 提醒，并提供一个 HTTP 端点以供程序化访问。通过此访问权限，您可以导出数据、自动执行任务、配置 Cron 作业和构建自定义集成。

准备工作

如需获得查询和直观呈现提醒所需的权限，请让您的项目 IAM 管理员在项目命名空间中向您授予关联的 Project Cortex Alertmanager 角色之一。根据您需要的访问权限级别，您可以在项目中获取相应资源的编辑者或查看者角色。

如需详细了解这些角色，请参阅准备 IAM 权限。

查看和过滤未解决的提醒

选择以下方法之一，以查询和过滤项目命名空间中的未解决的提醒：

控制台

在 GDC 控制台中查看项目中的未处理提醒：

  1. 登录 GDC 控制台。
  2. 在 GDC 控制台中，选择您的项目。
  3. 在导航菜单中，依次选择操作 > 提醒。
  4. 选择提醒标签页。
  5. 查看提醒列表。
  6. 在已打开的提醒部分，点击过滤可仅显示已打开的提醒。您还可以按其他属性名称或值过滤提醒。
  7. 点击提醒名称可查看提醒详情。

Cortex 端点

本部分介绍了如何使用 Cortex Alertmanager 端点访问提醒。

确定 Cortex 端点

以下网址是您项目的 Cortex 实例的端点：

  https://GDC_URL/PROJECT_NAMESPACE/cortex/alertmanager/

替换以下内容：

  • GDC_URL：您组织在 GDC 中的网址。

  • PROJECT_NAMESPACE：您的项目命名空间。

    例如，org-1 组织中 platform-obs 项目的 Cortex 端点为 https://org-1/platform-obs/cortex/alertmanager/。

对 curl 请求进行身份验证

  1. 下载并安装 gdcloud CLI。

  2. 设置 gdcloud core/organization_console_url 属性：

    gdcloud config set core/organization_console_url
https://GDC_URL

  3. 通过配置的身份提供方登录：

    gdcloud auth login

  4. 使用您的用户名和密码进行身份验证并登录。

    登录成功后，您可以通过 gdcloud auth print-identity-token 命令在 c网址 请求中使用授权标头。如需了解详情，请参阅 gdcloud auth。

调用 Cortex 端点

完成以下步骤，以使用 curl 工具访问 Cortex 端点：

  1. 对 curl 请求进行身份验证。

  2. 使用 curl 调用 Cortex 端点，并使用标准 Alertmanager API 规范 (https://prometheus.io/docs/prometheus/latest/querying/api/#alertmanagers) 扩展网址以查询提醒。

    以下是 curl 请求的示例：

      curl https://GDC_URL/PROJECT_NAME/cortex/alertmanager/api/v1/alertmanagers \
  -H "Authorization: Bearer $(gdcloud auth print-identity-token \
  --audiences=https://GDC_URL)"

    您会获得以下命令输出。API 响应采用 JSON 格式。