Sua API cai às 2 da manhã. A primeira pessoa a perceber é um cliente que tuíta sobre isso. Quando você acorda, há 30 tickets de suporte e um thread no Hacker News sobre sua queda.

Isso é o que acontece quando você não tem alertas onde sua equipe realmente olha. E para a maioria das equipes de engenharia, esse lugar é o Slack.

Neste tutorial, você vai aprender a configurar alertas do Slack para monitoramento de APIs com Nurbak — para receber notificações sobre quedas, picos de latência, taxas de erro e expiração SSL no canal onde você já trabalha.

Por que o Slack é o melhor canal para alertas de API?

Engenheiros não checam email às 2 da manhã. Não ficam com um dashboard de monitoramento aberto 24/7. Mas têm o Slack no celular com notificações ativadas para canais específicos.

Slack é onde sua equipe já se comunica sobre incidentes. Quando um alerta de API chega no #ops-alerts, o engenheiro de plantão vê imediatamente, e o resto da equipe tem contexto completo sem perguntar "o que aconteceu?"

Nurbak envia alertas do Slack usando Block Kit — o formato de mensagens ricas do Slack — para que você receba notificações estruturadas e acionáveis em vez de texto simples.

Passo 1: Criar um Webhook do Slack

Primeiro você precisa de uma URL de webhook do Slack:

  1. Acesse api.slack.com/apps e clique em Create New App
  2. Selecione From scratch, nomeie como "Nurbak Alerts" e escolha seu workspace
  3. Na barra lateral, clique em Incoming Webhooks e ative
  4. Clique em Add New Webhook to Workspace
  5. Selecione o canal para alertas (ex: #ops-alerts)
  6. Copie a URL do webhook gerada
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

Passo 2: Adicionar o Webhook no Nurbak

  1. Faça login em watch.nurbak.com e vá para Settings → Alert Contacts
  2. Clique em Add Contact e selecione Slack
  3. Cole sua URL de webhook e dê um rótulo
  4. Clique em Send Test Notification para verificar
  5. Salve a configuração

Passo 3: Configurar Regras de Alerta

Defina quando o Nurbak deve alertar você:

RegraLimite recomendadoPor quê
API Fora do Ar2 checks falhos consecutivosEvita falsos positivos por problemas de rede transitórios
Alta LatênciaP95 > 2000msDetecta degradação antes de virar uma queda total
Taxa de Erro> 5% dos checks com 5xxDetecta falhas parciais que não aparecem como downtime
Expiração SSLCertificado expira em < 14 diasTe dá 2 semanas para renovar

Como são as notificações

Os alertas chegam formatados com Block Kit do Slack, incluindo: nome do endpoint, URL, código de status HTTP, região de monitoramento, tempo de resposta, timestamp e um botão direto para o incidente no dashboard. As mensagens são codificadas por cor: vermelho para quedas, amarelo para degradação e verde para recuperação.

Anti-Spam: Uma notificação por incidente

Nurbak segue um modelo de uma notificação por incidente: 1 alerta quando o incidente começa e 1 notificação de recuperação quando o endpoint volta ao normal. Se sua API ficar fora do ar por 30 minutos, você recebe exatamente 2 mensagens — não 30.

Comece Agora

Alertas do Slack estão disponíveis no plano Pro ($29/mês), que também inclui health checks a cada minuto, monitoramento multi-região e contatos de alerta ilimitados. O plano grátis inclui alertas por email para até 3 endpoints.

Comece a monitorar suas APIs com Nurbak — a configuração leva menos de 3 minutos.