mirror of
https://github.com/fawney19/Aether.git
synced 2026-10-08 18:37:46 +08:00
38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
# 提供商管理的端点健康度
|
|
|
|
以下管理接口使用相同的健康度汇总规则：
|
|
|
|
- `GET /api/admin/providers/summary`
|
|
- `GET /api/admin/providers/{provider_id}/summary`
|
|
|
|
## 统计规则
|
|
|
|
- 仅统计启用端点下、支持该端点 API 格式的启用密钥。
|
|
- 每个密钥读取其 `health_by_format[api_format].health_score`，不跨格式借用分数。
|
|
- 只对已有的有效健康分数求算术平均；没有健康数据的密钥不按满分计入。
|
|
- 分数范围为 `0` 到 `1`，沿用调度器的分数读取与范围约束。
|
|
- 停用端点、没有启用密钥或没有有效健康分数时，端点的 `health_score` 返回 `null`。
|
|
- `avg_health_score` 仅平均有有效健康数据的启用端点；没有此类端点时返回 `null`。
|
|
- `unhealthy_endpoints` 仅统计上述端点中健康度低于 `0.5` 的数量，不把未知状态算作故障。
|
|
|
|
`total_keys` 和 `active_keys` 仍反映密钥配置数量，不因缺少健康数据而减少。
|
|
|
|
## 数据读取
|
|
|
|
摘要从密钥的轻量投影读取 API 格式、启用状态和 `health_by_format`。
|
|
PostgreSQL 投影中的凭据字段使用 `summary` / `{}` 等脱敏占位值，并非真实密文，
|
|
因此摘要读取不执行凭据解密、认证或迁移。完整密钥读取仍保留原有的凭据安全校验。
|
|
|
|
若将这些占位值送入凭据校验，读取会失败，并被摘要聚合当作空密钥列表，
|
|
导致已配置密钥的端点也被错误显示为灰色；不能通过给缺失分数默认填 `100%` 来修复。
|
|
|
|
## 页面展示
|
|
|
|
桌面表格和手机卡片使用相同规则：
|
|
|
|
- 有健康数据时显示百分比；有效的零分显示 `0%`。
|
|
- 无健康数据时显示灰色占位条和 `-`，提示“暂无健康数据”，不显示 `100%` 或 `0%`。
|
|
- 端点停用、未配置密钥或没有启用密钥时显示灰色占位条和对应状态提示。
|
|
|
|
此分数是密钥当前健康状态的聚合，不是某个时间窗口内的请求成功率，也不是主动探测结果。
|