Como te informamos ou alertamos
Uma falha só vale a pena ser detetada se a pessoa certa souber dela. Enviamos para onde a tua equipa já olha e para os teus próprios sistemas quando uma pessoa não é a primeira a reagir.
Os canais
Cada canal recebe a mesma mensagem: qual monitor, desde quando e porquê. Cada um é um endereço que adicionas uma vez e depois nomeias numa regra.
-
Email Cada plano
Uma mensagem para qualquer endereço, confirmada uma vez antes de enviarmos, para que um alerta não possa ser direcionado para a caixa de entrada de outra pessoa.
-
Webhook (POST) Cada plano
Um corpo JSON com todos os campos abaixo, para um URL teu. Para a tua própria automação: abrir um ticket, chamar uma rotação, mudar uma luz de estado.
-
Webhook (GET) Cada plano
Os mesmos campos como parâmetros de consulta, para um receptor que só aceita GET.
-
PagerDuty Starter e acima
Um incidente através da Events API v2, aberto numa falha e resolvido na recuperação, para que a própria escalada do PagerDuty o assuma a partir daí. Um teste lento ou com perdas chega como um aviso, não como crítico.
-
Slack Pro e Business
Uma mensagem num canal, vermelho para offline e verde para de volta online, através de um webhook.
-
Microsoft Teams Pro e Business
A mesma mensagem num canal do Teams, através de um webhook.
-
Discord Pro e Business
A mesma mensagem num canal do Discord, através de um webhook de canal.
-
Telegram Pro e Business
A mesma mensagem num chat, através do teu próprio bot.
Quem ouve sobre o quê, e quando
Confirmado em primeiro lugar
Nada é enviado com base na palavra de uma única sonda. Uma falha torna-se uma falha geral quando sondas em dois outros continentes concordam, então um alerta significa que o site está offline e não apenas uma rede no meio.
Regras e escalamento
Uma regra define quem ouve sobre quais monitores e quanto tempo após a falha começar. Coloca a rotação de plantão num grupo de contactos com um atraso por membro, e uma regra torna-se um escalonamento que termina no momento em que o monitor recupera.
De volta online, dito uma vez
Todos os que foram informados sobre a falha são informados quando termina, com a duração que teve. Não te acordaremos para dizer que a falha acabou.
Testa antes de precisares
Cada endereço tem um botão que envia um teste pelo mesmo caminho que um alerta real segue, formulado para que não possa ser confundido com uma falha real.
O webhook, para os teus próprios sistemas
Um endereço de webhook é um URL teu. Chamamos quando uma falha é confirmada, quando recupera e quando carregas em testar. POST envia os campos como um corpo JSON; GET envia-os como parâmetros de consulta. O URL é armazenado encriptado e nunca mostrado na íntegra novamente, porque quem o tiver pode fazer POST para ele.
| Campo | O que contém |
|---|---|
| reason | down quando uma falha é confirmada, recovery quando termina, test quando alguém carregou no botão |
| monitor | O nome do monitor |
| monitor_id | O seu id, o mesmo que aparece no endereço no dashboard |
| target | O que verifica: o URL, host ou nome |
| type | O tipo de verificação, como um nome curto como https, dns ou ssl_cert |
| cause | Por que falhou, em poucas palavras, quando sabemos |
| error_class | A mesma coisa como um nome curto que um programa pode usar, como timeout, connection ou certificate_expired |
| started | Quando a falha começou, como uma hora do dia com o seu fuso horário |
| confirmed_at | Quando a falha foi confirmada |
| confirmed_from | Os continentes que a confirmaram, como uma lista de nomes. Era um único nome até setembro de 2026 |
| degraded | true quando o monitor está lento ou a perder pacotes em vez de offline |
| resolved | Quando terminou, como um timestamp ISO 8601, numa recuperação |
| duration | Quanto tempo durou, em palavras, numa recuperação |
| incident_id | O id do incidente, o mesmo na falha e na sua recuperação |
Um campo sem nada a dizer é null no JSON e omitido num GET. Responde com qualquer estado abaixo de 400. Qualquer outra coisa conta como uma entrega falhada e é tentada novamente após 30 segundos, 2 minutos e 10 minutos, depois desistimos: um alerta que não chegou dentro de um quarto de hora é história, não notícia.