Notificações

O cluster Notificações concentra todos os canais de saída pelos quais o PrimeForge avisa você sobre o que acontece na sua frota: servidores que ficaram offline, deploys que falharam, disco cheio, certificados expirando, Modo de Pânico ativado e muito mais. Você pode entregar esses eventos a sistemas externos via webhooks assinados e/ou recebê-los diretamente por Email, Telegram e Discord.

Esta página cobre os endpoints de webhook e a configuração de cada canal de notificação.

Webhook Endpoints

Um webhook endpoint é uma URL sua que recebe, por POST, um payload JSON sempre que um evento assinado por você acontece. É a forma mais flexível de integrar o PrimeForge a outros sistemas — Slack, Discord, PagerDuty, um serviço interno de plantão, o que você precisar.

Webhook endpoints em Notificações

Criando um endpoint

  1. Acesse Notificações > Webhook Endpoints e clique em Criar.
  2. Preencha:
    • Nome — um identificador amigável (ex.: "Slack #ops").
    • URL — o endpoint HTTPS que receberá os POSTs.
    • Segredo HMAC (opcional) — quando definido, cada entrega leva o cabeçalho X-PrimeForge-Signature: sha256=<hex>, para que o seu receptor confirme que a requisição veio mesmo do PrimeForge.
    • Ativo — liga ou desliga o endpoint sem precisar apagá-lo.
    • Assinatura de eventos — escolha eventos específicos ou deixe vazio para receber todos.

Você pode criar quantos endpoints precisar, cada um com o seu próprio conjunto de eventos e o seu próprio segredo. Isso permite, por exemplo, mandar apenas alertas críticos para o PagerDuty e o feed completo para um canal do Slack.

Eventos disponíveis

Alguns dos eventos que você pode assinar:

Evento Quando dispara
server.unreachable Servidor sem resposta há 90 segundos
server.offline Servidor sem resposta há 10 minutos
server.reconnected Servidor voltou depois de ficar inacessível/offline
deploy.failed Um deploy falhou em algum estágio
deploy.succeeded Um deploy foi concluído com sucesso
disk.warning Uso de disco acima de 75% em um servidor
disk.critical Uso de disco acima de 90% (deploys bloqueados)
cert.expiring Certificado TLS dentro da janela de renovação
panic.activated / panic.deactivated Modo de Pânico ligado/desligado
site.http_down Um site ao vivo falhou 3 sondagens HTTP seguidas
site.http_recovered O site voltou a responder

Formato do payload

Os webhooks são enviados como requisições POST com corpo JSON:

{
  "event": "server.offline",
  "server": {
    "id": "01JRVW...",
    "name": "Servidor Principal",
    "ip": "203.0.113.10"
  },
  "message": "O servidor 'Servidor Principal' está offline há 10 minutos",
  "timestamp": "2026-07-13T14:30:00Z"
}

Toda entrega é assinada com HMAC-SHA256 quando o endpoint tem um segredo configurado. Para os exemplos de verificação da assinatura em Node.js, PHP e Go, consulte a página de Segurança.

Integração rápida. Para o Slack, crie um incoming webhook no Slack e cole a URL aqui. Para o Discord, use a URL de webhook do Discord com /slack no final para formatação compatível. Para qualquer outro sistema, basta um endpoint HTTP que aceite POST com corpo JSON.

Canais de notificação

Além dos webhooks para sistemas externos, o PrimeForge oferece canais prontos para receber os eventos e alertas da frota diretamente em ferramentas de comunicação, sem que você precise escrever um receptor. Cada canal tem a sua própria página de configuração dentro do cluster Notificações.

Email

O canal Email entrega notificações da frota para os endereços que você configurar. Na página do canal, você habilita o envio por email e informa os destinatários que devem receber os avisos. É o canal mais simples de ativar e não exige nenhuma integração externa — ideal para garantir que a equipe seja avisada de incidentes mesmo sem uma ferramenta de chat conectada.

Canal de Email

Telegram

O canal Telegram envia as notificações para um chat ou grupo do Telegram por meio de um bot. Na página do canal, você habilita o Telegram e informa as credenciais do bot (o token) e o identificador do chat de destino. Depois de configurado, os eventos da frota chegam como mensagens no Telegram, o que é prático para receber alertas no celular em tempo real.

Canal do Telegram

Discord

O canal Discord entrega as notificações a um canal do Discord através de um webhook do servidor. Na página do canal, você habilita o Discord e cola a URL de webhook do canal desejado. É uma boa opção para equipes que já centralizam a comunicação no Discord e querem um canal dedicado a eventos de infraestrutura.

Canal do Discord

Cada canal pode ser ligado ou desligado de forma independente, e você pode usar mais de um ao mesmo tempo — por exemplo, email para registro formal e Telegram para avisos imediatos no celular.

Próximos passos

  • Alertas e Monitoramento — crie regras de alerta por métrica que disparam essas notificações.
  • Logs e Auditoria — o feed de incidentes e a trilha de auditoria da organização.
  • Segurança — como verificar a assinatura HMAC das entregas de webhook.
Alertas e Monitoramento Logs e Auditoria