Saltar al contenido principal
Versión: 0.4 · actual

Cómo funciona el recolector

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

El recolector es la parte de Excubius que llega a tus sistemas. Ejecuta las comprobaciones del catálogo mediante conexiones de solo lectura, lee las fuentes que agregas y envía los resultados sin procesar a la API, que los evalúa, genera alertas y notifica. Este artículo explica cómo funciona, qué transportes usa, qué necesita cada módulo, qué rutas de red debes abrir y qué no hace nunca.

Cómo se ejecuta una comprobación​

  1. Cada 30 segundos, el recolector pregunta a la API qué debe ejecutar: las definiciones de las comprobaciones del catálogo, los recursos a los que se dirigen y las credenciales que usan. Cuando nada cambió, la respuesta está vacía y casi no cuesta nada.
  2. Ejecuta cada comprobación en su intervalo mediante el transporte que indica el catálogo, como T-SQL para una instancia de SQL Server o HTTP para un punto de conexión web.
  3. Envía los resultados sin procesar a la API por lotes. La API los compara con los umbrales efectivos, abre y resuelve alertas y notifica a los canales correspondientes.
  4. Cada 10 segundos toma los trabajos puntuales, como Probar conexión, Descubrir y las acciones Probar y Sincronizar ahora de una fuente. Cada 60 segundos envía un latido, que muestra la zona Fuentes de la Vista general.

El recolector se ejecuta dentro del servidor de Excubius, junto a la API. Solo recibe su propio token y su configuración; nunca ve la contraseña de la base de datos ni la clave que cifra los secretos guardados. Las credenciales le llegan por la red interna, permanecen en memoria y nunca se registran.

Transportes​

Un transporte es la forma en que el recolector se comunica con un tipo de sistema. Todos ellos solo leen.

TransporteLlega aPuertoTipo de credencialEstado
T-SQL (Microsoft ODBC Driver 18)Instancias de SQL Server, grupos de disponibilidad, servidores vinculados, el registro de ejecución de Reporting Services1433 o el puerto de la instancia; UDP 1434 para instancias con nombre sin puerto fijoInicio de sesión de SQLCompatible
HTTP(S)Puntos de conexión web, portales de Reporting Services, certificados TLS, vencimiento de dominios (RDAP)443, 80Ninguna, cuenta de Windows (NTLM), usuario y contraseña HTTP, token de portadorCompatible
DNSResolución de nombres de los puntos de conexión y de los listeners de los grupos de disponibilidad, con el resolvedor del servidor53NingunaCompatible
Azure Resource GraphComprobaciones de postura en la nube, evaluaciones de Defender for Cloud, Azure Update Manager, Service Health443La identidad administrada del servidor o una entidad de servicio de AzureCompatible
Microsoft GraphComprobaciones de identidad de Entra ID443La identidad administrada del servidor o una entidad de servicio de AzureCompatible
WazuhEl indexador de Wazuh y, opcionalmente, la API del administradorLas URL que configuresUsuario y contraseña HTTPCompatible cuando Wazuh está activado
WinRMComprobaciones de hosts Windows y de Active Directory5986 (HTTPS)Cuenta de WindowsExperimental
SSHComprobaciones de hosts Linux22, o el ssh_port del hostClave SSH, contraseña SSHExperimental
PostgreSQLComprobaciones del módulo PostgreSQL5432Inicio de sesión de SQLTodavía no disponible: las comprobaciones se agregan pero permanecen en Desconocido
aviso

Los transportes WinRM y SSH existen y sus comprobaciones se agregan a los hosts Windows y Linux, pero todavía no se han validado con hosts reales. Para esos hosts, usa NinjaOne, New Relic o Azure Monitor como fuente hasta que una versión los marque como compatibles.

El recolector también lee las fuentes, por HTTPS (443), cada una con su propio adaptador: New Relic mediante NerdGraph, NinjaOne mediante su API pública, y Azure Monitor mediante Azure Resource Manager, Resource Graph, Azure Monitor, Data Factory, Key Vault y Microsoft Graph. Consulta Fuentes.

De forma predeterminada, el recolector ofrece todos los transportes cuyas bibliotecas están presentes en su imagen. EXCUBIUS_COLLECTOR_TRANSPORTS reduce esa lista; consulta Variables de entorno.

Qué necesita cada módulo​

