日志与诊断包

六个日志频道怎么选、怎么按级别和模块筛、怎么导出;出问题时按清单收集材料交给技术支持。

  • 入门
  • 动手约 10 分钟
  • 阅读 3 分钟
  • 更新于 2026-11-09

你将完成

读完本篇你将完成:

  • 在六个日志频道之间切换,按级别、模块、时间、关键字筛选;
  • 打开单条日志看完整上下文;
  • 导出 CSV / 下载原始日志,按清单把「诊断包」交给技术支持。

开始之前

  • 用管理员或有日志权限的账号登录;
  • 出现过一次异常(哪怕只是页面报错),有东西可查。

六个频道各记什么#

菜单 系统管理 → 日志管理(路由 #/ops/logs)。顶部页签即频道:

频道收录内容
网关日志采集引擎推送的 WARN 及以上级别日志;无告警时为空属正常
运行日志服务运行的常规过程日志
操作日志用户在界面上的操作留痕(与审计日志互补)
安全日志登录尝试、鉴权失败等安全事件
系统日志系统级事件
登录日志每次登录 / 登出 / 刷新令牌:用户名、结果、来源 IP、失败原因

切换频道并筛选#

点页签切到目标频道(示例为「操作日志」),顶部工具条控制实时跟随、全屏、导出等。

顶部频道页签:切换日志频道
  1. 1切频道

左侧筛选栏:

  • 关键字搜索:匹配消息 / 模块 / 来源;
  • 级别筛选:信息(INFO)/ 警告(WARN)/ 错误(ERROR),点击切换,各带计数;
  • 模块 / 设备来源:从当前结果自动聚合并计数;
  • 时间范围:开始 / 结束时间。
筛选栏:级别筛选、模块与设备来源聚合、时间范围
  1. 1级别筛选:信息 / 警告 / 错误,点击切换
  2. 2时间范围 + 模块 / 设备来源聚合

跟住最新日志#

打开 实时跟随,新日志自动滚到底部;翻到上面看历史时会暂停跟随,右侧出现「+N 条新日志」按钮,点它跳回底部。

看单条详情#

点击任意一行打开详情:级别、模块、来源、时间、完整消息,基本信息(编号、通道、来源 IP、Trace ID)与扩展字段。详情下方还有同一请求 / 同一次触发的日志一节,把相同 Trace ID 的日志按时间列在一起——排查时顺着这个编号看,一次请求的前因后果一屏串完(本页截图只截到基本信息)。

日志详情:完整消息 + 基本信息(含 Trace ID)
  1. 1基本信息:编号、通道、来源 IP、Trace ID
  2. 2Trace ID:串起同一次请求的全部日志

导出与下载#

  • 导出 CSV:按当前频道与筛选导出,生成任务后在后台跑,完成后自动下载;
  • 原始:全屏原始日志流(AI 监控视图),可 复制全部 或 下载 .log(文件名形如 gateway-logs-<时间戳>.log,默认保留最后 2000 行)。

日志设置#

工具栏 设置 打开:

日志设置:保留时长、刷新频率、显示密度
  1. 1保留时长:超期日志自动清理
  2. 2实时刷新频率与显示密度
设置项默认值说明
保留时长30 天超期自动清理
缓存条数上限5000 条页面最多缓存 10000 条
实时刷新频率2500 毫秒实时跟随的拉取间隔
显示密度舒适模式可切紧凑模式
默认开启实时跟随开进页面自动滚到底部
显示 DEBUG 级别关仅深度排查时打开

出问题时,给技术支持什么#

先收集,再重启

重启会冲掉现场状态。按下面清单收集完材料,再做重启或清空。

按顺序准备四样东西,缺一项都可能要来回多轮:

  1. 现象描述:哪个页面、什么操作、报什么错、从几点开始、能不能复现;
  2. 时间点与账号:精确到分,以及当时用的是哪个账号;
  3. Trace ID:从审计日志详情或日志详情里复制;
  4. 日志材料:
    • 对应时间段的 CSV 导出(筛好级别与模块再导);
    • 有报错弹窗就截屏;涉及采集网关的再下载 原始 .log。

清空要谨慎

清空按钮会删除当前频道的全部日志且不可恢复。排查没结束不要清;日常也不需要手动清——保留时长会自动清理。

常见问题#

「网关日志」一直是空的#

它只收录采集引擎的 WARN 及以上级别。采集一切正常时为空,不是故障。

查询失败提示重试#

先看网络配置与诊断确认服务可达,页面会自动重试;持续失败时把错误横幅的文字一并截给技术支持。

实时跟随偶尔停了#

页面切到后台时自动暂停,回到页面恢复;设置了时间范围筛选时不做实时跟随。

下一步#

这篇文档对你有帮助吗?