## 告警记录 (`alerts`)

最近的告警与恢复记录,保留 30 天。

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

### GET `/api/v2/alerts`

列出最近告警与恢复记录 · 鉴权: 仅管理员

查询参数:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `page` | integer |  | 页码,从 1 开始。 默认: 1 |
| `page_size` | integer |  | 每页条数。 默认: 20 |
| `rule` | string |  | 按规则名过滤。 |
| `kind` | AlertKind |  | 按种类过滤:fire 告警;resolve 恢复。 可选值: ["fire","resolve"] |

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

告警记录对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `created_at` | string |  | 创建时间 |
| `detail` | string |  | 补充说明。 |
| `id` | integer |  | 记录 ID |
| `kind` | AlertKind |  | fire 告警;resolve 恢复。 可选值: ["fire","resolve"] |
| `msg_id` | integer |  | 发出的通知(站内信 id)。 |
| `rule` | string |  | 告警规则标识。 |
| `subject` | string |  | 告警针对的对象,如节点或站点。 |
| `threshold` | number |  | 规则的阈值。 |
| `title` | string |  | 规则中文名(规则已不在表里时同 rule)。 |
| `unit` | string |  | 数值与阈值的单位。 |
| `value` | number |  | 触发告警的当前值。 |