Primeiros Passos
Configurar Alertas

Configurar seu Primeiro Alerta

Monitores sem alertas são inúteis durante uma crise. Este guia mostra como configurar seu primeiro canal de notificação — começando pelo Email, disponível em todos os planos.

Como os alertas funcionam

O TheAlert dispara um alerta quando um monitor muda de estado:

  • DOWN alert: quando o monitor passa de UP para DOWN (serviço caiu)
  • Recovery alert: quando o monitor passa de DOWN para UP (serviço voltou)

Isso significa que você recebe no máximo dois alertas por incidente — um na queda e um na recuperação — sem spam de notificações.

Configurando Email (todos os planos)

Acesse Integrações

No menu lateral, clique em "Integrações". Você verá a lista de canais disponíveis para seu plano.

Escolha Email

Clique no card "Email" ou no botão "+ Nova Integração" e selecione Email.

Insira os endereços de email

No campo "Endereços de email", insira um ou mais emails separados por vírgula:

Dê um nome à integração para identificá-la facilmente, por exemplo: Equipe de Infra.

Salve e teste

Clique em "Salvar". Em seguida, clique em "Testar" para enviar um email de teste e confirmar que o canal está funcionando.

Sempre clique em "Testar" após criar uma integração. Isso garante que o email não está caindo em spam e que os endereços estão corretos.

Vincule a integração aos seus monitores

Por padrão, uma integração recém-criada é vinculada a todos os monitores do seu workspace. Para configurar por monitor individualmente:

  1. Acesse o monitor desejado
  2. Vá em "Alertas" dentro do monitor
  3. Selecione quais integrações devem disparar para este monitor

Entendendo os Thresholds

failureThreshold (padrão: 2)

Define quantas falhas consecutivas são necessárias antes de disparar um alerta.

Check 1: DOWN  → sem alerta (1 falha)
Check 2: DOWN  → ALERTA DISPARADO (2 falhas consecutivas)
Check 3: DOWN  → nenhum alerta adicional (incidente já aberto)

Por que isso existe? Para evitar falsos positivos causados por instabilidades transientes de rede. Uma falha isolada de 1 segundo geralmente não representa uma queda real do serviço.

⚠️

Com failureThreshold: 1, você será alertado na primeira falha. Isso maximiza a velocidade de detecção mas pode gerar mais ruído. Use apenas se tolerância zero a downtime for crítica.

recoveryThreshold (padrão: 2)

Define quantas recuperações consecutivas são necessárias antes de enviar o alerta de recuperação.

Check 1: UP  → sem alerta de recuperação (1 sucesso)
Check 2: UP  → ALERTA DE RECUPERAÇÃO ENVIADO (2 sucessos consecutivos)

Por que isso existe? Para evitar alertas de recuperação prematuros quando o serviço oscila (flapping).

Canais disponíveis por plano

CanalFREESTARTERPROBUSINESS
EmailSimSimSimSim
WebhookSimSimSim
SlackSimSim
DiscordSimSim
TelegramSimSim

Próximos passos

Com seu primeiro monitor e alerta configurados, você já tem um sistema de monitoramento funcional. Explore os próximos recursos: