Esta página ainda não foi traduzida: mostrando a versão em inglês.
Página de status pública
O endpoint de status público diz a qualquer pessoa, sem credenciais, se a plataforma PlayServ está no ar. Aponte um monitor de uptime para ele ou use-o para exibir um indicador de status no seu jogo ou na sua página de suporte. Ele informa apenas a saúde da própria plataforma: nunca expõe dados de projetos.
De onde vem o status
A plataforma informa sobre si mesma. A cada minuto, cada sistema da plataforma grava um breve relatório de saúde, e o endpoint devolve o veredito mais recente por sistema e por ponto de presença.
| Sistema | O que abrange |
|---|---|
admin | O Backoffice e a API da plataforma. |
data | Leitura e escrita dos dados da plataforma. |
transport | Mensagens em tempo real. |
functions | O gateway e o runtime das Functions. Também fica amarelo quando Functions publicadas que a plataforma amostra deixam de responder à verificação GET /_health. |
Novos sistemas podem aparecer na lista com o tempo, então trate-a como aberta, não fixa.
| Status | Significado |
|---|---|
green | O sistema está saudável. |
yellow | O sistema está degradado: a própria verificação dele foi lenta ou falhou, ou ele está reiniciando. |
red | O sistema parou de enviar relatórios. |
Vermelho significa silêncio, não necessariamente uma queda
Nenhum sistema se declara vermelho. O vermelho aparece quando nenhum relatório chega por cerca de três minutos, porque um serviço travado não consegue avisar que travou. O sistema pode estar fora do ar, ou apenas os relatórios dele podem ter parado; de qualquer forma, trate como um incidente até ele voltar ao verde.
Essa é uma medição diferente da de Platform Health no Backoffice, que testa a plataforma de fora. As duas podem divergir por alguns minutos.
Status atual
GET /status devolve o veredito do momento. As respostas ficam em cache por alguns segundos, então consultar com frequência maior que a cada 30 segundos não traz ganho.
| Campo | Significado |
|---|---|
generated_at | Quando a resposta foi gerada. |
overall | O pior status entre todos os itens. Ausente quando não há itens. |
items[] | Uma entrada por sistema e ponto de presença. |
items[].system · items[].pop | Qual sistema, em qual ponto de presença. |
items[].current_status | O veredito: green, yellow ou red. |
items[].last_status | O status no relatório mais recente, antes de considerar o silêncio. |
items[].last_probe_at · items[].seconds_since_probe | Quando o relatório mais recente chegou e há quanto tempo. |
Sem itens não há veredito, e isso não significa saudável
Se items estiver vazio, não há evidência em nenhum sentido, e overall é omitido em vez de assumir green. Mostre “status desconhecido”, não “tudo certo”.
Histórico diário
GET /status/history devolve uma linha por dia para cada sistema, da mais antiga para a mais recente, em um ponto de presença.
| Parâmetro | Valores | Padrão |
|---|---|---|
days | 1–365 | 90 |
pop | Um ponto de presença | O da própria plataforma |
Um valor de days fora do intervalo é rejeitado com 422. Os relatórios por minuto por trás de cada dia são guardados por tempo indeterminado, então o histórico antigo não perde detalhe.
| Campo por dia | Significado |
|---|---|
day | A data em UTC. |
availability_pct | A fração dos minutos do dia que não foram vermelhos, de 0 a 100. |
green_minutes · yellow_minutes · red_minutes | Como os minutos do dia se dividem por status. A soma sempre dá os minutos decorridos naquele dia. |
Uso em um jogo ou em um monitor
| Uso | O que ler |
|---|---|
| Monitor de uptime | Consulte GET /status a cada 30–60 segundos e dispare um alerta quando overall for red ou estiver ausente por várias consultas seguidas. |
| Indicador de status em um jogo | Mostre verde, degradado ou fora do ar a partir de overall, e “desconhecido” quando ele estiver ausente. Não bloqueie os Players com base nele: ele informa a plataforma, não o seu jogo. |
| Página de suporte ou de status | Desenhe os últimos 30 ou 90 dias a partir de GET /status/history como barras diárias, coloridas conforme availability_pct. |
Para ser notificado em vez de consultar, ative os alertas de saúde em Alertas e notificações.
Próximos passos
- Platform Health — a visão detalhada de saúde no Backoffice, com login
- Alertas e notificações — alertas no Slack quando a saúde da plataforma muda
- Functions — a saúde das suas próprias Functions
Atualizado em 14 de out. de 2026