跳转到主要内容
日志巡检让 Mole Agent 阅读一段时间的日志并写出报告:这段时间有没有问题、问题是什么、依据是哪些日志。巡检只读取日志,不修改任何数据或配置。

开始之前

  • 在 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 与执行模型。

按需巡检

  1. 打开 日志,选择数据流和时间范围并执行查询。查询留空则巡检该数据流的全部日志。
  2. 打开 智能巡检 视图。
  3. 选择 AI 模型。可以在 巡检要求 中说明关注点,例如要关注的服务,或应视为预期结果的情况。
  4. 选择 开始巡检。
巡检会把这些日志的查询结果发送给所选模型。选择 在 Mole Agent 中继续,可以针对报告继续追问。

保存定时巡检

打开 日志 → 智能巡检,然后选择其中一个入口:
  • 保存为定时巡检 打开表单,并带上当前的数据流、查询条件、巡检要求和模型。当前查询没有匹配结果时也可以保存。
  • 定时巡检 打开列表,在列表中选择 新建巡检 打开空白表单。
每天或每周的时刻按新建时界面所用的时区计算:个人偏好中的时区;未设置时为浏览器的时区。表单会写明时区,之后编辑不会改变它。通知和报告使用新建时的界面语言。 默认情况下,每个组织最多保存 20 条定时巡检。

执行方式

报告与结论等级

在列表中选择一条巡检,打开它的报告。左侧是历次执行,选中的执行显示报告、覆盖的时间范围、用时、调用过的工具、消耗的 token 和发出的通知。查看这段时间的日志 会以相同的数据流、查询条件和时间范围打开 日志。 定时巡检的报告带有结论等级: 没有完成的执行没有报告,记录中显示状态和原因: 报告默认保留 30 天,过期后每小时清理一次。删除一条巡检会同时删除它的全部报告。

通知

  • 报告的结论等级达到 何时通知 的要求时,每个渠道收到一条通知:标题说明等级和巡检名称,正文包含数据流、时间范围、等级、报告摘要和报告链接。链接需要配置 http.external_url。
  • 执行失败时,只在上一次执行不是失败的情况下通知一次。连续失败只通知第一次,不受 何时通知 影响。
  • 没有选择渠道时不发送通知,报告仍然保存。
  • 每条通知都出现在 设置 → 通知 → 投递记录 中,阶段为 直接发送。直接发送不经过通知策略,也不能从投递记录中重试。
  • 被定时巡检使用的通知连接器不能删除。

实例配置

定时巡检由承担 alert 角色的节点执行,每 15 秒检查一次是否有到期或排队的执行。部署多个 alert 节点时,每次执行只会被一个节点领取。参见分角色部署。 以下两个指标反映执行情况:

API

接口位于 /api/v1/logs/inspections 下:

日志

编写巡检所读取的查询。

通知渠道

接入接收通知的渠道。
最后修改于 2026年10月26日