Saltar al contenido principal
Versión: 0.4 · actual

Arquitectura

ConceptoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad, Superadministrador, Instalador (administrador de Linux)
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

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​

ParteQué hace
RecolectorEjecuta 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
FuentesNew 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
NormalizadorConvierte 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 alertasCompara 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 datosPostgreSQL 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 webLa 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
NotificacionesLos 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​

  1. 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.
  2. 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.
  3. 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.
  4. Se vuelve a calcular el estado del recurso, y la aplicación web lo muestra en su siguiente actualización.
  5. 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.

ContenedorFunción
proxyEl ú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
frontendSirve la aplicación web
backendLa API, el normalizador, el motor de alertas, las notificaciones, Jira y la página de estado pública
collectorEl 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
certsEmite y renueva el certificado TLS: Let's Encrypt, autofirmado o el tuyo propio
dbPostgreSQL 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.

consejo

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​

DatoDóndeCuánto tiempo
Entidades, recursos, comprobaciones, umbrales, usuarios y rolesBase de datosHasta que los cambies
MétricasBase de datos, en una hypertable de TimescaleDB90 días
Alertas, hallazgos, sus historiales, quién las vio y asignacionesBase de datosSe conservan como historial
Cargas de webhooks de las fuentesBase de datos30 días
Historial de la puntuación de seguridadBase de datosUna instantánea por hora durante 14 días y luego una al día durante 400 días
Registro de auditoríaBase de datosSe conserva
Credenciales y secretos de las fuentesBase de datos, cifrados con una clave que solo se guarda en el archivo de configuración del servidorHasta 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 recolectorEl archivo .env del directorio de instalación, /opt/excubius de forma predeterminadaEl instalador los genera una sola vez
Certificado TLSUn volumen del contenedor certsSe renueva automáticamente cuando quedan 30 días o menos
Copias de seguridad de la base de datosLa carpeta backups del directorio de instalación: un volcado cada día a las 02:30, hora del servidorLos ú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​

FallaQué hace Excubius
La API de una fuente no respondeLa 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 recursoDespué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 momentoEl recolector conserva sus resultados y los envía más tarde. Un resultado enviado dos veces se guarda una sola vez
Slack no está disponibleEl monitoreo continúa. El mensaje fallido se registra en la alerta y se reintenta, tres intentos en total
El servidor de Excubius está caídoLos webhooks enviados mientras tanto se pierden. Las fuentes en modo híbrido los recuperan en la siguiente conciliación