查询和查看未解决的提醒

借助 Google Distributed Cloud (GDC) 网闸隔离配置中的提醒监控功能,您可以在创建提醒规则后跟踪和排查整个项目中的有效通知。您可以在 GDC 控制台中检查提醒严重级别、时长、状态和标签。对于脚本、cron 作业和自定义集成,请使用 curl 查询项目的 Cortex Alertmanager HTTP 端点。

准备工作

如需获得查询和直观呈现提醒所需的权限,请让您的 IAM 项目管理员在您的项目命名空间中为您授予关联的 Project Cortex Alertmanager 角色之一。根据您需要的访问权限和权限级别,您可能会在项目中获得此资源的 Editor 或 Viewer 角色。

下表总结了 PA and AO persona 的 Role 要求。

角色 对象 集群 角色 命名空间 群组/用户 配置
PA grafana org-admin project-cortex-alertmanager-viewer platform-obs 群组 1
PA grafana org-admin project-cortex-alertmanager-viewer platform-obs 用户 2
AO alertmanager org-admin project-cortex-alertmanager-viewer PROJECT_NAMESPACE 群组 1
AO alertmanager org-admin project-cortex-alertmanager-viewer PROJECT_NAMESPACE 用户 2

请酌情替换以下变量:

变量 说明
KUBECONFIG 您需要特定集群的 kubeconfig,该集群包含将应用此 RoleBinding 的 NAMESPACE。
RULE_NAME 此 RoleBinding 资源在命名空间中的唯一名称。例如 pa-cortex-alertmanager-viewer。
NAMESPACE 将在其中创建并应用此 RoleBinding 的 Kubernetes 命名空间。请查看上表中的 Namespace 列。
EMAIL_ADDRESS 被授予角色的用户的标识符。这通常是邮箱。例如 infrastructure-operator@example.com。
ROLE Role 的名称,其中包含您要授予用户的权限。在上表中查找可用角色
GROUP_NAME PA/AO 用户所属的 Group 的名称。例如 pa-group。
ZONE 区域名称

配置 1

此配置会向用户群组授予访问 org 集群中的 PA/AO 提醒的权限。完成此配置后,请参阅本文档的控制台部分,在 GDC 控制台中查看提醒。

  • Kubectl 命令

    以下是通用命令格式:

    kubectl --kubeconfig `KUBECONFIG` create rolebinding `RULE_NAME` -n `NAMESPACE` --group=`GROUP_NAME` --role=project-cortex-alertmanager-viewer
    

    示例:

    kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --group=my-team --namespace=platform-obs
    
  • IAC 文件路径

    /infrastructure/zonal/zones/`ZONE`/org-admin/rolebindings/`GROUP_NAME`/<YAML_FILE>
    
  • Yaml 文件

    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
      name: RULE_NAME
      namespace: NAMESPACE
    subjects:
    - kind: Group
      name: GROUP_NAME
      apiGroup: rbac.authorization.k8s.io
    roleRef:
      kind: Role
      name: project-cortex-alertmanager-viewer
      apiGroup: rbac.authorization.k8s.io
    

配置 2

此配置适用于 PA 角色,目标是 org-admin 集群中的 grafana 对象。 它会将 platform-obs 命名空间中的 project-cortex-alertmanager-viewer 角色授予 User。

  • Kubectl 命令

    以下是通用命令格式:

    kubectl --kubeconfig `KUBECONFIG` create rolebinding `RULE_NAME` -n platform-obs --user=`EMAIL_ADDRESS` --role=project-cortex-alertmanager-viewer
    

    示例:

    kubectl --kubeconfig <path-to-kubeconfig> create rolebinding project-cortex-alertmanager-viewer-binding --role=project-cortex-alertmanager-viewer --user=my-email@example.com --namespace=platform-obs
    
  • IAC 文件路径

    /infrastructure/zonal/zones/`ZONE`/org-admin/rolebindings/`EMAIL_ADDRESS`/<YAML_FILE>
    
  • Yaml 文件

    apiVersion: rbac.authorization.k8s.io/v1
    kind: RoleBinding
    metadata:
      name: RULE_NAME
      namespace: platform-obs
    subjects:
    - kind: User
      name: EMAIL_ADDRESS
      apiGroup: rbac.authorization.k8s.io
    roleRef:
      kind: Role
      name: project-cortex-alertmanager-viewer
      apiGroup: rbac.authorization.k8s.io
    

    如需详细了解这些角色,请参阅准备 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 命令在 curl 请求中使用授权标头。如需了解详情,请参阅 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 格式。