Alertas
Regras de limite para as métricas das suas chamadas — enviadas por e-mail, Slack ou seus webhooks no momento em que algo sai do esperado.
As regras de alerta monitoram as métricas de chamadas da sua organização e notificam você quando
um limite é ultrapassado — taxa de sucesso abaixo de 80% no último dia,
mais de 500 chamadas em uma hora, uma regressão em um conjunto de testes. Gerencie-as
em Configurações → Organização → Alertas
(/dashboard/organization?tab=alerts). Gerenciar regras de alerta exige
a função de admin ou owner.
Criar uma regra
Clique em Criar regra e preencha:
| Campo | Opções |
|---|---|
| Métrica | Taxa de sucesso · Taxa de falha · Pontuação média · Volume de chamadas · Regressões de conjunto |
| Condição | é menor que · é no máximo · é maior que · é no mínimo |
| Limite | O número usado para comparação |
| Janela (horas) | Até onde a métrica é calculada — de 1 a 720 horas |
| Destinatários de e-mail | Separados por vírgula, até 10 endereços |
| URL do webhook de entrada do Slack | Opcional — publica a mensagem de alerta em um canal |
| Intervalo de espera (minutos) | Tempo mínimo de silêncio entre disparos (padrão: 60) |
| Entregar aos webhooks de desenvolvedor | Também envia um evento alert.triggered aos seus endpoints de webhook |
| Ativar regra de alerta | As regras podem ser salvas desativadas e ativadas depois |
Exemplo: "A taxa de sucesso é menor que 80 nas últimas 24 horas" é disparada quando as chamadas avaliadas na janela móvel de 24 horas caem abaixo de uma taxa de sucesso de 80%.
Como funciona o disparo
As regras são avaliadas em relação à janela móvel configurada. Quando a condição é atendida, a regra é disparada uma vez e permanece em silêncio durante o período de espera, mesmo que a métrica continue fora do limite — assim, uma hora ruim gera uma notificação, não uma notificação por avaliação. Cada disparo registra o valor da métrica, o limite e o horário.
Canais de entrega
Uma única regra pode notificar pelos três canais ao mesmo tempo:
- E-mail — uma mensagem para cada destinatário listado com o nome da regra, a métrica, o valor, o limite e a janela.
- Slack — a mesma mensagem publicada pela URL do webhook de entrada do Slack.
- Webhooks de desenvolvedor — um evento
alert.triggeredentregue aos endpoints de webhook da sua organização, para integrar alertas ao PagerDuty, a ferramentas de plantão ou aos seus próprios sistemas.
A falha de um canal nunca bloqueia os outros.
Gerenciar regras
A guia Alertas lista todas as regras com seu estado ativado/desativado e quando foram disparadas pela última vez. Ative e desative regras diretamente, use Editar para alterar qualquer campo ou exclua regras que não são mais necessárias. A atividade recente de alertas é exibida ao lado para que você possa confirmar que uma regra realmente é disparada como espera.