Operação

Notificações

O Argus avisa a equipe por Slack, WhatsApp, Telegram, Discord ou webhook. Cada incidente gera uma mensagem quando abre e uma quando resolve, e nada no meio: sem lembretes repetidos, sem tempestade de mensagens.

Nesta página

Ciclo de um incidente
Criar um canal
Conceitos
Regras de roteamento
Diagnóstico

Ciclo de um incidente

O alerta abre: uma mensagem “ABERTO” por destino.

Enquanto continua aberto: silêncio.

Se a severidade piora (atenção → alerta → crítico): uma nova mensagem. Melhorar não notifica.

Reconhecido (ack): continua reconhecido e não reenvia.

Resolveu: o “RESOLVIDO” espera 5 minutos. Se o alerta voltar nesse intervalo, é o mesmo incidente e nada é enviado.

Passados os 5 minutos: uma mensagem “RESOLVIDO”, só para quem recebeu o “ABERTO”.

Alertas suprimidos (manutenção, dependência já alertada, host offline cobrindo os checks dele) continuam visíveis em Alertas, sem notificação. As mensagens trazem host, recurso, valor medido, impacto, causa provável e runbook.

Criar um canal

Em Admin → Notificações → Novo canal, o diálogo mostra só os campos do tipo escolhido, com o passo a passo de onde obter cada credencial, e valida antes de salvar. Ao salvar, o Argus já cria o destino e o vincula ao grupo escolhido (NOC por padrão).

Tipo	O que preencher
Slack — Bot Token (recomendado)	Token `xoxb-…` e o canal (`C0123ABCD` ou `#nome`). No Slack: api.slack.com/apps → OAuth & Permissions → escopo `chat:write` → Install to Workspace. Depois, no canal, `/invite @nome-do-bot`.
Slack — Webhook	URL do Incoming Webhook.
WhatsApp	URL e API key da Evolution API; número com DDI e DDD, só dígitos.
Telegram	Token do bot (@BotFather `/newbot`) e chat id (grupos começam com `-100`).
Discord	URL do webhook do canal.
Webhook	URL e autenticação (nenhuma, Bearer ou header). Cada alerta aberto/resolvido vira um `POST` JSON: serve para n8n, Zapier, Make ou sistema próprio.

As credenciais ficam criptografadas no banco do Argus e nunca aparecem em logs.

Conceitos

Canal: a integração (Slack, WhatsApp…), com a credencial.
Destino: para onde vai dentro do canal (canal do Slack, número, chat, URL).
Grupo: a equipe (NOC, DBA, Infra, DevOps, Segurança, Aplicações), com seus destinos.
Regra de roteamento: quais grupos recebem cada alerta, por severidade, origem, check, recurso, ambiente e host group.

Regras de roteamento

Criar regras padrão cria os presets: Banco, Docker Swarm, Proxmox, Disco/Storage, Serviços systemd, Host offline, Segurança e Críticos gerais.
Nova regra oferece listas prontas de severidade, origem, checks monitorados e autocomplete de recurso.
O simulador mostra quais grupos e destinos receberiam um alerta antes de salvar.
Filtro por host group dinâmico: um host novo que casa o grupo passa a ser roteado sozinho.
As regras são avaliadas da menor ordem para a maior; as que casam somam equipes até uma marcada para aqui. Alerta sem regra vai para o grupo NOC.
Limites por host: o % de CPU, memória e disco que gera Atenção e Crítico pode ser ajustado em cada host (Hosts › abrir host › ícone de ajuste) — útil para bancos que reservam memória de propósito.

Diagnóstico

Admin → Notificações → Logs de entrega mostra o status por destino (sent, failed, skipped) e o erro do provedor. No Slack com Bot Token, not_in_channel significa que o bot não foi convidado para o canal; missing_scope, que falta o escopo chat:write.