Modos de ingestão
Cada fonte, como o New Relic, o NinjaOne ou o Azure Monitor, chega ao Excubius em um de três modos: Polling (sondagem), Webhook only (somente webhook) ou Hybrid (híbrido). O modo decide a rapidez com que os alertas chegam, se o Excubius precisa de credenciais para a fonte e se ele recebe inventário e métricas, além dos alertas. Este artigo explica cada modo e quando ele é adequado.
Os três modos
| Modo | Como funciona | Pontos fortes | Pontos fracos | Adequado quando |
|---|---|---|---|---|
| Polling | O coletor consulta a API da fonte de acordo com um agendamento para obter inventário, métricas e alertas, com credenciais somente leitura | Nada entra vindo de fora. Ele recupera o atraso depois de uma interrupção. Você recebe inventário e métricas | Os alertas aparecem dentro do intervalo de sondagem. Consome cota de API | A fonte não consegue acessar este servidor: não há endereço público ou o tráfego de entrada não é permitido |
| Webhook only | A fonte envia os alertas para uma URL de webhook. Nada é consultado e nenhuma credencial é armazenada | Os alertas chegam na hora. Nenhuma credencial de API | Sem inventário e sem métricas. Os alertas enviados enquanto este servidor está fora do ar se perdem | Você pode dar uma URL à fonte, mas não credenciais de API |
| Hybrid | Webhooks para os alertas, mais a sondagem de inventário e métricas e uma reconciliação periódica dos alertas | Imediato e autocorretivo: um alerta fechado na fonte enquanto o webhook dele se perdeu é resolvido na próxima reconciliação | Um pouco mais de uso da API | A fonte pode chamar este servidor e você pode dar a ela credenciais somente leitura. O padrão recomendado |
Você escolhe o modo ao adicionar a fonte em Settings › Sources e pode alterá-lo a qualquer momento sem reiniciar nada: o coletor aplica a mudança em até 30 segundos, e os webhooks são verificados em relação ao modo a cada chamada.
O que cada modo faz
| Sondagem | Somente webhook | Híbrido | |
|---|---|---|---|
| Credenciais necessárias | Sim | Não | Sim |
| Inventário e métricas | Por sondagem | Nenhum | Por sondagem |
| Alertas | Por sondagem, no intervalo de alertas | Webhooks | Webhooks, reconciliados no intervalo de reconciliação |
| Chamadas de webhook | Recusadas e auditadas | Aceitas | Aceitas |
| A fonte está atualizada enquanto | As sondagens têm êxito | Chegou um webhook no último dia | As sondagens têm êxito |
| Test | É executado no coletor | Responde na hora com base no que foi recebido | É executado no coletor |
| Sync now | Sim | Não | Sim |
Uma fonte consultada por sondagem continua atualizada enquanto tiver tido êxito dentro de três dos seus menores intervalos de sondagem, e no mínimo 15 minutos. Uma fonte somente webhook só consegue mostrar quando recebeu algo pela última vez, então um dia tranquilo a deixa desatualizada.
Reconciliação
Uma reconciliação é uma listagem completa dos alertas abertos da fonte. Um alerta que a fonte não lista mais é resolvido no Excubius, com duas exceções:
- Os alertas mais antigos que a janela de listagem da própria fonte, 30 dias para issues do New Relic e alertas do Azure Monitor, só são resolvidos quando a fonte indica isso.
- Os alertas que alguém resolveu manualmente no Excubius não são reabertos enquanto a fonte continuar informando a mesma ocorrência. Uma nova ocorrência abre um novo alerta.
Nada é resolvido a partir de uma sondagem que falhou, e nenhum alerta é inventado quando uma fonte está inacessível: em vez disso, a fonte fica desatualizada e mostra o erro.
Como os webhooks são protegidos
Todo endpoint de webhook aplica as mesmas regras, seja qual for a fonte:
- HTTPS e um token impossível de adivinhar. A URL traz um token aleatório de 256 bits, e apenas um hash dele é armazenado. A URL completa é mostrada uma vez, quando é criada. Rotate URL a substitui, e a anterior deixa de funcionar na hora.
- Segredo compartilhado opcional. Quando você define um Webhook secret, cada chamada precisa trazê-lo como
Authorization: Bearer <secret>, como a senha deAuthorization: Basicou emX-Webhook-SecretouX-Custom-Webhook-Secret. Os grupos de ações do Azure Monitor não conseguem adicionar cabeçalhos, então, para eles, o token é a credencial. - Limites. O servidor aceita 30 chamadas de webhook por minuto por endereço IP, com picos de 20, e recusa corpos acima de 512 KiB. Um token desconhecido recebe a mesma resposta que uma fonte que não existe.
- Armazenado antes do processamento. O payload é armazenado primeiro e processado em segundo plano. Um payload que falha é mantido com o erro e processado de novo três vezes, para que nada se perca por causa de um bug. Uma nova tentativa do mesmo evento, reconhecida pela ID do evento da fonte, é aceita e descartada.
- Auditado. As chamadas recusadas porque a fonte está no modo de sondagem ou desativada são contadas na fonte e auditadas. Cada mudança de modo, rotação, teste e sincronização é gravada no log de auditoria com o usuário e o horário.
Os eventos recebidos e ignorados são mantidos por 30 dias; Settings › Sources mostra os mais recentes de cada fonte.
Intervalos de sondagem
Cada fonte tem os próprios intervalos, em segundos, em Polling intervals. Deixe um campo vazio para usar o padrão:
| Fonte | Inventário | Métricas | Alertas (sondagem) | Reconciliação de alertas (híbrido) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
O mínimo é 60 segundos, e 300 para a reconciliação. Cada verificação também mantém o próprio intervalo, de modo que a fase de métricas executa apenas as verificações previstas; o vencimento do Key Vault, por exemplo, é lido de hora em hora. Intervalos menores consomem cota de API: um erro rate limited na fonte indica que eles estão baixos demais.
As verificações do próprio coletor não dependem de um modo: elas são executadas nos intervalos do catálogo, de 30 segundos a 24 horas.