日志字段与导出:18 个字段、3 种格式的读法与用法
18 个日志字段按时间、连接、网络、环境四类分组,导出支持 txt、json、csv 三种格式,并先剥离账号与口令。
日志字段名保持小写英文,便于 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 / error | error |
code | 字符串 | 四位错误码,无错误时为空 | E2007 |
iface | 字符串 | 虚拟网卡名 | kvpn0 |
proto | 字符串 | 传输协议 udp / tcp | udp |
port | 整数 | 本地代理端口 | 10808 |
state | 字符串 | 隧道状态 connecting / up / down | up |
网络类(4 个)
| 字段名 | 类型 | 说明 | 示例值 |
|---|---|---|---|
rtt_ms | 整数 | 最近握手往返时延 | 47 |
retry | 整数 | 连续重试次数 | 3 |
loss_pct | 浮点 | 数据面丢包率,百分数 | 0.4 |
dns_ms | 整数 | 最近一次 DNS 解析耗时 | 23 |
环境类(3 个)
| 字段名 | 类型 | 说明 | 示例值 |
|---|---|---|---|
os | 字符串 | 操作系统标识 | Windows 11 23H2 |
ver | 字符串 | 客户端版本号 | 6.x |
arch | 字符串 | 系统架构 x64 / arm64 | x64 |
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- 2026-09-14 21:07:12.483
ts=21:07:12.483seq=882state=connectingproto=udp - 2026-09-14 21:07:13.102
code=E2002dns_ms=1600retry=1 - 2026-09-14 21:07:15.220
code=E2007rtt_ms=空loss_pct=0 - 2026-09-14 21:07:17.831
state=upiface=kvpn0rtt_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 为可读文本,不建议程序化解析。
拿到诊断模块后,先从下载页开始
确认客户端内置诊断入口与导出能力,再回来看字段表。