公开状态页面 (/status)
http://[서버IP]/status 是一个无需登录即可访问的可用性页面。
此页面的设计目的是，即使无法进入控制台，也能查看“当前哪里出了问题”。
不在侧边菜单中
控制台菜单中没有任何链接——需要直接输入地址访问。 在施工现场看板或公司内部维基上链接此地址会很方便。
可以看到什么
┌────────────────────────────────────────────────┐
│ 플랜트펄스 상태 │
│ 🟢 모든 시스템 정상 │
│ 24시간 가용성 99.95% 마지막 갱신 12:34:56 │
├── 인프라 ─────────────────────────────────────┤
│ 이벤트 스토어 · 스트림 · MQTT · 캐시 · … │
├── API 엔드포인트 ─────────────────────────────┤
│ auth 🟢 99.98% p99 45ms 성공 12,345 / 오류 2│
│ ▁▁▁▂▁▁▁▁▁▁▁▁▁▁ (90칸 타임라인) │
└────────────────────────────────────────────────┘
5초마다 자동 갱신
最上方——整体状态
| 标识 | 含义 |
|---|---|
| 🟢 所有系统正常 | 全部 OPERATIONAL |
| 🟡 部分系统性能下降 | 一个或多个 DEGRADED |
| 🔴 重大故障 | 一个或多个 OUTAGE |
旁边会同时显示24小时可用性 · 最后更新时间。 如果连接断开，则会变为“连接断开。正在重试...”。
基础设施——13项
| 显示名称 | 说明 |
|---|---|
| 事件存储 | 事件存储库 |
| 流处理 | 流处理 |
| MQTT | 消息代理 |
| 缓存 | 内存缓存 |
| 元数据存储 | 元数据数据库 |
| 分析存储 | 分析用存储 |
| 节点操作系统 | 服务器操作系统 |
| 时序引擎 | 时序数据库 |
| 复杂事件处理 | CEP引擎 |
| 数据网关 | 采集网关 |
| 工作流引擎 | Temporal |
| 批量编排器 | Kestra |
| 对象存储 | RustFS |
各项的含义和状态颜色定义见状态代码定义。
API端点
每个端点对应一个卡片，并显示以下内容。
| 项目 | 说明 |
|---|---|
| 24小时可用性 | 最近24小时成功率 |
| p99响应时间 | 排除前1%后的最差响应时间 (ms) |
| 成功 (24小时) · 错误 (24小时) | 调用次数 |
| 90格时间线 | 最近90个时段的状态条 |
如果测量数据不足，则显示“无数据”或“N/M分钟测量”——
刚启动的服务器上可用性看起来较低，原因就在于此。
数据来自哪里
页面本身只是一个空壳，由浏览器每5秒轮询
GET /api/v5/public/status 来填充。
curl -s http://[서버IP]/api/v5/public/status
{
"data": {
"overall_status": "OPERATIONAL",
"as_of": 1717400000000,
"uptime_24h_percent": 99.95,
"endpoints": [
{
"name": "auth", "category": "auth", "status": "OPERATIONAL",
"uptime_percent_24h": 99.98, "p99_latency_ms": 45,
"success_count_24h": 12345, "error_count_24h": 2,
"timeline_90": ["ok", "ok", "degraded", "ok"]
}
]
},
"meta": { "timestamp": 1717400000000, "status": "OK", "pagination": null },
"errors": null
}
不需要API密钥，也不需要会话。 监控工具或看板可以直接抓取使用。
没有认证意味着暴露
/status 和 /api/v5/public/status 是任何人都可以访问的。基础设施组件的
名称和故障状态会直接显现，因此如果是直接暴露在互联网上的服务器，请在反向代理中
将这两个路径限制到内网。在内网部署中，保持原样会更方便。
与健康检查有何不同
/status | /api/health | |
|---|---|---|
| 用途 | 给人看的可用性页面 | 机器用的就绪检查 |
| 认证 | 无 | 无 |
| 响应 | 24小时统计·延迟·时间线 | status / service / ts / checks |
| 使用场景 | 浏览器·看板 | 容器健康检查、HA网关、CI |
对于容器或负载均衡器的健康检查，请使用**/api/health**。
/status 是24小时统计，不会对瞬时故障做出反应。
常见问题
问：输入了地址却被重定向到登录页面。
答：路径必须完全是 /status (/status/ 或 /status/index 也可以)。
也请确认是否被反向代理拦截。
问：刚安装完成，可用性显示为0%。
答：因为是24小时统计，需要积累测量时段。请查看“N/M分钟测量”的显示。
问：基础设施中的一项一直显示红色。 答：请在监控中确认该组件是否确实在运行。 根据安装配置，有些组件可能根本没有部署。