Como saber sem olhar para o código se o GitHub, a Cloudflare ou a OpenAI estão fora do ar
Quando algo quebra em produção, a primeira pergunta costuma ser "é a gente ou é o fornecedor?". A resposta está nas status pages, mas abrir uma por uma toma tempo. A boa notícia é que boa parte delas pode ser consultada por código. Aprendemos isso construindo o StatusPane, que acompanha as status pages de 95 serviços, e reunimos aqui o que pode ser útil para quem quer fazer algo parecido.
A maioria usa o Atlassian Statuspage
GitHub, Cloudflare, OpenAI e muitos outros publicam a status page pelo Atlassian Statuspage. Ele expõe uma API JSON pública no mesmo domínio da página, por exemplo:
curl https://www.githubstatus.com/api/v2/summary.json
O summary traz o status geral, cada componente com o seu status e os incidentes ainda abertos. Se você só quer saber se está tudo bem, o /api/v2/status.json é menor.
Nem todo mundo usa
Alguns fornecedores usam o incident.io, outros o Better Stack, e alguns fizeram a própria página. Cada formato tem uma estrutura diferente, e alguns nem são documentados. Antes de confiar num endpoint, confira na página do próprio fornecedor que dados ela carrega.
E os fornecedores mudam de plataforma sem avisar. O Datadog saiu do Statuspage recentemente, e o endpoint antigo passou a responder 403 de um dia para o outro. Se o seu monitoramento depende disso, trate erro de formato como alerta, não como "tudo certo".
Três detalhes que pegam
- Incidente resolvido some. No summary do Statuspage, um incidente resolvido simplesmente deixa de aparecer. Se você guarda histórico, considere resolvido o incidente que sumiu.
- Os status não têm o mesmo nome. "degraded_performance", "degraded", "partial_outage", "full_outage", "major_outage": cada plataforma tem o seu vocabulário. Vale traduzir tudo para uma escala só.
- Seja educado com o servidor. Mande de volta o ETag que recebeu. Quando nada mudou, a resposta é um 304 sem corpo. Uma das páginas que lemos tem quase 2 MB sem compressão.
Olhe o componente, não o fornecedor
"O GitHub está fora" quase nunca é verdade. Normalmente é o GitHub Actions, ou o Git via SSH, ou o Copilot. Acompanhar só os componentes que o seu app usa evita alarme falso.
Se não quiser montar isso
Foi por isso que construímos o StatusPane: dá para ver o status de 95 serviços ao vivo, sem cadastro, em https://statuspane.io/status. Com conta, você agrupa os componentes que usa por app e recebe um e-mail ou um webhook quando algo muda. Está em beta e é gratuito.
Que serviço vocês usam e não está lá?
Isso é um side project meu e do Matias Leidemer, estamos abertos a feedback!