字段分为三组:标识类 5 个、状态类 5 个、归属类 4 个,采集来源与刷新周期各不相同。
| 序号 | 字段 | 含义 | 采集来源与周期 |
|---|---|---|---|
| 1 | device_id | 设备唯一编号 | 下发时生成,永久不变 |
| 2 | device_fingerprint | 设备指纹 | 客户端 v4.2.0 本地生成 |
| 3 | group_name | 所属分组 | 下发批次决定 |
| 4 | route_line | 使用的线路编号 | 客户端上报 |
| 5 | protocol | 所用协议 | 客户端上报 |
| 6 | online_state | 当前在线状态 | 每分钟 1 次心跳 |
| 7 | last_online_time | 最后上线时间 | 心跳中断时写入 |
| 8 | client_version | 客户端版本 | 每 60 秒上报一次 |
| 9 | traffic_gb | 本账期已用流量 | 每分钟 1 次采样累计 |
| 10 | avg_latency_ms | 平均延迟 | 探针每分钟 1 次采样 |
| 11 | config_template | 当前配置模板 | 下发成功后写入 |
| 12 | subscription_owner | 订阅归属 | 成员与席位关系推导 |
| 13 | billing_cycle | 所属账期 | 按 30 天账期切分 |
| 14 | ticket_count | 关联工单数 | 工单创建接口回调 |


并发限制同时存在于任务层与线路层,两者取更小值生效,避免单条线路被单个客户的批量任务占满。
| 层级 | 上限 | 统计维度 | 超限表现 |
|---|---|---|---|
| 批量任务并发 | 200 台 | 同一批次的在线设备数 | 返回 KL_CONCURRENCY_EXCEEDED |
| 专属线路并发 | 200 条 | 单条线路的连接数 | 新连接进入排队 |
| 客户端心跳采样 | 每分钟 1 次 | 单台设备 | 连续缺失 3 次标记离线 |
指纹由客户端在 v4.2.0 版本中生成,采集硬件与系统特征组合,同一台机器重复安装保持不变。
{
"filter": { "group_name": "shanghai-office", "online_state": "offline" },
"fields": ["device_id", "device_fingerprint", "last_online_time", "subscription_owner"],
"limit": 200
}延迟数据来自探针,探针每分钟采样 1 次,连续 7 天产生 10080 个采样点,统计口径在企业版内保持一致。
| 线路分区 | 采样点 | 延迟均值 | 最高区间 |
|---|---|---|---|
| 欧洲线路 8 条 | 10080 个 | 186 毫秒 | 262 毫秒 |
| 亚太线路 4 条 | 10080 个 | 92 毫秒 | 148 毫秒 |
| 全部分区 | 10080 个 | 139 毫秒 | 262 毫秒 |
均值按算术平均计算,异常抖动样本不剔除;台账中的 avg_latency_ms 字段保存的是该设备 30 天账期内的累计平均值。
导出用于内部核对与审计举证,格式统一为 CSV,带 UTF-8 编码标记以便直接用表格软件打开。
台账核对无误后,可以进入计费与问题排查环节。