产品动态
公告
IOS/Android 移动端网络探测接入指南
CLS 日志服务移动端 SDK 支持收集客户端本地网络及访问服务端网络链路信息进行上报。
使用场景
您可根据以下不同需求场景触发移动端 SDK 上报服务端网络链路信息：
客户端本地主动触发（用户无法登录时单击网络探测进行数据收集上报，同时提供 uuid 进行保障进行 troubleshooting）
游戏内事件触发（如登录时、开始战斗时等进行收集上报，用于统计大盘数据，也可用于玩家排障时的数据支撑）
服务端触发客户端上报（使用场景与客户端主动触发类似，只是时效性较差）
网络探测方式
主要用以下的几种方式进行网络探测：
Ping（ICMP）
TCP/UDP ping（发送相应协议）
Traceroute（探测客户端到服务端链路以及链路上的丢包）
IOS/Android SDK 上报网络链路日志
功能特点
异步写入，客户端线程无阻塞。
聚合&压缩
上传支持按超时时间、日志数、日志 size 聚合数据发送。支持 lz4 压缩。
缓存
支持设置缓存上限
超过上限后日志写入失败
核心上报架构
使用方法
IOS 移动端 SDK 上报网络链路日志 (含 Demo 及使用方法)
Android 移动端 SDK 上报网络链路日志 (含 Demo 及使用方法)
日志字段说明
公共字段
字段 | 含义 | 示例 |
access | 本次探测使用的网络 | Wi-Fi |
access_subtype | 本次探测使用的其他网络类型。当同时接入多个网络时，该字段才会有值 | ● Wi-Fi ● Android：3G/4G/5G ● iOS：cellular |
app_version | App 版本号 | 1.0.0 |
device_model | 设备模式 | - |
me | 移动用户身份标识 | - |
resolution | 屏幕分辨率 | 2476*1440 |
local_time | 本地时间 | 2023-02-01 20:58:00:332 |
root | 是否为 root 用户 | false |
app_id | App 包名 | - |
brand | 设备厂商信息 | google |
os | 操作系统 | Android |
utdid | 设备标识 | - |
os_version | 操作系统版本 | 13 |
reserve6 | 探测具体内容 | - |
reserves | 探测协议 | ● ping ● tcpping ● Traceroute |
app_name | App 名称 | test |
imei | 移动设备标识 | - |
local_timestamp | 本地时间戳 | 1675256280332 |
PING 探测
字段 | 含义 | 示例 |
method | 探测方式 | ping |
host_ip | 通过域名解析到的 IP 地址 | 192.0.65.112 |
host | 域名 | www.tencentcloud.com |
max | 最大延迟，单位：ms | 100.11 |
min | 最小延迟，单位：ms | 0.00 |
avg | 平均延迟，单位：ms | 74.51 |
stddev | 延迟标准差 | 20.00 |
loss | PING 包丢失次数 | 1 |
count | 探测次数，每次发一个 PING 包 | 10 |
size | PING 包字节数 | 64 |
responseNum | PING 包回应个数 | 9 |
interval | PING 包时间间隔，单位：ms | 200 |
timestamp | 本地时间戳。 | 1675256419 |
TCPPING 探测
字段 | 含义 | 示例 |
method | 探测方式 | TCPPING |
host_ip | 通过域名解析到的 IP 地址 | 192.0.65.112 |
host | 域名 | www.tencentcloud.com |
max | 最大延迟，单位：ms | 100.11 |
min | 最小延迟，单位：ms | 0.00 |
avg | 平均延迟，单位：ms | 74.51 |
stddev | 延迟标准差 | 20.00 |
loss | PING 包丢失次数 | 1 |
count | 探测次数，每次发一个 PING 包 | 10 |
size | PING 包字节数 | 64 |
sum | 本次探测总时间，单位：ms | 219.66 |
port | TCP 端口 | 88 |
timestamp | 本地时间戳 | 1675256419 |
Traceroute 探测
字段 | 含义 | 示例 |
method | 探测方式 | TRACEROUTE |
host_ip | 通过域名解析到的 IP 地址 | 192.0.65.112 |
host | 域名 | www.tencentcloud.com |
command_status | 探测请求状态 | success |
timestamp | 本地时间戳 | 1675256419 |
traceroute_node_results | TRACEROUTE 探测节点返回结果 | 列表内容见下文详细字段描述 |
traceroute_node_results
字段 | 含义 | 示例 |
targetIp | 某一跳的 IP 地址 | 43.152.65.112 |
hop | 某一跳的跳数，探测发起端为第0跳，越接近目的端跳数越大 | 1 |
avg_delay | 平均延迟 | 102 |
loss | 探测丢包次数 | 33 |
is_final_route | 是否是最终路径 | true |
single_node_list | 某单个节点的返回结果 | 列表见下文详细字段 |
single_node_results
字段 | 含义 | 示例 |
targetIp | 某一跳的 IP 地址 | 43.152.65.112 |
hop | 某一跳的跳数，探测发起端为第0跳，越接近目的端跳数越大 | 1 |
delay | 探测延迟 | 102 |
is_final_route | 是否是最终路径 | true |
status | 本次探测请求状态 | CMD_STATUS_FAILED/CMD_STATUS_SUCCESSFUL |
文档反馈