ELEJO DOCUMENTATION

服务与集群状态

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

查看服务状态

公开状态页包含“全球网络”和“运行状态”两个视图。

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

可视化数据接口

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 个唯一监控目标。

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

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

{
  "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 查询接口或运维凭据。目标地址仅由可信部署管理员设置,不能接受来自公开用户输入的 URL。

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

需要帮助?在控制台提交技术工单,并注明平台与版本。