跳到主要内容
工程

本页尚未翻译,当前显示英文版本。

公开状态页

公开状态端点让任何人无需凭据就能知道 PlayServ 平台是否正常运行。 你可以把可用性监控指向它,或用它在游戏里、支持页面上显示状态指示。它只报告平台自身的健康状况,从不暴露项目数据。


状态从何而来

平台自己报告自己的状况。 每个平台系统每分钟写入一份简短的健康报告,端点针对每个系统和接入点提供最新的结论。

系统覆盖范围
adminBackoffice 和平台 API。
data平台数据的读写。
transport实时消息。
functionsFunction 网关和运行时。当平台抽样检查的已部署 Function 不再响应其 GET /_health 检查时,它也会变为黄色。

列表中以后可能会出现新的系统,所以请把它当作开放的列表,而不是固定的。

状态含义
green系统健康。
yellow系统降级:它自身的检查变慢或失败,或者正在重启。
red系统停止了报告。

红色表示沉默,不一定是故障

系统从不会把自己报告为红色。大约三分钟没有收到报告时就会显示红色,因为挂起的服务没办法告诉你它挂起了。可能是系统宕机,也可能只是报告停止了;无论哪种情况,在它恢复为绿色之前都应按事件处理。

这与 Backoffice 中的 Platform Health 是两种不同的测量方式,后者从外部探测平台。两者可能会在几分钟内不一致。


当前状态

GET /status 返回此刻的结论。响应会缓存几秒钟,所以轮询间隔短于 30 秒没有意义。

字段含义
generated_at响应生成的时间。
overall所有条目中最差的状态。没有条目时不出现。
items[]每个系统和接入点一个条目。
items[].system · items[].pop哪个系统,位于哪个接入点。
items[].current_status结论:green、yellow 或 red。
items[].last_status最新一次报告中的状态,未考虑沉默的情况。
items[].last_probe_at · items[].seconds_since_probe最新一次报告到达的时间,以及距今多久。

没有条目表示没有结论,而不是健康

如果 items 为空,说明无法判断,此时会省略 overall,而不是默认为 green。应显示“状态未知”,而不是“一切正常”。


每日历史

GET /status/history 针对某一个接入点,按从早到晚的顺序返回每个系统每天一行的数据。

参数取值默认值
days1–36590
pop一个接入点平台自身所在的接入点

days 超出范围时会以 422 拒绝。每天背后的逐分钟报告会永久保留,所以较早的历史不会变得稀疏。

每天的字段含义
dayUTC 日期。
availability_pct当天非红色分钟所占的比例,从 0 到 100。
green_minutes · yellow_minutes · red_minutes当天各状态的分钟数。它们的总和始终等于当天已经过去的分钟数。

在游戏或监控中使用

用途读取什么
可用性监控每 30–60 秒轮询一次 GET /status,当 overall 为 red,或连续几次轮询都缺少它时发出告警。
游戏内的状态指示根据 overall 显示正常、降级或宕机,缺少时显示“未知”。不要因此阻止 Player 进入游戏:它报告的是平台,而不是你的游戏。
支持页面或状态页面用 GET /status/history 绘制最近 30 或 90 天的每日柱状图,按 availability_pct 着色。

如果希望收到通知而不是轮询,请在 Notifications 中开启健康告警。


下一步

更新于 2026年10月14日