Pular para o conteúdo principal
Versão: 0.4 · atual

Modos de ingestão

ConceitoRevisado em 11 de outubro de 2026
Aplica-se a:Excubius 0.4Funções: Administrador de entidade
PlanosFree · Core · Pro · EnterpriseImplantaçãoAuto-hospedado

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​

ModoComo funcionaPontos fortesPontos fracosAdequado quando
PollingO coletor consulta a API da fonte de acordo com um agendamento para obter inventário, métricas e alertas, com credenciais somente leituraNada entra vindo de fora. Ele recupera o atraso depois de uma interrupção. Você recebe inventário e métricasOs alertas aparecem dentro do intervalo de sondagem. Consome cota de APIA fonte não consegue acessar este servidor: não há endereço público ou o tráfego de entrada não é permitido
Webhook onlyA fonte envia os alertas para uma URL de webhook. Nada é consultado e nenhuma credencial é armazenadaOs alertas chegam na hora. Nenhuma credencial de APISem inventário e sem métricas. Os alertas enviados enquanto este servidor está fora do ar se perdemVocê pode dar uma URL à fonte, mas não credenciais de API
HybridWebhooks para os alertas, mais a sondagem de inventário e métricas e uma reconciliação periódica dos alertasImediato e autocorretivo: um alerta fechado na fonte enquanto o webhook dele se perdeu é resolvido na próxima reconciliaçãoUm pouco mais de uso da APIA 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​

SondagemSomente webhookHíbrido
Credenciais necessáriasSimNãoSim
Inventário e métricasPor sondagemNenhumPor sondagem
AlertasPor sondagem, no intervalo de alertasWebhooksWebhooks, reconciliados no intervalo de reconciliação
Chamadas de webhookRecusadas e auditadasAceitasAceitas
A fonte está atualizada enquantoAs sondagens têm êxitoChegou um webhook no último diaAs sondagens têm êxito
TestÉ executado no coletorResponde na hora com base no que foi recebidoÉ executado no coletor
Sync nowSimNãoSim

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:

  1. 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.
  2. Segredo compartilhado opcional. Quando você define um Webhook secret, cada chamada precisa trazê-lo como Authorization: Bearer <secret>, como a senha de Authorization: Basic ou em X-Webhook-Secret ou X-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.
  3. 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.
  4. 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.
  5. 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:

FonteInventárioMétricasAlertas (sondagem)Reconciliação de alertas (híbrido)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

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.