Sumário
Notificações por e-mail e chat passam facilmente despercebidas durante um incidente. Para alertas críticos, o Echobell transforma as notificações de webhook do Grafana em chamadas telefônicas de verdade, com suporte a escalonamento e repetições. Este guia mostra a configuração completa.
Documentação relevante:
- O que é o Echobell → /docs/what-is-echobell
- Tipos de notificação e repetições → /docs/notification
- Visão geral dos webhooks → /docs/webhook
- Referência da integração com o Grafana → /docs/developer/grafana
Pré-requisitos
- Conta no Echobell com um canal ativo e uma URL de webhook (veja /docs/webhook)
- Acesso de administrador à sua instância do Grafana
- Pelo menos uma regra de alerta configurada
Configuração
Passo 1 — Criar um ponto de contato Webhook no Grafana
- Acesse Alerting → Contact points
- Clique em New contact point e escolha Webhook
- Dê um nome fácil de identificar, por exemplo "Echobell Phone Calls"
Passo 2 — Adicionar a URL de webhook do Echobell
Defina a URL como o webhook do seu canal:
https://hook.echobell.one/t/<channel-token>
Copie essa URL nas configurações do canal no Echobell (detalhes em /docs/webhook). Trate-a como um segredo e faça a rotação caso ela vaze.
Passo 3 — Testar a integração
Clique em Test no Grafana para enviar um alerta de exemplo. Você deve receber uma chamada telefônica do Echobell em poucos segundos.
Passo 4 — Vincular às políticas de notificação
- Acesse Alerting → Notification policies
- Crie ou edite uma política que abranja seus alertas críticos
- Adicione o ponto de contato "Echobell Phone Calls"
Agora o Grafana vai encaminhar os alertas correspondentes para o Echobell.
Boas práticas
- Reserve as chamadas telefônicas para alertas de alta prioridade; use chat ou e-mail para severidades menores
- Configure repetições e tempos limite no Echobell para reduzir a fadiga de alertas (/docs/notification)
- Configure o escalonamento para colegas de time caso a primeira chamada não seja atendida
- Use horários de silêncio para não ser acordado por alertas pouco urgentes
- Compartilhe o canal com o time de plantão e mantenha a escala atualizada
Opções avançadas
- Compartilhe canais com colegas de time para ampliar a cobertura
- Personalize o conteúdo de voz por tipo de alerta usando modelos
- Configure tentativas de repetição e caminhos de escalonamento
- Defina contatos reservas para mais resiliência
Referência completa: /docs/developer/grafana
Solução de problemas
- Nenhuma chamada recebida: confirme se a política de notificação encaminha para o seu ponto de contato do Echobell
- Erro 4xx no webhook: verifique se a URL do webhook está exata e se o canal está ativo
- Chamadas demais: restrinja o escopo da política ou reduza os limiares de severidade dos alertas
- Chamadas de menos: aumente a severidade ou adicione filtros de label para que os alertas críticos correspondam à política
Relacionados
- Alertas por webhook para sistemas próprios → /blog/get-notified-with-webhook-mcp
- Notificações de falha do GitHub Actions → /blog/github-actions-notifications
- Documentação do Grafana para desenvolvedores → /docs/developer/grafana