Pular para o conteúdo principal
Engenharia

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.

SistemaO que abrange
adminO Backoffice e a API da plataforma.
dataLeitura e escrita dos dados da plataforma.
transportMensagens em tempo real.
functionsO 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.

StatusSignificado
greenO sistema está saudável.
yellowO sistema está degradado: a própria verificação dele foi lenta ou falhou, ou ele está reiniciando.
redO 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.

CampoSignificado
generated_atQuando a resposta foi gerada.
overallO 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[].popQual sistema, em qual ponto de presença.
items[].current_statusO veredito: green, yellow ou red.
items[].last_statusO status no relatório mais recente, antes de considerar o silêncio.
items[].last_probe_at · items[].seconds_since_probeQuando 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âmetroValoresPadrão
days1–36590
popUm ponto de presençaO 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 diaSignificado
dayA data em UTC.
availability_pctA fração dos minutos do dia que não foram vermelhos, de 0 a 100.
green_minutes · yellow_minutes · red_minutesComo 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

UsoO que ler
Monitor de uptimeConsulte 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 jogoMostre 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 statusDesenhe 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

Atualizado em 14 de out. de 2026