## 节点监控日志 (`monitor-logs`)

主控对开启监控的节点 IP 每轮探测的结果记录。

鉴权: 仅管理员 · 文档: https://www-demo.kuxitong.com/zh/docs/api/monitor-logs

### GET `/api/v2/monitor-logs`

列出节点监控探测日志 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `page` | integer |  | 页码,从 1 开始。 默认: 1 |
| `page_size` | integer |  | 每页条数。 默认: 20 |
| `node_id` | integer |  | 按节点过滤。 |
| `ip` | string |  | 按 IP 过滤(精确匹配)。 |
| `result` | integer |  | 按结果过滤:1 通;0 不通;-1 判不了。 可选值: [-1,0,1] |
| `type` | string |  | 按类型过滤:aval 可用性探测;bw 带宽采样。不给 = 全部。 可选值: ["aval","bw"] |
| `probe_group` | string |  | 按监控组过滤(外部探测服务回的监控组,精确匹配);空串 = 主控内建探测的行。不给 = 全部。 |
| `since` | string |  | 起始时间(含),RFC 3339。 |
| `until` | string |  | 截止时间(不含),RFC 3339。 |

```sh
curl "https://panel.example.com/api/v2/monitor-logs" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

节点监控日志对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `created_at` | string |  | 创建时间 |
| `detail` | string |  | 不通/判不了的原因。 |
| `id` | integer |  | 记录 ID |
| `ip` | string |  | 被探测的 IP。 |
| `node_id` | integer |  | 节点 ID |
| `result` | integer |  | 1 通;0 不通;-1 判不了(http 5xx、整轮全不通等,不参与判定)。 可选值: [-1,0,1] |
| `round_id` | integer |  | 探测轮次(同一轮同值)。 |
| `type` | string |  | aval 可用性探测(主控或外部探测服务);bw 带宽采样(每分钟一条,出站不低于上限记 0)。 可选值: ["aval","bw"] |