跳转到主要内容
OpenShift Container Platform 的监控栈自带 Alertmanager(openshift-monitoring 项目中的 alertmanager-main)。官方文档列出的接收器类型包括 PagerDuty、Webhook、Email、Slack 和 Microsoft Teams,并说明上游 Alertmanager 支持的配置项在 OpenShift 中同样支持。Webhook 接收器向您填写的地址发送 Alertmanager 格式的 JSON(version 为 4,每条告警带 status、labels、annotations、startsAt、endsAt、generatorURL、fingerprint)。Flashduty 的 Prometheus Alertmanager 集成 与该格式兼容,因此不需要单独的 OpenShift 集成:在 Flashduty 创建 Prometheus Alertmanager 集成,把它的推送地址配置为 OpenShift Alertmanager 的 Webhook 接收器。

在 Flashduty On-call

您可通过以下两种方式获取集成推送地址,任选其一即可。集成类型都选择 Prometheus Alertmanager,不是 Red Hat OpenShift。

使用专属集成

  1. 进入 Flashduty 控制台,选择 协作空间,打开一个协作空间
  2. 选择 配置 → 集成数据 → 专属集成,点击 新增集成
  3. 选择 Prometheus Alertmanager,点击 保存
  4. 打开生成的集成卡片,复制 推送地址,形如 https://api.flashcat.cloud/event/push/alert/prometheus?integration_key=<集成密钥>

使用共享集成

  1. 进入 Flashduty 控制台,选择 集成中心 → 告警事件
  2. 选择 Prometheus Alertmanager,填写集成名称
  3. 配置默认路由并选择协作空间;创建后可在 路由 中增加更多规则
  4. 点击 保存,复制生成的 推送地址

在 OpenShift 中配置

OpenShift 官方文档提供两种方式配置接收器,任选其一。操作需要 cluster-admin 权限。
1

在 OpenShift 中添加 Webhook 接收器

OpenShift 官方文档提供两种方式配置接收器,任选其一。操作需要 cluster-admin 权限。
操作路径:OpenShift 控制台(Administrator 视角)› Administration › Cluster Settings › Configuration › Alertmanager › Create Receiver按官方文档,触发告警的标签与所有选择器匹配时才会发送到该接收器;需要精确匹配标签值时在 Routing labels 中添加。填写后点击 Create。
2

验证触发与恢复

操作路径:可访问集群的终端(oc)触发一条集群告警(OpenShift 文档提到可参考 Red Hat 客户门户的 “Send test alerts to Alertmanager in OpenShift 4”),确认 Flashduty 收到活动告警;告警恢复后,确认 Flashduty 中的原告警关闭。

字段映射

一次通知可以包含多条告警,Flashduty 逐条处理(单次最多 100 条)。

恢复与去重

  • Alertmanager 的 Webhook 接收器 send_resolved 默认为 true。恢复时发送 status 为 resolved 的通知,Flashduty 按相同的 fingerprint 关闭对应告警。
  • 如果在 Show advanced configuration 中关闭了恢复通知(或在 YAML 中设置 send_resolved: false),Flashduty 不会收到恢复请求,请在协作空间中开启 超时自动关闭。
  • Alertmanager 会按 repeat_interval 重复发送仍在触发的告警,Flashduty 按 fingerprint 去重,不会产生重复告警。

排查问题

  • Flashduty 返回 Invalid parameters:推送地址不完整,缺少 integration_key,或集成类型不是 Prometheus Alertmanager
  • 告警没有恢复:确认接收器没有关闭 send_resolved
  • 收不到任何告警:确认路由的 matchers 或 Routing labels 与告警标签匹配,集群能访问 api.flashcat.cloud(集群使用 HTTP 代理时,参考 OpenShift 文档中 proxy_from_environment 的说明),可用 oc exec alertmanager-main-0 -n openshift-monitoring -- amtool config routes show --alertmanager.url http://localhost:9093 查看生效的路由