开始之前
- 在 Mole Agent → 设置 → 模型与推理 中至少启用一个 AI 模型,参见 Mole Agent。没有启用的模型时,已保存的巡检仍然列出,但无法执行。
- 确认权限:
Mole Agent 在对话中用
list_log_inspections、list_log_inspection_runs 和 get_log_inspection_run 读取同样的巡检与报告,权限要求相同。run_log_inspection 立即执行一次巡检,需要 inspections.manage,默认还要在对话中确认。参见 Tool Catalog 与执行模型。
按需巡检
- 打开 日志,选择数据流和时间范围并执行查询。查询留空则巡检该数据流的全部日志。
- 打开 智能巡检 视图。
- 选择 AI 模型。可以在 巡检要求 中说明关注点,例如要关注的服务,或应视为预期结果的情况。
- 选择 开始巡检。
保存定时巡检
打开 日志 → 智能巡检,然后选择其中一个入口:- 保存为定时巡检 打开表单,并带上当前的数据流、查询条件、巡检要求和模型。当前查询没有匹配结果时也可以保存。
- 定时巡检 打开列表,在列表中选择 新建巡检 打开空白表单。
每天或每周的时刻按新建时界面所用的时区计算:个人偏好中的时区;未设置时为浏览器的时区。表单会写明时区,之后编辑不会改变它。通知和报告使用新建时的界面语言。
默认情况下,每个组织最多保存 20 条定时巡检。
执行方式
报告与结论等级
在列表中选择一条巡检,打开它的报告。左侧是历次执行,选中的执行显示报告、覆盖的时间范围、用时、调用过的工具、消耗的 token 和发出的通知。查看这段时间的日志 会以相同的数据流、查询条件和时间范围打开 日志。 定时巡检的报告带有结论等级:
没有完成的执行没有报告,记录中显示状态和原因:
报告默认保留 30 天,过期后每小时清理一次。删除一条巡检会同时删除它的全部报告。
通知
- 报告的结论等级达到 何时通知 的要求时,每个渠道收到一条通知:标题说明等级和巡检名称,正文包含数据流、时间范围、等级、报告摘要和报告链接。链接需要配置
http.external_url。 - 执行失败时,只在上一次执行不是失败的情况下通知一次。连续失败只通知第一次,不受 何时通知 影响。
- 没有选择渠道时不发送通知,报告仍然保存。
- 每条通知都出现在 设置 → 通知 → 投递记录 中,阶段为 直接发送。直接发送不经过通知策略,也不能从投递记录中重试。
- 被定时巡检使用的通知连接器不能删除。
实例配置
定时巡检由承担
alert 角色的节点执行,每 15 秒检查一次是否有到期或排队的执行。部署多个 alert 节点时,每次执行只会被一个节点领取。参见分角色部署。
以下两个指标反映执行情况:
API
接口位于/api/v1/logs/inspections 下:
日志
编写巡检所读取的查询。
通知渠道
接入接收通知的渠道。