Skip to content

应用日志 ​

这篇帮你做什么:在控制台里查程序运行日志,并知道"一件事发生后该去哪个入口核对、看到什么才能下结论"。入口:日志中心 → 应用日志。

什么时候看哪个记录 ​

日志中心的不同入口记录的是不同环节的事实,没有统一的状态机:每个入口保留自己的状态词,不能互相替代,也不能把一个入口的"成功"当作另一个环节完成的证明。

入口记录什么什么时候看能证明不能证明
应用日志(本页)程序运行日志:连接、错误、模块活动程序异常、连不上、报错排障程序在某个时间做过什么、遇到过什么错误不构成业务账本;异步写入可能丢弃
审计日志机器人动作的受理记录(谁、对谁、什么动作、结果)"机器人有没有执行踢人/禁言等动作"动作是否被受理、失败原因"已受理(非平台终态)"不等于平台完成处罚
出站结果(调试)已记录的出站派发的平台响应审计记录提供"查看出站结果"入口时平台对已派发请求的响应分类(成功/失败/未知/未记录)没有终态不能猜成成功;短期记录可能消失
群消息记录机器人收到的群消息"这条消息机器人收到了吗"消息是否进入过处理没有记录可能只是入口被开关拒绝,不代表消息不存在
触发记录(群聊监控)各群规则命中与动作明细"这条规则为什么命中/没命中"规则匹配与该功能的处理明细不是全部功能的动作总账

查动作的完整核对路径见下文"查动作:审计日志与出站结果";触发记录见群聊监控。按现象排障的完整思路另见结果判断与排障。

怎么用 ​

  • 页面顶部有 导出日志、刷新 和 高级筛选(展开/收起)。
  • 筛选条件:
    • 时间范围:可手选起止时间,也可用"今日 / 昨日 / 近7天 / 近30天 / 本月"快捷项;
    • 日志级别:可多选(信息 / 警告 / 错误 / 调试 / 致命);
    • 关键词:同时匹配日志内容和模块名;
    • 高级筛选:按模块(功能)精确筛选,或按日志中的用户 ID 精确筛选。
  • 点 搜索 应用条件,点 重置 清空条件并重新加载。
  • 日志统计:显示当前筛选条件下的匹配日志总数,以及错误、警告、信息条数。列表与统计一起查询;读取失败时会提示"获取日志数据失败",统计区显示"统计暂不可用"。此时列表可能为空,也可能保留上次查询结果,不能当作当前筛选条件下的结果。点 重试 重新查询,成功后再核对列表与统计,不要把空白当成 0。
  • 下方列表按时间倒序排列,列为时间戳、级别、来源、模块、用户 ID、消息内容。点 查看详情 或双击某行可看完整消息与上下文;详情里可 复制日志内容 或 导出当前日志。
  • 列表分页浏览(默认每页 20 条)。

查询上限与日志文件 ​

  • 页面单次查询最多保留最新 1000 条匹配记录;导出最多 10000 条。超过时页面会提示"已匹配 N 条……仅可浏览最新 M 条",此时请缩小时间范围或改用导出;更早的记录需要直接查看日志文件。
  • 程序默认把运行日志写入程序运行目录下的 logs\datahub.log,按 50MB 轮转、保留 5 个备份、7 天后清理(具体由部署配置决定)。页面读取这批日志文件,但受上面的单次查询上限约束。异步写入缓冲满时可能丢弃日志,文件也不是逐条完整的业务账本。
  • 本页只读,没有删除日志的入口;日志清理由轮转与保留策略负责。

查动作:审计日志与出站结果 ​

这两个入口与应用日志同属 日志中心,作用不同。

  1. 在 审计日志 按操作、用户、时间查询,必要时展开更多筛选。这里的“本地群 ID”是数据库内部编号,不是 QQ 群号。点 查看详情 可看错误原因、原始记录与关联标识;“已受理(非平台终态)”不表示平台完成处罚或发送。
  2. 记录有 查看出站结果 时,可沿此入口继续查平台响应;没有关联标识,不代表动作一定未执行。出站页的事件群号表示事件来源,不一定是实际处罚或发送的目标群,不要与本地群 ID 互换。
  3. 调试 / 出站结果 只展示已记录的出站派发结果。详情中的成功、失败、未知或未记录应分别理解;没有终态不能猜成成功,也不能仅凭查不到就重发。

审计记录是持久保存的业务受理事实;出站追踪是短期进程内记录,可能因重启、保留时间或容量限制而消失。查询条件变化后若报错,先重试并核对当前条件,不把旧列表当成新查询结果。结果未知时同时核对平台和目标实际状态,但不能用“目标现在没变化”证明之前从未派发。

排障建议 ​

  1. 想查某个时间点发生了什么:用时间范围或快捷项缩小范围,再配合关键词、模块筛选。
  2. 连接问题:搜 dial 或连接配置名;看常见问题的"连接状态"条目。
  3. 处理动作没发生:先查 群消息记录(是否记录了输入),再查 审计日志(动作是否受理、失败原因);实际平台结果按上节核对,不把审计“已受理”当成执行成功。
  4. 看不到刚发生的一条:先点 刷新(页面不会自动轮询);调试日志量大时注意上面的查询上限。