kube-prometheus接飞书告警

<think>好的，我需要帮助用户配置kube-prometheus以发送告警到飞书。首先，我需要回顾已有的知识，看看之前的引用中提到的方法，特别是关于钉钉告警的配置，可能可以借鉴类似的步骤。 根据引用[1]，配置钉钉告警需要修改prometheus-rules.yaml并应用，然后重启Prometheus。类似的流程可能适用于飞书，但需要找到飞书的Webhook地址和相关配置。 用户提到的引用[2]和[4]提到了使用kube-prometheus-stack的部署方法，可能涉及Helm charts的配置。用户可能需要修改Alertmanager的配置来集成飞书的接收器。 首先，用户需要创建一个飞书的机器人来获取Webhook URL。然后，在Alertmanager的配置中添加飞书作为接收器。可能需要自定义模板来格式化告警信息，使其符合飞书的消息格式。 另外，引用[3]提到部署Prometheus时的注意事项，比如避免与metrics-server冲突，但这里可能不相关。重点应放在Alertmanager的配置上。 可能的步骤包括： 1. 获取飞书机器人的Webhook URL。 2. 修改Alertmanager的配置文件，添加飞书的webhook配置。 3. 应用配置并重启相关组件，如Alertmanager。 4. 验证配置是否生效，发送测试告警。 需要确保用户了解如何编辑Kubernetes的ConfigMap，特别是alertmanager-config，可能通过Helm values文件或直接修改配置。同时，可能需要处理飞书API的认证或消息格式，比如使用JSON体，并设置正确的Content-Type。 还要注意，如果用户使用的是kube-prometheus-stack的Helm chart，可能需要通过values.yaml来配置接收器，而不是直接修改生成的ConfigMap。这需要查阅相关Helm chart的文档，确认如何添加自定义接收器。 最后，确保用户测试配置的正确性，可以通过手动触发告警来检查飞书是否收到通知。如果有错误，查看Alertmanager的日志进行排错。</think>### 配置 kube-prometheus 实现飞书告警通知 #### 步骤 1：获取飞书机器人 Webhook 地址 1. 在飞书群聊中添加「自定义机器人」，记录生成的 Webhook URL，格式如下： ``` https://open.feishu.cn/open-apis/bot/v2/hook/{唯一标识符} ``` #### 步骤 2：修改 Alertmanager 配置 1. 编辑 Alertmanager 的配置文件（通常通过 `alertmanager-config` ConfigMap 管理），添加飞书接收器： ```yaml receivers: - name: feishu-alert webhook_configs: - url: 'https://open.feishu.cn/open-apis/bot/v2/hook/your_token' send_resolved: true # 发送告警恢复通知 http_config: headers: Content-Type: application/json # 自定义飞书消息格式（JSON 模板） body: | { "msg_type": "interactive", "card": { "header": { "title": { "content": "[{{ .Status | toUpper }}] {{ .CommonLabels.alertname }}", "tag": "plain_text" }, "template": "{{ if eq .Status \"firing\" }}red{{ else }}green{{ end }}" }, "elements": [ { "tag": "div", "text": { "content": "**告警描述**: {{ .CommonAnnotations.summary }}", "tag": "lark_md" } } ] } } ``` #### 步骤 3：更新路由规则 在 Alertmanager 配置中添加路由规则，指向飞书接收器： ```yaml route: group_by: [alertname] receiver: feishu-alert routes: - receiver: feishu-alert continue: true ``` #### 步骤 4：应用配置并重启组件 1. 若使用 Helm 部署，需通过 `values.yaml` 覆盖配置： ```yaml alertmanager: config: global: resolve_timeout: 5m route: receiver: feishu-alert routes: [...] receivers: - name: feishu-alert webhook_configs: [...] ``` 执行 Helm 升级： ```bash helm upgrade prometheus-stack prometheus-community/kube-prometheus-stack -f values.yaml ``` 2. 直接修改 ConfigMap 的场景： ```bash kubectl apply -f alertmanager-config.yaml -n monitoring kubectl rollout restart deployment prometheus-stack-alertmanager -n monitoring ``` #### 步骤 5：验证告警配置 1. 触发测试告警（例如通过 `kubectl apply` 部署一个模拟告警规则） 2. 检查飞书群聊是否收到告警消息 3. 查看 Alertmanager 日志定位问题： ```bash kubectl logs -f prometheus-stack-alertmanager-xxx -n monitoring ``` ### 常见问题排查 1. **Webhook 返回 400 错误**：检查消息体格式是否符合飞书文档要求，使用 `json_parser` 验证模板语法 2. **未收到告警**：检查 Alertmanager 路由规则是否匹配告警标签，通过 `http://alertmanager:9093/#/status` 查看告警状态 3. **认证失败**：确保 Webhook URL 包含正确的 Token，飞书机器人未被禁用 ### 扩展优化 - **消息模板增强**：添加集群名称、告警级别等字段，参考飞书卡片消息的 Markdown 扩展语法 - **告警静默**：通过 Alertmanager 的 `silence` 功能过滤低优先级告警 - **监控指标联动**：在告警消息中嵌入 Grafana 仪表盘链接，快速跳转分析 --- #### 相关问题 1. **如何为 kube-prometheus 配置多个告警接收渠道（如同时发送到飞书和邮件）？** *答：在 Alertmanager 的 `receivers` 中定义多个接收器，通过路由规则匹配不同标签分发告警。* 2. **如何自定义飞书告警消息的格式和颜色？** *答：修改 `body` 字段中的 JSON 模板，遵循飞书开放平台的[卡片消息规范](https://open.feishu.cn/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN)。* 3. **kube-prometheus 告警延迟或丢失的可能原因是什么？** *答：检查 Prometheus 的 `scrape_interval` 配置、Alertmanager 的 `group_wait` 参数及网络延迟问题[^4]。*