docs(admin): update dashboard and operations API references

- Add dashboard alerts, realtime, and apikey-stats endpoints
- Document time range parameters for logs and apikey-stats
- Update daily operations workflow with new monitoring endpoints
- Clarify period parameter behavior (default returns all data)
This commit is contained in:
zenfun
2025-12-31 14:38:07 +08:00
parent dab07caca2
commit 6cab7e257a
2 changed files with 11 additions and 5 deletions

View File

@@ -9,7 +9,9 @@
| 页面 | 接口 | 交互要点 |
| --- | --- | --- |
| Dashboard / 全局概览 | `GET /admin/stats` | 展示全局统计指标 |
| Dashboard / 全局概览 | `GET /admin/dashboard/summary` `GET /admin/realtime` `GET /admin/stats` | 聚合指标、实时 QPS、传统统计 |
| Dashboard / 告警 | `GET /admin/alerts` `GET /admin/alerts/stats` `POST /admin/alerts/:id/ack` `POST /admin/alerts/:id/resolve` | 告警列表、统计、确认、解决 |
| Dashboard / 上游凭证统计 | `GET /admin/apikey-stats/summary` | 上游 API Key 成功率统计,支持时间范围 |
| 操作日志 | `GET /admin/operation-logs` | 管理员操作审计 |
| 租户Masters列表 | `GET /admin/masters` `POST /admin/masters` `POST /admin/masters/batch` | 列表 + 批量操作 |
| 租户详情 | `GET /admin/masters/:id` `PUT /admin/masters/:id` `DELETE /admin/masters/:id` | 查看/编辑/删除 |
@@ -47,7 +49,9 @@
4. `PUT /admin/keys/:id/access` 细化 Key 的访问范围(可选)。
### 日常运维
1. `GET /admin/logs` + `GET /admin/logs/stats` 查询异常与用量。
1. `GET /admin/logs` + `GET /admin/logs/stats` 查询异常与用量(支持 `group_by=hour|minute`
2. `PUT /admin/logs/webhook` 配告警;`DELETE /admin/logs` 清理。
3. `GET /admin/stats``GET /admin/masters/:id/realtime` 查看实时指标。
4. `PUT /admin/features` 调整 DP 开关;必要时 `POST /admin/sync/snapshot` 手动同步。
3. `GET /admin/dashboard/summary``GET /admin/realtime``GET /admin/masters/:id/realtime` 查看实时指标。
4. `GET /admin/alerts` + `GET /admin/alerts/stats` 查看系统告警;`POST /admin/alerts/:id/ack` 确认告警。
5. `GET /admin/apikey-stats/summary` 查看上游凭证成功率(支持 `since/until` 时间范围)。
6. `PUT /admin/features` 调整 DP 开关;必要时 `POST /admin/sync/snapshot` 手动同步。