日志与诊断包
六个日志频道怎么选、怎么按级别和模块筛、怎么导出;出问题时按清单收集材料交给技术支持。
你将完成
读完本篇你将完成:
- 在六个日志频道之间切换,按级别、模块、时间、关键字筛选;
- 打开单条日志看完整上下文;
- 导出 CSV / 下载原始日志,按清单把「诊断包」交给技术支持。
开始之前
- 用管理员或有日志权限的账号登录;
- 出现过一次异常(哪怕只是页面报错),有东西可查。
六个频道各记什么#
菜单 系统管理 → 日志管理(路由 #/ops/logs)。顶部页签即频道:
| 频道 | 收录内容 |
|---|---|
| 网关日志 | 采集引擎推送的 WARN 及以上级别日志;无告警时为空属正常 |
| 运行日志 | 服务运行的常规过程日志 |
| 操作日志 | 用户在界面上的操作留痕(与审计日志互补) |
| 安全日志 | 登录尝试、鉴权失败等安全事件 |
| 系统日志 | 系统级事件 |
| 登录日志 | 每次登录 / 登出 / 刷新令牌:用户名、结果、来源 IP、失败原因 |
切换频道并筛选#
点页签切到目标频道(示例为「操作日志」),顶部工具条控制实时跟随、全屏、导出等。
- 1切频道
左侧筛选栏:
- 关键字搜索:匹配消息 / 模块 / 来源;
- 级别筛选:信息(INFO)/ 警告(WARN)/ 错误(ERROR),点击切换,各带计数;
- 模块 / 设备来源:从当前结果自动聚合并计数;
- 时间范围:开始 / 结束时间。
- 1级别筛选:信息 / 警告 / 错误,点击切换
- 2时间范围 + 模块 / 设备来源聚合
跟住最新日志#
打开 实时跟随,新日志自动滚到底部;翻到上面看历史时会暂停跟随,右侧出现「+N 条新日志」按钮,点它跳回底部。
看单条详情#
点击任意一行打开详情:级别、模块、来源、时间、完整消息,基本信息(编号、通道、来源 IP、Trace ID)与扩展字段。详情下方还有同一请求 / 同一次触发的日志一节,把相同 Trace ID 的日志按时间列在一起——排查时顺着这个编号看,一次请求的前因后果一屏串完(本页截图只截到基本信息)。
- 1基本信息:编号、通道、来源 IP、Trace ID
- 2Trace ID:串起同一次请求的全部日志
导出与下载#
- 导出 CSV:按当前频道与筛选导出,生成任务后在后台跑,完成后自动下载;
- 原始:全屏原始日志流(AI 监控视图),可 复制全部 或 下载 .log(文件名形如
gateway-logs-<时间戳>.log,默认保留最后2000行)。
日志设置#
工具栏 设置 打开:
- 1保留时长:超期日志自动清理
- 2实时刷新频率与显示密度
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 保留时长 | 30 天 | 超期自动清理 |
| 缓存条数上限 | 5000 条 | 页面最多缓存 10000 条 |
| 实时刷新频率 | 2500 毫秒 | 实时跟随的拉取间隔 |
| 显示密度 | 舒适模式 | 可切紧凑模式 |
| 默认开启实时跟随 | 开 | 进页面自动滚到底部 |
| 显示 DEBUG 级别 | 关 | 仅深度排查时打开 |
出问题时,给技术支持什么#
先收集,再重启
重启会冲掉现场状态。按下面清单收集完材料,再做重启或清空。
按顺序准备四样东西,缺一项都可能要来回多轮:
- 现象描述:哪个页面、什么操作、报什么错、从几点开始、能不能复现;
- 时间点与账号:精确到分,以及当时用的是哪个账号;
- Trace ID:从审计日志详情或日志详情里复制;
- 日志材料:
- 对应时间段的 CSV 导出(筛好级别与模块再导);
- 有报错弹窗就截屏;涉及采集网关的再下载 原始 .log。
清空要谨慎
清空按钮会删除当前频道的全部日志且不可恢复。排查没结束不要清;日常也不需要手动清——保留时长会自动清理。
常见问题#
「网关日志」一直是空的#
它只收录采集引擎的 WARN 及以上级别。采集一切正常时为空,不是故障。
查询失败提示重试#
先看网络配置与诊断确认服务可达,页面会自动重试;持续失败时把错误横幅的文字一并截给技术支持。
实时跟随偶尔停了#
页面切到后台时自动暂停,回到页面恢复;设置了时间范围筛选时不做实时跟随。
下一步#
这篇文档对你有帮助吗?