Modos de ingesta
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
| Modo | Cómo funciona | Ventajas | Desventajas | Conviene cuando |
|---|---|---|---|---|
| Sondeo | El recolector consulta periódicamente la API de la fuente para obtener inventario, métricas y alertas, con credenciales de solo lectura | No entra nada desde fuera. Se pone al día después de una caída. Obtienes inventario y métricas | Las alertas aparecen dentro del intervalo de sondeo. Consume cuota de la API | La fuente no puede llegar a este servidor: no hay dirección pública o no se permite el tráfico entrante |
| Solo webhook | La fuente envía sus alertas a una URL de webhook. No se consulta nada y no se guardan credenciales | Las alertas llegan al instante. No hace falta ninguna credencial de API | Sin inventario y sin métricas. Las alertas enviadas mientras este servidor está caído se pierden | Puedes darle a la fuente una URL, pero no credenciales de API |
| Híbrido | Webhooks para las alertas, más sondeo del inventario y las métricas y una conciliación periódica de las alertas | Inmediato y con recuperación automática: una alerta cerrada en la fuente cuyo webhook se perdió se resuelve en la siguiente conciliación | Usa un poco más la API | La 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
| Sondeo | Solo webhook | Híbrido | |
|---|---|---|---|
| Necesita credenciales | Sí | No | Sí |
| Inventario y métricas | Por sondeo | Ninguno | Por sondeo |
| Alertas | Por sondeo, en el intervalo de alertas | Webhooks | Webhooks, conciliados en el intervalo de conciliación |
| Llamadas de webhook | Se rechazan y se auditan | Se aceptan | Se aceptan |
| La fuente está al día mientras | Los sondeos funcionan | Haya llegado un webhook en el último día | Los sondeos funcionan |
| Probar | Se ejecuta en el recolector | Responde al instante con lo que se recibió | Se ejecuta en el recolector |
| Sincronizar ahora | Sí | No | Sí |
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:
- 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.
- Secreto compartido opcional. Cuando defines un Secreto del webhook, cada llamada debe incluirlo como
Authorization: Bearer <secret>, como la contraseña deAuthorization: Basic, o enX-Webhook-SecretoX-Custom-Webhook-Secret. Los grupos de acciones de Azure Monitor no pueden agregar encabezados, así que para ellos el token es la credencial. - 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.
- 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.
- 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:
| Fuente | Inventario | Métricas | Alertas (sondeo) | Conciliación de alertas (híbrido) |
|---|---|---|---|---|
| New Relic | 900 | 300 | 300 | 900 |
| NinjaOne | 900 | 900 | 300 | 900 |
| Azure Monitor | 900 | 300 | 300 | 900 |
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.