Pings
GET
/api/v1/pings读取指定 VPS Agent 从自身网络位置发起的 TCP Ping 历史。它用于观察节点侧网络质量，不是 Cloudflare 延迟，也不是外部 Latency Agent 数据。
查询参数
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
agent_id | 是 | 空 | 执行 Ping 的 Agent ID |
hours | 否 | 24 | 默认最大 72 小时，部署上限不超过 168 小时 |
max_points_per_target | 否 | 360 | 每个 Ping 目标最多点数；非正值使用默认值 |
format | 否 | 行格式 | series 返回按目标分组的紧凑序列 |
bash
curl -fsSL 'https://YOUR-API/api/v1/pings?agent_id=vps-a&hours=6&max_points_per_target=360'响应字段
| 字段 | 说明 |
|---|---|
targets[] | 当前启用的 Ping 目标 ID 与名称 |
pings[] | 行格式历史点；format=series 时为空 |
series | 按目标组织的紧凑序列 |
pings_raw_count | 降采样前总点数 |
pings_downsampled | 是否已按目标降采样 |
source | 当前历史来源 |
单个行格式点包含 target_id、ts、latency_ms 与 ok。失败点的 latency_ms 可以为 null。
展示建议
- 图例使用
targets[]中的显示名称，数据关联使用 ID； - 每个目标独立排序、独立处理缺口；
ok = 0显示断点或故障标记，不写成 0 ms；- Agent 离线期间没有新 Ping 是正常现象；
- 不要把 Pings 与 Checks 合并为一条没有来源说明的曲线。