本文介绍网络探测数据字段的详细说明。
公共字段
字段 | 子字段 | 含义 | 示例 |
netInfo | defaultNet | 默认网络，同时接入多个网络时有意义。 例如同时接WiFi与蜂窝网络时，默认网络是WiFi。 | WiFi |
usedNet | 本次探测使用的网络。 |
| |
dns | 本次探测使用的网络对应的Local DNS（iOS技术原因获取的是默认网络的DNS)，探测时域名解析该DNS。 |
| |
client_ip | 本次探测使用的网络对应的公网出口IP地址。 | 192.0.2.0 | |
appInfo | appVersion | App版本号。 | 1.0.0 |
appName | App名称。 | test | |
appId | App包名。 | com.example.app | |
appVersionCode | App数字版本号，仅Android设备提供。 | 1.2.1 | |
deviceInfo | os_type | 操作系统 | Android |
osv | 操作系统版本。 | 12 | |
brand | 设备厂商信息 | samsung-SM-G985F | |
src | 无 | 目前探测发起方，仅有两个值。
| policy |
method | 无 | 探测协议。 | ping |
deviceId | 无 | 设备唯一标识，调用者可以自定义，默认由SDK产生，重装应用会有变化。 | 4CB61185--9061B374B4EF |
sdkver | 无 | SDK版本号。 | 0.1.7.0 |
sdkbuild | 无 | SDK编译时间。 | 11:35:57 Sep 23 2022 |
ts | 无 | 探测任务完成时间戳，毫秒级别。 | 1664249973523 |
trace_id | 无 | 探测任务唯一标识。 | a5bc****04f |
userEx | 无 | 用户自定义字段，字典格式。 | {"key1":"value1", "key2":"value2"} |
PING探测
字段 | 含义 | 示例 |
host | 域名。 | www.aliyun.com |
method | 探测方式，固定为ping。 | ping |
trace_id | 探测ID，探测任务的唯一标识。 | 无 |
host_ip | 通过域名解析到的IP地址。 | 192.0.2.1 |
timestamp | 本地时间戳。 | 1646652343000 |
interface | 本次探测使用的网络接口。
| 2G |
count | 探测次数，每次发一个PING包。 | 10 |
size | PING包字节数。 | 64 |
loss | PING包丢失次数。 | 1 |
min | 最小延迟。单位：ms。 | 200.11 |
max | 最大延迟。单位：ms。 | 600.01 |
avg | 平均延迟。单位：ms。 | 400.12 |
stddev | 延迟标准差。 | 20 |
total | 本次探测总时间。单位：ms。 | 3000.12 |
responseNum | PING包回应个数。 | 9 |
netInfo.dns | 当前网络接口的Local DNS服务器。 | 192.0.2.254,198.51.100.254 |
netInfo.defaultNet | 默认网络。 如果手机同时接入WiFi和4G网络，则默认为WiFi。如果只有4G网络，则默认为4G。 | WiFi |
TCPPING探测
字段 | 含义 | 示例 |
host | 域名。 | www.aliyun.com |
method | 探测方式，固定为tcpping。 | tcpping |
trace_id | 探测ID，探测任务的唯一标识。 | 无 |
host_ip | 通过域名解析到的IP地址。 | 192.0.2.11 |
port | TCP端口。 | 88 |
timestamp | 本地时间戳。 | 1646652343000 |
interface | 本次探测使用的网络接口。
| 2G |
count | 探测次数。 | 10 |
loss | 包丢失次数。 | 1 |
min | 最小延迟。单位：ms。 | 200.12 |
max | 最大延迟。单位：ms。 | 600.01 |
avg | 平均延迟。单位：ms。 | 400.12 |
stddev | 延迟标准差。 | 20 |
total | 本次探测总时间。单位：ms。 | 3000.12 |
responseNum | 包回应个数。 | 9 |
netInfo.dns | 当前网络接口的Local DNS服务器。 | 192.0.2.254,198.51.100.254 |
netInfo.defaultNet | 默认网络。 如果手机同时接入WiFi和4G网络，则默认为WiFi。如果只有4G网络，则默认为4G。 | WiFi |
MTR探测
字段 | 含义 | 示例 |
host | 域名。 | www.aliyun.com |
method | 探测方式，固定为mtr。 | mtr |
type | 定义本次上报数据是一条探测路径还是多条探测路径聚合的数据。当max_paths>1时有效。目前，默认值为all。 | all/path |
max_paths | 网络拓扑中两个点之间一般会有多条路径，这里指定本次探测的最大路径值。 | 1 |
paths[n].method | 探测方式，固定为mtr。 | mtr |
paths[n].type | 上报数据类型，固定为path。 | path |
paths[n].trace_id | 探测ID。 | 无 |
paths[n].host | 域名。 | www.aliyun.com |
paths[n].host_ip | 通过域名解析到的IP地址。 | 192.0.2.1 |
paths[n].path | 本次探测路径的唯一标识，格式为
| 192.0.2.10:42314-192.0.2.66:443 |
paths[n].lastHop | 本次MTR探测到达的最后一跳。 | 10 |
paths[n].timestamp | 本地时间戳。 | 1646652343000 |
paths[n].interface | 本次探测使用的网络接口。 · Android设备：2G、3G、4G、5G、WiFi。 · iOS设备：pdp_ip0（蜂窝网络）、en0（WiFi）。 | 2G |
paths[n].protocal | 探测协议。 | ICMP |
paths[n].results[n].loss | 某一跳的探测包丢失次数。 | 1 |
paths[n].results[n].responseNum | 某一跳的探测包响应次数。 | 6 |
paths[n].results[n].min | 某一跳的最小延迟。单位：ms。 | 200.11 |
paths[n].results[n].max | 某一跳的最大延迟。单位：ms。 | 600.01 |
paths[n].results[n].avg | 某一跳的平均延迟。单位：ms。 | 400.12 |
paths[n].results[n].stddev | 某一跳的延迟标准差。 | 20 |
paths[n].results[n].ip | 某一跳的IP地址。 | 192.0.2.11 |
paths[n].results[n].hop | 某一跳的跳数，探测发起端为第0跳，越接近目的端跳数越大。 | 3 |
netInfo.dns | 本次探测使用的网络接口的Local DNS服务器。 | 192.0.2.254,198.51.100.254 |
netInfo.defaultNet | 默认网络。 如果手机同时接入WiFi和4G网络，则默认为WiFi。如果只有4G网络，则默认为4G。 | WiFi |
HTTP探测
字段 | 含义 | 示例 |
URL | 探测的目标。 | https://www.example.com |
domain | 探测目标的域名。 | www.example.com |
remoteAddr | 通过探测目标域名解析的IP地址。 | 120.88.X.X |
httpCode | HTTP或HTTPS请求的响应码。 | 200 |
waitDnsTime | 探测任务调度等待时间，指任务发起到开始真正探测的间隔，可部分体现客户端繁忙程度。 | 11 |
dnsTime | 域名解析耗时。单位：ms。 | 9 |
tcpTime | TCP建连耗时。单位：ms。 | 32 |
SSLTime | SSL握手耗时。单位：ms。 | 69 |
firstByteTime | 从连接建立到收到首包之间的间隔。 | 356 |
allByteTime | 从连接建立到收到所有响应之间的间隔 | 556 |
requestTime | 探测整体耗时。单位：ms。 | 685 |
sendBytes | 发送的字节数。 | 88 |
receiveBytes | 接收到的字节数。 | 46627 |
httpProtocol | 探测使用的HTTP协议版本。 | h2 |
reuse | 本次是否复用了连接。 | false |
desc | HTTP框架返回的本次请求的一些详细信息。 | 无 |