本文介紹網絡探測數據字段的詳細說明。
公共字段
字段 | 子字段 | 含義 | 示例 |
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框架返回的本次請求的一些詳細信息。 | 無 |