日志

概述

日志功能让您可以查看和分析 Starnion 系统内的所有活动记录。在一个页面中查看与 Nion 的对话历史、技能执行详情和系统错误,方便进行故障排除和了解使用模式。

主要特点:

  • 对话日志:搜索和浏览所有聊天记录
  • 技能执行日志:追踪哪些技能在何时被执行
  • 错误日志:系统错误发生时查看详细信息
  • 灵活过滤:按日期、日志级别、技能类型和渠道过滤
  • 导出:以 CSV/JSON 格式下载日志

日志类型

对话日志

与 Nion 交互的所有消息记录。

字段 说明
时间戳 消息发送的精确时间
发送者 用户或 AI
渠道 Telegram、WebChat 等
内容 消息正文
对话 ID 会话线程标识符

技能执行日志

AI 内部调用的技能(功能)执行记录。

[2024-03-15 14:23:45] SKILL  finance.add_expense  SUCCESS  "记录五花肉 32元"
[2024-03-15 14:25:12] SKILL  diary.create         SUCCESS  "保存 3/15 日记"
[2024-03-15 14:30:01] SKILL  websearch.search     SUCCESS  "搜索比亚迪股价"
[2024-03-15 14:35:22] SKILL  memo.create          FAILED   "保存失败:备忘录数量上限"

错误日志

系统错误发生时记录的详细日志。

级别 说明 示例
ERROR 功能执行失败 技能调用错误、API 超时
WARN 警告(功能正常) 响应缓慢、触发重试
INFO 一般信息 技能执行完成、用户登录
DEBUG 调试信息 详细执行过程(开发者用)

查看日志

从 Web 界面查看

  1. 点击侧边栏中的日志菜单。
  2. 设置顶部的过滤条件:
    • 日期范围:起始日期 ~ 结束日期
    • 日志级别:ERROR、WARN、INFO、DEBUG
    • 技能类型:按特定技能过滤
    • 渠道:Telegram、WebChat 等
  3. 结果按时间顺序显示。

过滤示例

仅查看错误:

  • 将日志级别设为 ERROR,可快速找到失败的操作。

追踪特定技能:

  • 在技能过滤器中选择 finance,仅显示记账相关日志。

查询特定时段:

  • 使用”最近 7 天”或”本月”等快速日期选项方便地指定范围。

导出日志

您可以将日志数据下载为文件,在外部进行分析。

支持的格式

格式 特点 用途
CSV 可在 Excel 中直接打开 电子表格分析
JSON 结构化数据 编程分析、外部工具对接

导出方法

  1. 应用所需的过滤条件。
  2. 点击右上角的导出按钮。
  3. 选择格式(CSV 或 JSON)。
  4. 文件自动下载。

使用场景

故障排除

当 AI 对特定请求给出异常响应或功能未正常工作时,查看日志可以找到原因。

问题:"帮我记账"但没有保存

日志检查:
[14:35:22] SKILL  finance.add_expense  FAILED  "分类解析失败:缺少输入值"

原因:未指定金额导致解析失败
解决:包含金额重新请求,如"记录午餐 12 元"

使用模式分析

了解哪些技能使用最频繁,从而提高利用率。

安全审计

检查账户是否有异常访问或在非预期时间段的活动。


提示与常见问题

Q:日志保留多长时间? 所有日志永久保存。查询很久以前的日志时,缩小日期范围可以加快搜索速度。

Q:日志中会暴露敏感信息吗? 对话内容包含在日志中,但 API 密钥和密码等系统认证信息会被脱敏处理。

Q:可以删除单条日志吗? 目前不支持单条日志删除功能。为保证数据完整性和审计追踪,日志将被保留。

Q:可以实时监控日志吗? 在 Web 日志页面启用自动刷新,即可近乎实时地查看最新日志。


Copyright © 2025 StarNion. All rights reserved.  |  v0.1.2