应用日志
这篇帮你做什么:在控制台里查程序运行日志,并知道"一件事发生后该去哪个入口核对、看到什么才能下结论"。入口:日志中心 → 应用日志。
什么时候看哪个记录
日志中心的不同入口记录的是不同环节的事实,没有统一的状态机:每个入口保留自己的状态词,不能互相替代,也不能把一个入口的"成功"当作另一个环节完成的证明。
| 入口 | 记录什么 | 什么时候看 | 能证明 | 不能证明 |
|---|---|---|---|---|
| 应用日志(本页) | 程序运行日志:连接、错误、模块活动 | 程序异常、连不上、报错排障 | 程序在某个时间做过什么、遇到过什么错误 | 不构成业务账本;异步写入可能丢弃 |
| 审计日志 | 机器人动作的受理记录(谁、对谁、什么动作、结果) | "机器人有没有执行踢人/禁言等动作" | 动作是否被受理、失败原因 | "已受理(非平台终态)"不等于平台完成处罚 |
| 出站结果(调试) | 已记录的出站派发的平台响应 | 审计记录提供"查看出站结果"入口时 | 平台对已派发请求的响应分类(成功/失败/未知/未记录) | 没有终态不能猜成成功;短期记录可能消失 |
| 群消息记录 | 机器人收到的群消息 | "这条消息机器人收到了吗" | 消息是否进入过处理 | 没有记录可能只是入口被开关拒绝,不代表消息不存在 |
| 触发记录(群聊监控) | 各群规则命中与动作明细 | "这条规则为什么命中/没命中" | 规则匹配与该功能的处理明细 | 不是全部功能的动作总账 |
查动作的完整核对路径见下文"查动作:审计日志与出站结果";触发记录见群聊监控。按现象排障的完整思路另见结果判断与排障。
怎么用
- 页面顶部有 导出日志、刷新 和 高级筛选(展开/收起)。
- 筛选条件:
- 时间范围:可手选起止时间,也可用"今日 / 昨日 / 近7天 / 近30天 / 本月"快捷项;
- 日志级别:可多选(信息 / 警告 / 错误 / 调试 / 致命);
- 关键词:同时匹配日志内容和模块名;
- 高级筛选:按模块(功能)精确筛选,或按日志中的用户 ID 精确筛选。
- 点 搜索 应用条件,点 重置 清空条件并重新加载。
- 日志统计:显示当前筛选条件下的匹配日志总数,以及错误、警告、信息条数。列表与统计一起查询;读取失败时会提示"获取日志数据失败",统计区显示"统计暂不可用"。此时列表可能为空,也可能保留上次查询结果,不能当作当前筛选条件下的结果。点 重试 重新查询,成功后再核对列表与统计,不要把空白当成 0。
- 下方列表按时间倒序排列,列为时间戳、级别、来源、模块、用户 ID、消息内容。点 查看详情 或双击某行可看完整消息与上下文;详情里可 复制日志内容 或 导出当前日志。
- 列表分页浏览(默认每页 20 条)。
查询上限与日志文件
- 页面单次查询最多保留最新 1000 条匹配记录;导出最多 10000 条。超过时页面会提示"已匹配 N 条……仅可浏览最新 M 条",此时请缩小时间范围或改用导出;更早的记录需要直接查看日志文件。
- 程序默认把运行日志写入程序运行目录下的
logs\datahub.log,按 50MB 轮转、保留 5 个备份、7 天后清理(具体由部署配置决定)。页面读取这批日志文件,但受上面的单次查询上限约束。异步写入缓冲满时可能丢弃日志,文件也不是逐条完整的业务账本。 - 本页只读,没有删除日志的入口;日志清理由轮转与保留策略负责。
查动作:审计日志与出站结果
这两个入口与应用日志同属 日志中心,作用不同。
- 在 审计日志 按操作、用户、时间查询,必要时展开更多筛选。这里的“本地群 ID”是数据库内部编号,不是 QQ 群号。点 查看详情 可看错误原因、原始记录与关联标识;“已受理(非平台终态)”不表示平台完成处罚或发送。
- 记录有 查看出站结果 时,可沿此入口继续查平台响应;没有关联标识,不代表动作一定未执行。出站页的事件群号表示事件来源,不一定是实际处罚或发送的目标群,不要与本地群 ID 互换。
- 调试 / 出站结果 只展示已记录的出站派发结果。详情中的成功、失败、未知或未记录应分别理解;没有终态不能猜成成功,也不能仅凭查不到就重发。
审计记录是持久保存的业务受理事实;出站追踪是短期进程内记录,可能因重启、保留时间或容量限制而消失。查询条件变化后若报错,先重试并核对当前条件,不把旧列表当成新查询结果。结果未知时同时核对平台和目标实际状态,但不能用“目标现在没变化”证明之前从未派发。
排障建议
- 想查某个时间点发生了什么:用时间范围或快捷项缩小范围,再配合关键词、模块筛选。
- 连接问题:搜
dial或连接配置名;看常见问题的"连接状态"条目。 - 处理动作没发生:先查 群消息记录(是否记录了输入),再查 审计日志(动作是否受理、失败原因);实际平台结果按上节核对,不把审计“已受理”当成执行成功。
- 看不到刚发生的一条:先点 刷新(页面不会自动轮询);调试日志量大时注意上面的查询上限。