PrometheusAlert集成飞书应用机器人配置指南

PrometheusAlert集成飞书应用机器人配置指南

PrometheusAlert Prometheus Alert是开源的运维告警中心消息转发系统,支持主流的监控系统Prometheus,Zabbix,日志系统Graylog和数据可视化系统Grafana发出的预警消息,支持钉钉,微信,华为云短信,腾讯云短信,腾讯云电话,阿里云短信,阿里云电话等 项目地址: https://gitcode.com/gh_mirrors/pr/PrometheusAlert

前言

在现代监控告警体系中，及时有效的告警通知至关重要。PrometheusAlert作为一个功能强大的告警中心，支持多种通知渠道，其中飞书应用机器人是企业在飞书生态中常用的告警通知方式。本文将详细介绍如何在PrometheusAlert中配置和使用飞书应用机器人功能。

飞书应用机器人概述

飞书应用机器人是基于飞书开放平台的企业级消息推送能力，相比普通机器人具有以下优势：

1. 支持批量消息发送
2. 可定向发送给指定用户或部门
3. 具备更丰富的消息格式支持
4. 企业级安全认证机制

配置步骤详解

第一步：创建飞书应用

1. 登录飞书开放平台
2. 选择"创建企业自建应用"
3. 填写应用基本信息（名称、描述等）
4. 完成创建后进入应用管理后台

第二步：启用机器人能力

1. 在应用管理后台选择"应用功能"
2. 进入"机器人"选项
3. 开启应用的机器人功能

第三步：配置应用权限

为确保机器人能正常工作，需要配置以下权限：

• 给多个用户批量发消息
• 给一个或多个部门的成员批量发消息
• 获取与发送单聊、群组消息

这些权限需要在"权限管理"→"消息与群组"中申请开通。

第四步：发布应用

1. 在"版本管理与发布"中创建新版本
2. 提交审核（需要企业管理员审批）
3. 审核通过后应用即可使用

第五步：获取应用凭证

应用发布后，在应用管理后台可以获取到两个关键凭证：

1. App ID：应用的唯一标识
2. App Secret：用于身份验证的密钥

这两个参数将在PrometheusAlert配置中使用。

PrometheusAlert配置

基础配置

在PrometheusAlert的app.conf配置文件中，添加以下飞书应用相关配置：

# 是否开启飞书应用告警通道
open-feishuapp=1

# 飞书应用ID
FEISHU_APPID=cli_xxxxxxxxxxxxxxxxxxxxx

# 飞书应用密钥
FEISHU_APPSECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 接收人ID配置（支持用户open_id、user_id、union_ids或部门open_department_id）
AT_USER_ID="xxxxxxxxxxx"

接收人ID获取方法

1. 使用飞书管理员账号登录管理后台
2. 进入"组织架构"→"成员与部门"
3. 找到目标用户，查看成员详情
4. 在详情页面可以获取到user_id等标识信息

Prometheus集成配置示例

在Prometheus的告警规则配置中，可以通过webhook方式调用PrometheusAlert的飞书应用接口：

receivers:
- name: 'web.hook.prometheusalert'
  webhook_configs:
  - url: 'http://[prometheusalert_url]:8080/prometheusalert?type=fsapp&tpl=prometheus-feishu-app&at=xxxxxxxx,xxxxxx2,xxxxxxx3'

关键参数说明：

• type=fsapp：指定使用飞书应用通道
• tpl=prometheus-feishu-app：指定使用的消息模板
• at=xxx：指定接收人，多个接收人用逗号分隔

注意事项

1. 飞书应用使用的是批量发送消息接口，消息可能会有一定延迟
2. 必须配置至少一个接收人（用户或部门），否则无法发送消息
3. 应用权限需要管理员审核后才能生效
4. 建议在测试环境验证配置后再应用到生产环境

最佳实践

1. 为不同级别的告警配置不同的接收人组
2. 合理使用消息模板，确保告警信息清晰明确
3. 定期检查应用凭证的有效性
4. 监控告警发送状态，确保通知渠道畅通

通过以上配置，PrometheusAlert可以高效地将监控告警信息推送到飞书应用，帮助企业运维团队快速响应各类系统异常。

PrometheusAlert Prometheus Alert是开源的运维告警中心消息转发系统,支持主流的监控系统Prometheus,Zabbix,日志系统Graylog和数据可视化系统Grafana发出的预警消息,支持钉钉,微信,华为云短信,腾讯云短信,腾讯云电话,阿里云短信,阿里云电话等 项目地址: https://gitcode.com/gh_mirrors/pr/PrometheusAlert