Pular para conteúdo

Alertas

Administração › Alertas (permissão alerts.manage). Canais dizem para onde enviar; regras dizem quais achados notificam cada canal.

Como funciona

A cada minuto, a engine pega até 500 achados abertos e ainda não notificados, em ordem de prioridade, e aplica as regras habilitadas. Detalhes:

  • Deduplicação: um achado reincidente dentro de notifications.dedup_minutes (240 min) desde a última notificação não gera nova mensagem, exceto se a severidade subiu (escalonamento).
  • Sem regras configuradas, os achados são marcados como notificados sem envio, ou seja, criar uma regra depois não dispara mensagens retroativas de achados antigos.
  • Erros de envio são registrados no log da engine (falha ao enviar alerta pelo canal …) e não interrompem os demais canais.

Canais

Use Testar após criar: envia uma mensagem de exemplo e mostra o erro, se houver.

Tipo Configuração (campos da GUI) Segredos (cifrados) Mensagem enviada
Webhook URL; validar certificado TLS cabeçalho Authorization (opcional, ex.: Bearer …) POST JSON {"source": "quantix-vision-ai", "finding": {...}, "text": "..."}
Microsoft Teams — URL do webhook de entrada (Workflows/Power Automate) Adaptive Card 1.4: título com severidade, objeto, dispositivo, categoria, detalhe, recomendação e botão “Abrir no Quantix” (se general.base_url estiver definido)
Slack — URL do Incoming Webhook {"text": ...}
E-mail destinatários (separados por vírgula) — (usa o SMTP de Configurações › Notificações) assunto [Quantix CRÍTICO] <título> e corpo em texto
Syslog servidor, porta (514), protocolo udp/tcp, facility (16 = local0) — RFC 5424 com PRI = facility×8 + severidade (crítico 2, aviso 4, info 6) e JSON {title, entity, severity, category}
ServiceNow URL da instância, grupo de atendimento, categoria (padrão Storage) usuário, senha POST /api/now/table/incident com short_description, description, urgency/impact (1 para crítico, 2 nos demais), assignment_group, category e correlation_id = fingerprint do achado

Exemplos de configuração (corpo de POST /api/v1/alerts/channels):

{"name": "Teams — storage", "kind": "teams", "config": {}, "secrets": {"url": "https://prod-00.westus.logic.azure.com/workflows/..."}}
{"name": "NOC syslog", "kind": "syslog", "config": {"host": "syslog.empresa.local", "port": 514, "protocol": "udp", "facility": 16}}
{"name": "Plantão storage", "kind": "email", "config": {"to": ["storage@empresa.com.br", "noc@empresa.com.br"]}}
{"name": "ServiceNow", "kind": "servicenow", "config": {"instance_url": "https://empresa.service-now.com", "assignment_group": "Storage", "category": "Storage"}, "secrets": {"username": "svc_quantix", "password": "..."}}
{"name": "Integração", "kind": "webhook", "config": {"url": "https://integracao.empresa.local/quantix", "verify_tls": true}, "secrets": {"auth_header": "Bearer abc123"}}

E-mail

Configure antes Configurações › Notificações: servidor, porta (587), usuário, senha, STARTTLS e remetente. Sem servidor SMTP o envio falha com “SMTP não configurado”.

Regras

Campo Efeito
Severidade mínima info, warning (padrão) ou critical
Categorias vazio = todas (performance, capacity, errors, availability, balance, configuration, change)
Tipos de objeto vazio = todos
Canais de destino um ou mais canais
Runbook a solicitar automaticamente opcional. Cria uma execução para o achado (se o runbook estiver ativo e for aplicável ao tipo do objeto). Runbooks que exigem aprovação ficam aguardando aprovação
Regra ativa —

Exemplo: “Críticos de SAN para o NOC” → severidade mínima critical, categorias errors e availability, tipos switch_port e host, canal Teams — NOC.