本文介绍网络探测数据字段的详细说明。

公共字段

字段 子字段 含义 示例
netInfo defaultNet 默认网络,同时接入多个网络时有意义。

例如同时接WiFi与蜂窝网络时,默认网络是WiFi。

WiFi
usedNet 本次探测使用的网络。
  • WiFi
  • Android:3G/4G/5G
  • iOS: cellular
dns 本次探测使用的网络对应的Local DNS(iOS技术原因获取的是默认网络的DNS),探测时域名解析该DNS。
  • WiFi :30.30.30.30,fd00:1::1
  • 蜂窝网络:189.40.198.94,189.40.198.80,2804:214:8000:ffff::94,2804:214:8000:ffff::80
client_ip 本次探测使用的网络对应的公网出口IP地址。 192.0.2.0
appInfo appVersion App版本号。 1.0.0
appName App名称。 test
appId App包名。
appVersionCode App数字版本号,仅Android设备提供。
deviceInfo os_type 操作系统 Android
osv 操作系统版本。 12
brand 设备厂商信息 samsung-SM-G985F
src 探测发起方。
  • 控制台策略:policy。
  • 客户端业务主动发起:app。
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 本次探测使用的网络接口。
  • Android设备:2G、3G、4G、5G、WiFi。
  • iOS设备:pdp_ip0(蜂窝网络)、en0(WiFi)。
2G
count 探测次数,每次发一个PING包。 10
size PING包字节数。 64
loss PING包丢失次数。 1
min 最小延迟。单位:ms。 200
max 最大延迟。单位:ms。 600
avg 平均延迟。单位:ms。 400
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 本次探测使用的网络接口。
  • Android设备:2G、3G、4G、5G、WiFi。
  • iOS设备:pdp_ip0(蜂窝网络)、en0(WiFi)。
2G
count 探测次数。 10
loss 包丢失次数。 1
min 最小延迟。单位:ms。 200
max 最大延迟。单位:ms。 600
avg 平均延迟。单位:ms。 400
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 本次探测路径的唯一标识,格式为源IP地址:源端口-目的IP地址:目的端口 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
paths[n].results[n].max 某一跳的最大延迟。单位:ms。 600
paths[n].results[n].avg 某一跳的平均延迟。单位:ms。 400
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地址。
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框架返回的本次请求的一些详细信息。