借助 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-obsIAC 文件路径
/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-obsIAC 文件路径
/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 控制台查看项目中的未处理提醒:
- 登录 GDC 控制台。
- 在 GDC 控制台中,选择您的项目。
- 在导航菜单中,依次选择运维 > 提醒。
- 选择提醒标签页。
- 查看提醒列表。
- 在已打开的提醒部分,点击过滤条件以仅显示打开的提醒。您还可以按其他属性名称或值过滤提醒。
- 点击提醒名称即可查看提醒详情。
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 请求进行身份验证
- 下载并安装 gdcloud CLI。
设置 gdcloud
core/organization_console_url属性:gdcloud config set core/organization_console_url https://GDC_URL-
gdcloud auth login 使用您的用户名和密码进行身份验证并登录。
登录成功后,您可以通过
gdcloud auth print-identity-token命令在 curl 请求中使用授权标头。如需了解详情,请参阅 gdcloud auth。
调用 Cortex 端点
完成以下步骤,以使用 curl 工具访问 Cortex 端点:
- 对
curl请求进行身份验证。 使用
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 格式。