Arquitectura
Excubius se ejecuta como un pequeño conjunto de contenedores en un solo servidor Linux que tú controlas. Un recolector de solo lectura y las herramientas de monitoreo que ya tienes alimentan una sola canalización que convierte todo en recursos, estados y alertas, lo guarda en una sola base de datos y lo entrega a la aplicación web, a Slack, a Jira y a una página de estado pública. En este artículo se explica cada parte, cómo una medición se convierte en una alerta, cómo se organiza el servidor y qué se guarda en cada lugar.
Las partes y cómo se conectan
| Parte | Qué hace |
|---|---|
| Recolector | Ejecuta las comprobaciones del catálogo contra tus sistemas: T-SQL para SQL Server, HTTP y DNS para endpoints, certificados y dominios, las API de Azure y Microsoft Graph, y búsquedas en Wazuh. Windows por WinRM y Linux por SSH son experimentales. También consulta por sondeo las herramientas que ya tienes. Se conecta con credenciales sin permisos de escritura y guarda sus resultados en un búfer mientras el servidor está ocupado o se reinicia |
| Fuentes | New Relic, NinjaOne y Azure Monitor, cada una leída por sondeo, por webhook o de ambas formas. Lo que informan se une a la misma canalización que los resultados del recolector, así que sus alertas llegan a la misma bandeja y a los mismos canales |
| Normalizador | Convierte cada entrada en las mismas tres formas: un recurso, un resultado de comprobación o una alerta. Los recursos se emparejan entre fuentes por identificadores como el ID de recurso de Azure, el nombre de host y el FQDN, así que un servidor visto por tres herramientas es un solo recurso |
| Motor de alertas | Compara cada resultado con sus umbrales efectivos; abre, escala y resuelve alertas; elimina duplicados; las agrupa bajo una causa raíz; retiene las notificaciones durante los silencios y las ventanas de mantenimiento, y calcula el estado de cada recurso |
| Base de datos | PostgreSQL 16 con TimescaleDB guarda todo: la configuración, los recursos, las métricas, las alertas con sus historiales, los hallazgos y el registro de auditoría |
| API y aplicación web | La API atiende a la aplicación web y comprueba cada solicitud contra tu rol en la entidad a la que se refiere. La aplicación web funciona en cualquier navegador actual y se instala en un teléfono o una tableta. La página de estado pública se genera solo a partir de lo que los administradores decidieron publicar |
| Notificaciones | Los mensajes de Slack salen justo después de guardar los resultados, y un proceso en segundo plano envía cada 15 segundos lo que tuvo que esperar. Un Slack lento o no disponible nunca retrasa el monitoreo. Las incidencias de Jira se crean a petición y se les da seguimiento hasta que se completan |
Cómo una medición se convierte en una alerta
- El recolector ejecuta una comprobación cuando le toca y envía el resultado a la API por la red interna del servidor. Una fuente, en cambio, informa mediante un sondeo o un webhook.
- El resultado se guarda primero, para que nada se pierda si falla un paso posterior. Sus valores se escriben en el historial de métricas.
- El motor de alertas compara el valor con los umbrales efectivos de esa comprobación en ese recurso. Cuando una condición se mantiene durante toda su duración
for, abre una alerta o actualiza la que ya está abierta para la misma condición. - Se vuelve a calcular el estado del recurso, y la aplicación web lo muestra en su siguiente actualización.
- El paso de notificación decide si el cambio merece un mensaje, encuentra los canales a través del árbol de entidades y registra cada mensaje en el historial de la alerta.
En Alertas y notificaciones se explican en detalle los pasos 3 a 5, y en Umbrales y líneas base se explica de dónde salen los umbrales efectivos.
Un servidor, seis contenedores
Todo se ejecuta en un servidor con Rocky Linux 9 o 10, u otro sistema de la familia Red Hat Enterprise Linux, en x86_64. El mínimo es 2 vCPU, 4 GiB de memoria y 20 GiB de disco libre. Los contenedores se ejecutan sin root con Podman bajo una cuenta de servicio, excubius de forma predeterminada, y se inician con el servidor. No hay código fuente en el servidor: una versión es un conjunto de imágenes de contenedor más un paquete de implementación, que el instalador instala y actualiza.
| Contenedor | Función |
|---|---|
proxy | El único contenedor con puertos abiertos, el 80 y el 443. Termina TLS, envía las solicitudes a la aplicación web o a la API y limita la frecuencia de los webhooks |
frontend | Sirve la aplicación web |
backend | La API, el normalizador, el motor de alertas, las notificaciones, Jira y la página de estado pública |
collector | El recolector y el sondeo de las fuentes. No abre ningún puerto y solo recibe su propio token y su configuración, nunca la contraseña de la base de datos ni la clave que cifra los secretos guardados |
certs | Emite y renueva el certificado TLS: Let's Encrypt, autofirmado o el tuyo propio |
db | PostgreSQL 16 con TimescaleDB |
El recolector se comunica con la API solo por la red interna del servidor: el proxy rechaza las rutas del recolector que llegan desde fuera. De salida, el servidor necesita HTTPS hacia Slack, Jira y las API de tus fuentes. El módulo de actualizaciones también lee fuentes públicas de compilaciones y avisos, y usa las copias que vienen con la versión cuando el servidor no puede llegar a ellas. En Azure, asigna a la identidad administrada del servidor roles de solo lectura, como Reader y Monitoring Reader, para que el recolector lea Azure sin un secreto guardado.
Apunta un monitor de disponibilidad externo a https://<your host>/heartbeat. Responde ok mientras el servidor funciona, así te enteras cuando el propio Excubius está caído.
Qué se guarda dónde
| Dato | Dónde | Cuánto tiempo |
|---|---|---|
| Entidades, recursos, comprobaciones, umbrales, usuarios y roles | Base de datos | Hasta que los cambies |
| Métricas | Base de datos, en una hypertable de TimescaleDB | 90 días |
| Alertas, hallazgos, sus historiales, quién las vio y asignaciones | Base de datos | Se conservan como historial |
| Cargas de webhooks de las fuentes | Base de datos | 30 días |
| Historial de la puntuación de seguridad | Base de datos | Una instantánea por hora durante 14 días y luego una al día durante 400 días |
| Registro de auditoría | Base de datos | Se conserva |
| Credenciales y secretos de las fuentes | Base de datos, cifrados con una clave que solo se guarda en el archivo de configuración del servidor | Hasta que los reemplaces o los quites |
| Configuración del servidor: contraseña de la base de datos, secreto de firma de sesiones, clave de cifrado, token del recolector | El archivo .env del directorio de instalación, /opt/excubius de forma predeterminada | El instalador los genera una sola vez |
| Certificado TLS | Un volumen del contenedor certs | Se renueva automáticamente cuando quedan 30 días o menos |
| Copias de seguridad de la base de datos | La carpeta backups del directorio de instalación: un volcado cada día a las 02:30, hora del servidor | Los últimos 14 volcados |
Los secretos son de solo escritura: una vez guardados, nadie puede volver a leerlos en la aplicación web ni a través de la API. Un volcado de la base de datos por sí solo no revela ningún secreto, porque la clave no está en la base de datos; por la misma razón, guarda una copia del archivo .env con tus copias de seguridad, o tendrás que volver a escribir los secretos guardados de una base de datos restaurada. Copia las copias de seguridad diarias fuera del servidor con tu respaldo habitual de servidores; en Actualizar, hacer copias de seguridad y restaurar se explica cómo restaurarlas.
Solo lectura por diseño
Excubius detecta, explica y sugiere; nunca cambia un sistema monitoreado.
- Los usuarios de monitoreo y las credenciales de API se crean sin permisos de escritura ni de instalación. Un usuario de SQL Server nunca necesita
sysadmin. - Los hallazgos de seguridad y los avisos de actualizaciones incluyen una acción sugerida en forma de texto para que una persona la siga en una ventana de cambios. No se ejecuta ni se instala nada.
- No se escribe nada en New Relic, NinjaOne, Azure, Microsoft Entra ID ni Wazuh.
- Eliminar un recurso en Excubius elimina sus comprobaciones, métricas y alertas solo en Excubius. El sistema monitoreado no se toca.
Cuando algo falla
| Falla | Qué hace Excubius |
|---|---|
| La API de una fuente no responde | La fuente pasa a desactualizada y muestra el error. No se resuelve nada a partir de un sondeo fallido y no se inventa ninguna alerta |
| El recolector no puede llegar a un recurso | Después de tres fallas seguidas de conexión, de inicio de sesión o de tiempo de espera, el recurso pasa a Crítico con una sola alerta Sin conexión, y las demás alertas del recurso quedan a la espera detrás de ella |
| La API o la base de datos no están disponibles por un momento | El recolector conserva sus resultados y los envía más tarde. Un resultado enviado dos veces se guarda una sola vez |
| Slack no está disponible | El monitoreo continúa. El mensaje fallido se registra en la alerta y se reintenta, tres intentos en total |
| El servidor de Excubius está caído | Los webhooks enviados mientras tanto se pierden. Las fuentes en modo híbrido los recuperan en la siguiente conciliación |