Saltar al contenido principal
Versión: 0.4 · actual

Modos de ingesta

ConceptoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Cada fuente, como New Relic, NinjaOne o Azure Monitor, llega a Excubius en uno de tres modos: Sondeo, Solo webhook o Híbrido. El modo decide qué tan rápido llegan las alertas, si Excubius necesita credenciales para la fuente y si recibe inventario y métricas además de alertas. En este artículo se explica cada modo y cuándo conviene.

Los tres modos​

ModoCómo funcionaVentajasDesventajasConviene cuando
SondeoEl recolector consulta periódicamente la API de la fuente para obtener inventario, métricas y alertas, con credenciales de solo lecturaNo entra nada desde fuera. Se pone al día después de una caída. Obtienes inventario y métricasLas alertas aparecen dentro del intervalo de sondeo. Consume cuota de la APILa fuente no puede llegar a este servidor: no hay dirección pública o no se permite el tráfico entrante
Solo webhookLa fuente envía sus alertas a una URL de webhook. No se consulta nada y no se guardan credencialesLas alertas llegan al instante. No hace falta ninguna credencial de APISin inventario y sin métricas. Las alertas enviadas mientras este servidor está caído se pierdenPuedes darle a la fuente una URL, pero no credenciales de API
HíbridoWebhooks para las alertas, más sondeo del inventario y las métricas y una conciliación periódica de las alertasInmediato y con recuperación automática: una alerta cerrada en la fuente cuyo webhook se perdió se resuelve en la siguiente conciliaciónUsa un poco más la APILa fuente puede llamar a este servidor y puedes darle credenciales de solo lectura. Es el valor predeterminado recomendado

Eliges el modo cuando agregas la fuente en Configuración › Fuentes y puedes cambiarlo en cualquier momento sin reiniciar: el recolector toma el cambio en menos de 30 segundos, y los webhooks se comparan con el modo en cada llamada.

Qué hace cada modo​

SondeoSolo webhookHíbrido
Necesita credencialesSíNoSí
Inventario y métricasPor sondeoNingunoPor sondeo
AlertasPor sondeo, en el intervalo de alertasWebhooksWebhooks, conciliados en el intervalo de conciliación
Llamadas de webhookSe rechazan y se auditanSe aceptanSe aceptan
La fuente está al día mientrasLos sondeos funcionanHaya llegado un webhook en el último díaLos sondeos funcionan
ProbarSe ejecuta en el recolectorResponde al instante con lo que se recibióSe ejecuta en el recolector
Sincronizar ahoraSíNoSí

Una fuente por sondeo sigue al día mientras haya funcionado dentro de tres de sus intervalos de sondeo más cortos, y como mínimo 15 minutos. Una fuente de solo webhook solo puede mostrar cuándo recibió algo por última vez, así que un día tranquilo la deja desactualizada.

Conciliación​

Una conciliación es una lista completa de las alertas abiertas de la fuente. Una alerta que la fuente ya no incluye se resuelve en Excubius, con dos excepciones:

  • Las alertas más antiguas que la ventana de la propia lista de la fuente, 30 días para las incidencias de New Relic y las alertas de Azure Monitor, se resuelven solo cuando la fuente lo indica.
  • Las alertas que alguien resolvió a mano en Excubius no se vuelven a abrir mientras la fuente siga informando la misma ocurrencia. Una ocurrencia nueva abre una alerta nueva.

No se resuelve nada a partir de un sondeo que falló, y no se inventa ninguna alerta cuando una fuente no es accesible: en su lugar, la fuente pasa a desactualizada y muestra el error.

Cómo se protegen los webhooks​

Todos los endpoints de webhook aplican las mismas reglas, sea cual sea la fuente:

  1. HTTPS y un token imposible de adivinar. La URL lleva un token aleatorio de 256 bits, y solo se guarda un hash de él. La URL completa se muestra una sola vez, cuando se crea. Rotar la URL la reemplaza, y la anterior deja de funcionar de inmediato.
  2. Secreto compartido opcional. Cuando defines un Secreto del webhook, cada llamada debe incluirlo como Authorization: Bearer <secret>, como la contraseña de Authorization: Basic, o en X-Webhook-Secret o X-Custom-Webhook-Secret. Los grupos de acciones de Azure Monitor no pueden agregar encabezados, así que para ellos el token es la credencial.
  3. Límites. El servidor acepta 30 llamadas de webhook por minuto por dirección IP, con ráfagas de 20, y rechaza cuerpos de más de 512 KiB. Un token desconocido recibe la misma respuesta que una fuente que no existe.
  4. Se guarda antes de procesarse. La carga se guarda primero y se procesa en segundo plano. Una carga que falla se conserva con su error y se reintenta tres veces, así nada se pierde por un error del software. Un reintento del mismo evento, reconocido por el ID de evento de la fuente, se acepta y se descarta.
  5. Se audita. Las llamadas rechazadas porque la fuente está en modo de sondeo o desactivada se cuentan en la fuente y se auditan. Cada cambio de modo, rotación, prueba y sincronización se escribe en el registro de auditoría con el usuario y la hora.

Los eventos recibidos e ignorados se conservan durante 30 días; Configuración › Fuentes muestra los más recientes de cada fuente.

Intervalos de consulta​

Cada fuente tiene sus propios intervalos, en segundos, en Intervalos de consulta. Deja un campo vacío para usar su valor predeterminado:

FuenteInventarioMétricasAlertas (sondeo)Conciliación de alertas (híbrido)
New Relic900300300900
NinjaOne900900300900
Azure Monitor900300300900

El mínimo es de 60 segundos, y de 300 para la conciliación. Cada comprobación también conserva su propio intervalo, así que la fase de métricas solo ejecuta las comprobaciones que tocan; por ejemplo, los vencimientos de Key Vault se leen cada hora. Los intervalos más bajos consumen cuota de la API: un error Límite de peticiones en la fuente significa que son demasiado bajos.

Las comprobaciones propias del recolector no dependen de ningún modo: se ejecutan en los intervalos del catálogo, de 30 segundos a 24 horas.