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": ...} |
| 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"}}
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.