MóduloSe recopila medianteLo que proporcionas
SQL Server, grupos de disponibilidad, seguridad de SQL ServerT-SQLUn inicio de sesión de SQL de solo lectura en cada instancia y réplica
WindowsWinRM (experimental), o New Relic y NinjaOneUna cuenta de Windows en tres grupos locales de lectura, o una fuente
LinuxSSH (experimental), o New Relic y NinjaOneUn usuario que no sea root con una clave, o una fuente
PostgreSQLTodavía no disponible de forma nativa; los servidores flexibles de Azure mediante Azure MonitorUn rol con pg_monitor, listo para cuando llegue la recopilación
Azure, Azure Data FactoryLa fuente Azure MonitorReader y Monitoring Reader, más un rol de solo lectura de Data Factory
Pruebas sintéticasHTTP, DNS, T-SQLCredenciales solo para los puntos de conexión protegidos y los servidores de informes
VencimientosAzure Monitor, HTTP (RDAP), T-SQL, WinRMPermisos de lectura de Key Vault y Microsoft Graph
ActualizacionesFeeds de los proveedores que lee la API, más comprobaciones de inventarioHTTPS de salida desde el servidor hacia los feeds
Seguridad de identidadesMicrosoft Graph, WinRMPermisos de aplicación de Graph de solo lectura
Seguridad en la nubeResource Graph, Defender for Cloud, WazuhReader y Security Reader; un usuario de Wazuh de solo lectura
New Relic, NinjaOneSu fuenteUna clave o un cliente de API de solo lectura

Todos los permisos en un solo lugar: Permisos.

Rutas de red​

Todas las conexiones empiezan en el servidor de Excubius. Nada se conecta al recolector.

HaciaPuertoPara
Cada instancia de SQL Server, réplica, nombre de listener e IP de listenerEl puerto SQL, 1433 de forma predeterminadaMódulos de SQL Server, grupos de disponibilidad, consultas sintéticas de ida y vuelta a SQL
Instancias con nombre sin puerto fijoUDP 1434SQL Server Browser
Puntos de conexión web y portales de Reporting Services443, 80Pruebas sintéticas, certificados TLS
El resolvedor DNS del servidor53Comprobaciones de resolución de nombres
data.iana.org y los servidores RDAP de los registros443Vencimiento de dominios
Hosts Windows5986WinRM (experimental)
Hosts Linux22SSH (experimental)
management.azure.com, graph.microsoft.com, tus almacenes de claves (*.vault.azure.net) y login.microsoftonline.com cuando usas una entidad de servicio443Fuente Azure Monitor, comprobaciones de postura y de identidad de Azure
api.newrelic.com o api.eu.newrelic.com443Fuente New Relic
app.ninjarmm.com, o eu., oc. o ca.ninjarmm.com443Fuente NinjaOne
El indexador y el administrador de WazuhSus puertosWazuh

La API, no el recolector, descarga los feeds de actualizaciones y se comunica con Slack y Jira; consulta Variables de entorno. Los webhooks de las fuentes llegan a la dirección pública del servidor por el puerto 443 y van a la API, nunca al recolector.

Límites y tiempos de espera​

LímiteValor
Comprobaciones que se ejecutan a la vez32 en total; por transporte: T-SQL 8, HTTP y DNS 16, SSH 8, WinRM 4, Resource Graph 4, Defender, Microsoft Graph y Wazuh 2
Tiempo de espera de inicio de sesión · tiempo de espera de consulta de SQL Server10 s · 30 s (parámetros del catálogo timeout_seconds, query_timeout_seconds)
Filas leídas por consulta1,000
Tiempo máximo de ejecución de una comprobación120 s
Resultados que se conservan mientras no se puede llegar a la API10,000; los más antiguos se descartan primero

Las sesiones de SQL Server llevan el nombre de aplicación monitoring-collector, para que los administradores de bases de datos puedan reconocerlas en sys.dm_exec_sessions.

Lo que el recolector nunca hace​

El recolector es de solo lectura por aprovisionamiento y por código. Nunca instala, actualiza, reinicia ni detiene nada, nunca escribe datos, registro de Windows ni configuración, nunca termina una sesión y nunca ejecuta una corrección. Una comprobación que necesitara escribir se rechaza cuando se revisa para el catálogo.

Lo que sí envía:

  • SQL Server: SELECT sobre las vistas de administración dinámica, las vistas de catálogo, las tablas de copias de seguridad y de trabajos de msdb y la tabla ExecutionLog3 del servidor de informes; sys.sp_readerrorlog en una variable de tabla; sp_testlinkedserver para los servidores vinculados.
  • HTTP: solo GET y HEAD.
  • Azure y Wazuh: lecturas, más las pocas solicitudes POST que son consultas, como una consulta de Resource Graph, una consulta de ejecuciones de Data Factory o un _search de Wazuh. Cualquier otra cosa se rechaza en el código.
  • WinRM y SSH: los comandos de PowerShell y de shell escritos en el catálogo, que solo leen.

La consulta exacta de cada comprobación está en el catálogo y en la API, en GET /api/v1/catalog/checks/{id}.

Agentes para fuentes opcionales​

Excubius no instala nada en los sistemas que monitorea. Los agentes de las fuentes opcionales, como Wazuh, los despliegan tus propias herramientas, por ejemplo NinjaOne o tu sistema de administración de configuración.

Pasos siguientes​