飞书接收 AI 巡检告警

本文面向通过 飞书 接收巡检消息的平台管理员与运维人员，说明如何配置 AI 智能巡检 的飞书通知。仅包含操作步骤与功能说明。

功能说明

平台按定时计划执行 AI 智能巡检，对服务器、K8s 集群、数据库、中间件等做只读健康检查并生成报告。当巡检 执行失败 或 报告发现异常 时，可通过飞书应用机器人向指定人员发送单聊消息。

不会发送飞书的情况：

• 巡检成功且报告结论健康、无异常项
• 未配置或未启用「AI 智能巡检 + 飞书」告警规则
• 接收人未正确维护飞书用户 ID

相关入口

一、上线前准备（管理员）

以下步骤通常由平台管理员或实施人员完成，一般只需配置一次。

1. 飞书开放平台

在 飞书开放平台 创建 企业自建应用，并完成：

1. 开启 机器人 能力并发布应用版本。
2. 在 权限管理 中开通发送消息、读取通讯录等必要权限（实施人员会提供清单）。
3. 数据权限：通讯录可见范围需覆盖接收告警的员工。
4. 可用范围：将接收人加入应用可用范围。
5. 记录应用的 App ID、App Secret。

2. 平台填写飞书凭证

1. 进入 系统管理 → 字典管理。
2. 找到飞书应用配置项，填写 App ID 与 App Secret。
3. 保存后即可生效，无需重启服务。

3. 维护接收人飞书 ID

每位接收人须先在 用户管理 中维护手机号或邮箱，再获取飞书用户 ID。详见 批量获取飞书用户 ID。

二、配置飞书告警规则

1. 进入 告警通知 → 告警配置。
2. 点击 新增。
3. 人员：勾选需要接收飞书消息的系统用户（须已配置飞书用户 ID）。
4. 告警模块：勾选 AI 智能巡检告警（不要只选「异常根析告警」）。
5. 告警方式：勾选 飞书。
6. 打开 启用，保存。

三、配置定时巡检

1. 进入 AI 巡检 → 定时巡检配置。
2. 添加巡检任务：选择业务组或实例、填写巡检内容与 Cron 表达式。
3. 保存配置。

详细步骤见 AI 智能巡检操作指南。

四、什么时候会收到飞书？

飞书中为 应用机器人单聊 文本消息，包含任务名、级别与摘要；完整 HTML 报告请在 AI 巡检 → 巡检日志 → 查看详情 中查看。

收到飞书后，可登录平台打开对应巡检记录，点击 AI 跳转 AI 天穹 继续追问处置建议。

五、查看发送是否成功

1. 进入 告警通知 → 通知日志。
2. 告警模块筛选：AI 智能巡检。
3. 发送方式筛选：飞书。
4. 查看每条记录的发送状态；若失败，可查看失败原因（如未配置飞书用户 ID、用户不在应用可用范围等）。

六、推荐配置顺序

① 飞书开放平台：创建应用、开机器人、开权限
        ↓
② 平台字典：填写飞书 App ID / App Secret
        ↓
③ 用户管理：补全手机/邮箱 → 批量获取飞书 ID
        ↓
④ 告警配置：人员 + AI 智能巡检告警 + 飞书 + 启用
        ↓
⑤ AI 巡检：定时巡检配置并保存
        ↓
⑥ 等待执行 → 巡检日志看报告 → 通知日志确认飞书是否送达
        ↓
⑦ （可选）巡检日志点 AI → 继续追问

七、常见问题

批量获取飞书 ID 全部失败？

• 检查字典中飞书应用凭证是否已填写。
• 检查飞书应用权限是否已开通并 发布版本。
• 检查用户手机号/邮箱是否为空或与飞书账号不一致。

有飞书 ID 但仍收不到消息？

• 告警规则是否启用，且模块含 AI 智能巡检告警、方式含 飞书。
• 该次巡检是否属于失败或有异常（健康巡检不通知）。
• 用户是否在飞书应用 可用范围 内。
• 在 通知日志 中查看失败原因。

飞书常见错误现象

延伸阅读

• 批量获取飞书用户 ID
• AI 智能巡检操作指南
• 平台管理 · 告警通知