1

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

  1. 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.
  2. 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ó.
  3. 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!

Carregando publicação patrocinada...