日志与监测 | LanSphere 使用手册

日志与监测

本篇介绍蓝域(LanSphere)应用的运行观测能力:通过「对话日志」页签查看运行记录并进行标注,通过「数据看板」页签掌握整体运行指标,以及按需导出日志进行归档与分析。适合负责应用运营与质量优化的开发人员、管理员与所有者阅读。

应用上线后,持续观测运行状况是保障服务质量的关键。建议你结合三个工具形成日常运营闭环:在数据看板中发现趋势与异常,在对话日志中定位具体问题,通过标注积累优化素材。

对话日志

应用详情页的「对话日志」页签按应用类型展示运行记录,工作流与对话类应用的日志结构有所不同。

提示:「对话日志」页签同时承载日志查看与标注能力,也可理解为「对话日志与标注」。智能体应用同样提供该页签,使用方式一致。

工作流日志

工作流是单轮自动化应用,日志按运行次数记录,每条包含以下字段:

字段 说明
状态 本次运行的结果状态
开始时间 运行触发的时间
运行耗时 从触发到结束的总耗时
Token 总数 本次运行消耗的大模型 Token 总量
输入 / 输出 工作流接收的输入与最终返回的输出
节点中间过程 各节点在运行中的输入、输出等中间数据

对话流与智能体日志

对话类应用的日志按对话维度组织:

  • 每个对话展示包含的消息数量;
  • 每条消息记录输入、输出、耗时与 Token 消耗;
  • 同时展示用户对回答的反馈(好评 / 差评)。

查看单条运行详情

点击单条日志可查看完整运行详情:

  • 工作流:逐节点查看输入、输出与中间过程,还原完整执行链路;
  • 对话类应用:逐条消息查看对话上下文,还原交互过程。

当应用运行异常或回答不符合预期时,建议先按时间或状态找到问题日志,再通过单条运行详情逐步定位问题发生在哪个节点或哪条消息,随后回到「应用开发」页签针对性调整编排、提示词或知识库配置。

标注

在对话日志中,你可以对回答进行标注,持续优化应用的回答质量:

  • 好评 / 差评:标记回答质量,快速区分优质回答与问题回答;
  • 标注回复:为不理想的回答补充期望的回复内容,记录正确的应答方式。

操作场景举例:

  1. 定期筛查差评较多的话题,判断问题是出在知识库内容缺失、提示词约束不足,还是编排逻辑不当;
  2. 对典型问题回答添加标注回复,作为后续优化的参照;
  3. 将标注积累用于完善提示词、补充知识库内容或调整编排逻辑,形成「发现问题—标注记录—优化应用」的持续改进闭环。

标注是一项需要长期坚持的工作。建议将标注纳入应用的日常运营流程,安排专人定期处理差评记录,并在每次应用优化后回头验证同类问题的回答是否改善。

数据看板

「数据看板」页签以可视化图表展示应用的整体运行状况,主要指标包括:

指标 说明
运行成功率 应用成功完成运行的比例,反映服务稳定性
平均响应时间 应用响应请求的平均耗时,反映服务性能
Token 用量 大模型 Token 消耗情况,反映使用规模与成本趋势
工具调用分布 各类工具被调用的分布情况,反映能力使用结构

图表支持按时间范围筛选。你可以对比不同时段的指标变化:例如成功率突然下降时,缩小时间范围定位异常起点,再回到对话日志中查找对应时段的失败记录;Token 用量异常增长时,可结合日志排查是否存在异常调用。

日志导出

当需要归档留存或在平台外深入分析日志时,可将日志导出为 JSON 文件。

权限

仅所有者与管理员可见「导出」按钮,其他角色无法导出日志。

操作步骤

  1. 打开应用的「对话日志」页签,点击「导出」;
  2. 在弹窗中选择时间范围,共九档可选:
今天 过去 7 天 过去 4 周
过去 3 月 过去 12 月 本月至今
本季度至今 本年至今 所有时间
  1. 确认后导出 JSON 文件,文件名形如 对话日志_20260729_120000.json,即「对话日志_导出日期_导出时间.json」。

提示:所选时间范围内无数据时,系统提示「无符合条件的日志」,请调整时间范围后重试。

导出文件说明

导出内容的字段构成与「对话日志」页签的展示口径一致,按应用类型组织:

  • 工作流应用:包含各次运行的状态、开始时间、耗时、Token 总数、输入输出与节点中间过程;
  • 对话流与智能体应用:包含对话维度的消息数量,以及逐条消息的输入、输出、耗时、Token 与用户反馈。

其中用户反馈以编码记录:

编码 含义
1 好评
0 差评
2 无反馈

相关阅读

  • 应用的发布方式与渠道配置,请参阅《发布渠道》;
  • 应用权限、所有权转移与删除规则,请参阅《应用管理》;
  • 对话流、智能体应用的编排与调试,请参阅《对话流》《智能体》。