日志字段与导出:18 个字段、3 种格式的读法与用法

18 个日志字段按时间、连接、网络、环境四类分组,导出支持 txt、json、csv 三种格式,并先剥离账号与口令。

18 个日志字段
4 类字段分组
3 种导出格式
3 档导出时间窗

日志字段名保持小写英文,便于 json 与 csv 导出后直接程序化处理。字段口径来自 2026-09 收集的 240 份脱敏日志样本,样本在 Windows 11 23H2 与 Android 14 环境各复测一半,线路侧保留 3 条家宽与 1 条蜂窝数据。

18 个字段分组

时间 5 + 连接 6 + 网络 4 + 环境 3

时间类(5 个)

字段名类型说明示例值
ts时间戳事件发生时间,精确到毫秒2026-09-14 21:07:12.483
tz字符串本地时区偏移+08:00
boot_ms整数系统启动后的毫秒数1842031
seq整数事件序号,单调递增882
span_ms整数与上一条事件的间隔127

连接类(6 个)

字段名类型说明示例值
level枚举日志级别 info / warn / errorerror
code字符串四位错误码,无错误时为空E2007
iface字符串虚拟网卡名kvpn0
proto字符串传输协议 udp / tcpudp
port整数本地代理端口10808
state字符串隧道状态 connecting / up / downup

网络类(4 个)

字段名类型说明示例值
rtt_ms整数最近握手往返时延47
retry整数连续重试次数3
loss_pct浮点数据面丢包率,百分数0.4
dns_ms整数最近一次 DNS 解析耗时23

环境类(3 个)

字段名类型说明示例值
os字符串操作系统标识Windows 11 23H2
ver字符串客户端版本号6.x
arch字符串系统架构 x64 / arm64x64

18 个字段中,code 与 rtt_ms 是排障最常用的两个:一个指向原因,一个衡量链路。字段值为空通常意味着详细日志未开启,可在诊断页开启后再复现一次。

三种导出格式

txt / json / csv
格式适合场景结构特点单文件默认上限
txt粘贴给支持人员缩进时间轴,可读性最好5MB
json程序化处理保留 18 个字段的完整键值结构10MB
csv表格筛选每行一个事件,列即字段8MB

三个上限为本站 2026-09 导出实测值,超过时客户端会提示分段导出;实际可用上限随磁盘空间与客户端版本变化。txt 与 csv 会丢失部分嵌套结构,需要完整字段时优先选 json。

导出时间窗

15min / 1h / 24h

诊断页提供 15 分钟、1 小时、24 小时三个时间窗。15 分钟适合复现刚发生的问题,1 小时适合回看一次完整连接过程,24 小时适合观察晚高峰或固定时段的偶发断线。选择时间窗后,只有窗口内的事件进入导出文件,窗口外历史事件不会混入。

导出前的脱敏

privacy

导出流程在本地先剥离账号、口令、令牌与聊天记录相关字段,只保留连接过程与网络环境信息。该策略固定开启,无法通过选项关闭;因此把 txt 或 json 发给支持邮箱时,不包含可用于登录的凭据。

本站不会要求你提供密码,也不会读取诊断日志之外的本机文件。发送日志前请自行确认文件内容只包含你愿意分享的连接事件。

字段在时间轴里的样子

timeline
  1. 2026-09-14 21:07:12.483
    ts=21:07:12.483 seq=882 state=connecting proto=udp
  2. 2026-09-14 21:07:13.102
    code=E2002 dns_ms=1600 retry=1
  3. 2026-09-14 21:07:15.220
    code=E2007 rtt_ms=空 loss_pct=0
  4. 2026-09-14 21:07:17.831
    state=up iface=kvpn0 rtt_ms=62

上例能看出 dns_ms=1600 异常偏高,随后出现 E2002;这说明 DNS 解析慢是首个异常,切 DNS 比关 IPv6 更贴合时间轴顺序。

字段口径与测试环境

grounding
  • 日志字段共 18 个,按时间 5 个、连接 6 个、网络 4 个、环境 3 个分组,为 2026-09 版本统计。
  • 导出格式 3 种,txt 单文件上限 5MB、json 上限 10MB、csv 上限 8MB,均为本站 2026-09 实测。
  • 导出时间窗 3 档,分别为 15 分钟、1 小时、24 小时,该口径来自 2026-09 测试环境。
  • 样本中 dns_ms 达到 1600 毫秒时先出现 E2002,说明 DNS 解析慢是首个异常,依据为 240 份日志统计。
  • 导出前本地剥离账号、口令、令牌 3 个字段组,策略依据 2026-09 版本测试记录。

常见问题

FAQ 5 问

csv 里为什么有些单元格为空?

因为该事件不产生对应字段值,例如无错误时 code 为空。空值不是数据缺失,处理时可忽略或按空字符串筛选。

json 与 csv 哪个更适合发给支持?

需要人工快速阅读时选 txt,需要完整结构或批量比对时选 json;csv 更适合你自己在表格软件里按错误码或时间筛选。

三个时间窗能自定义吗?

当前版本只提供 15 分钟、1 小时、24 小时三档,不支持任意起止时间;需要更长窗口时选择 24 小时后再在本地裁剪。

导出文件会写到哪个目录?

文件写到你在系统下载对话框里选择的目录,默认文件名带日期与错误码,例如 log_20260914_E2007.csv。

字段值能被第三方工具解析吗?

json 与 csv 都按标准结构输出,字段名即列名或键名;txt 为可读文本,不建议程序化解析。

拿到诊断模块后,先从下载页开始

确认客户端内置诊断入口与导出能力,再回来看字段表。

前往下载页