# 服务与集群状态

接入真实监控源，展示集群健康和负载。

## 查看服务状态 [#查看服务状态]

[公开状态页](/status)包含“全球网络”和“运行状态”两个视图。

- **全球网络**：在交互式地球上浏览 58 个城市节点，按地区筛选节点目录，查看最近 120 秒的趋势和请求流水。
- **运行状态**：与控制台“服务与集群状态”使用相同的真实监控接口。未接入时显示“监控尚未接入”，不会用展示模型的数据填充真实监控。

有有效监控配置时默认打开“运行状态”，否则默认打开“全球网络”。真实监控故障不会自动切换到全球网络的展示指标。

## 可视化数据接口 [#可视化数据接口]

`GET /api/platform/status-demo` 返回 `source: "demo"` 的独立快照，包含 `generatedAt`、请求量 `qpm`、近 24 小时字符数 `chars24h`、成功率 `okRate`、`avgLatency`、`p95`、`nodes`、`history` 和 `feed`。请求流水仅包含合成的语种代码、场景、字符数及耗时，不包含用户内容。

该模型参考旧站的昼夜流量曲线与负载关系。同一时间点生成相同数据，服务端每 5 秒共享一份快照，刷新页面不会随机重置指标。历史窗口为最近 120 个一秒采样点，流水为 14 条合成事件，事件时间使用 ISO 格式。

浏览器每 5 秒更新可视化数据；后台标签页停止轮询，失败时明确显示数据更新异常，不将旧快照表述为最新数据。地球动效遵循系统减少动态效果设置。该接口不读取旧服务器、不携带监控凭据，也不执行任何外部 URL 请求。

## 监控源协议 [#监控源协议]

管理员在服务端配置 `STATUS_TARGETS_JSON`。每项包含 `id`、`name`、`region`、HTTPS `endpoint`，以及可选的 `tokenEnv`（存放访问 token 的环境变量名称）。最多配置 12 个唯一监控目标。

```json
[
  {
    "id": "asr-primary",
    "name": "ASR 主集群",
    "region": "华东",
    "endpoint": "https://your-monitoring.example/elejo/asr",
    "tokenEnv": "ASR_MONITOR_TOKEN"
  }
]
```

监控端点应返回以下格式。示例数值仅为协议说明，不是当前服务器数据：

```json
{
  "status": "operational",
  "metrics": {
    "healthyNodes": 3,
    "totalNodes": 3,
    "queueDepth": 0,
    "utilization": 42
  }
}
```

`status` 支持 `operational`、`degraded`、`outage`。metrics 可省略，界面将显示“—”。健康节点不能超过总节点数，利用率范围为 0–100。

## 公共读取接口 [#公共读取接口]

`GET /api/platform/status` 返回规范化后的服务状态，隐藏内部监控 URL、凭据与原始响应。公网可见名称与 region 应使用服务级标签，不要包含敏感主机信息。

每个监控请求超时 3 秒，拒绝重定向，响应上限 8 KiB，服务端缓存最长 30 秒，前端每 60 秒更新。监控错误或不可达显示 `unknown`，不能据此推断业务集群一定宕机。

## 接入 Prometheus 或其他监控系统 [#接入-prometheus-或其他监控系统]

在内部部署适配端点，将现有指标映射到上述协议。不要直接暴露 Prometheus 查询接口或运维凭据。目标地址仅由可信部署管理员设置，不能接受来自公开用户输入的 URL。

本版提供瞬时状态与指标，不提供历史可用率或 SLA 统计。展示的监控响应时间不代表模型推理延迟。
