Cómo funciona el recolector
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
- 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.
- 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.
- 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.
- 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.
| Transporte | Llega a | Puerto | Tipo de credencial | Estado |
|---|---|---|---|---|
| T-SQL (Microsoft ODBC Driver 18) | Instancias de SQL Server, grupos de disponibilidad, servidores vinculados, el registro de ejecución de Reporting Services | 1433 o el puerto de la instancia; UDP 1434 para instancias con nombre sin puerto fijo | Inicio de sesión de SQL | Compatible |
| HTTP(S) | Puntos de conexión web, portales de Reporting Services, certificados TLS, vencimiento de dominios (RDAP) | 443, 80 | Ninguna, cuenta de Windows (NTLM), usuario y contraseña HTTP, token de portador | Compatible |
| DNS | Resolución de nombres de los puntos de conexión y de los listeners de los grupos de disponibilidad, con el resolvedor del servidor | 53 | Ninguna | Compatible |
| Azure Resource Graph | Comprobaciones de postura en la nube, evaluaciones de Defender for Cloud, Azure Update Manager, Service Health | 443 | La identidad administrada del servidor o una entidad de servicio de Azure | Compatible |
| Microsoft Graph | Comprobaciones de identidad de Entra ID | 443 | La identidad administrada del servidor o una entidad de servicio de Azure | Compatible |
| Wazuh | El indexador de Wazuh y, opcionalmente, la API del administrador | Las URL que configures | Usuario y contraseña HTTP | Compatible cuando Wazuh está activado |
| WinRM | Comprobaciones de hosts Windows y de Active Directory | 5986 (HTTPS) | Cuenta de Windows | Experimental |
| SSH | Comprobaciones de hosts Linux | 22, o el ssh_port del host | Clave SSH, contraseña SSH | Experimental |
| PostgreSQL | Comprobaciones del módulo PostgreSQL | 5432 | Inicio de sesión de SQL | Todavía no disponible: las comprobaciones se agregan pero permanecen en Desconocido |
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ódulo | Se recopila mediante | Lo que proporcionas |
|---|---|---|
| SQL Server, grupos de disponibilidad, seguridad de SQL Server | T-SQL | Un inicio de sesión de SQL de solo lectura en cada instancia y réplica |
| Windows | WinRM (experimental), o New Relic y NinjaOne | Una cuenta de Windows en tres grupos locales de lectura, o una fuente |
| Linux | SSH (experimental), o New Relic y NinjaOne | Un usuario que no sea root con una clave, o una fuente |
| PostgreSQL | Todavía no disponible de forma nativa; los servidores flexibles de Azure mediante Azure Monitor | Un rol con pg_monitor, listo para cuando llegue la recopilación |
| Azure, Azure Data Factory | La fuente Azure Monitor | Reader y Monitoring Reader, más un rol de solo lectura de Data Factory |
| Pruebas sintéticas | HTTP, DNS, T-SQL | Credenciales solo para los puntos de conexión protegidos y los servidores de informes |
| Vencimientos | Azure Monitor, HTTP (RDAP), T-SQL, WinRM | Permisos de lectura de Key Vault y Microsoft Graph |
| Actualizaciones | Feeds de los proveedores que lee la API, más comprobaciones de inventario | HTTPS de salida desde el servidor hacia los feeds |
| Seguridad de identidades | Microsoft Graph, WinRM | Permisos de aplicación de Graph de solo lectura |
| Seguridad en la nube | Resource Graph, Defender for Cloud, Wazuh | Reader y Security Reader; un usuario de Wazuh de solo lectura |
| New Relic, NinjaOne | Su fuente | Una 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.
| Hacia | Puerto | Para |
|---|---|---|
| Cada instancia de SQL Server, réplica, nombre de listener e IP de listener | El puerto SQL, 1433 de forma predeterminada | Módulos de SQL Server, grupos de disponibilidad, consultas sintéticas de ida y vuelta a SQL |
| Instancias con nombre sin puerto fijo | UDP 1434 | SQL Server Browser |
| Puntos de conexión web y portales de Reporting Services | 443, 80 | Pruebas sintéticas, certificados TLS |
| El resolvedor DNS del servidor | 53 | Comprobaciones de resolución de nombres |
data.iana.org y los servidores RDAP de los registros | 443 | Vencimiento de dominios |
| Hosts Windows | 5986 | WinRM (experimental) |
| Hosts Linux | 22 | SSH (experimental) |
management.azure.com, graph.microsoft.com, tus almacenes de claves (*.vault.azure.net) y login.microsoftonline.com cuando usas una entidad de servicio | 443 | Fuente Azure Monitor, comprobaciones de postura y de identidad de Azure |
api.newrelic.com o api.eu.newrelic.com | 443 | Fuente New Relic |
app.ninjarmm.com, o eu., oc. o ca.ninjarmm.com | 443 | Fuente NinjaOne |
| El indexador y el administrador de Wazuh | Sus puertos | Wazuh |
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ímite | Valor |
|---|---|
| Comprobaciones que se ejecutan a la vez | 32 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 Server | 10 s · 30 s (parámetros del catálogo timeout_seconds, query_timeout_seconds) |
| Filas leídas por consulta | 1,000 |
| Tiempo máximo de ejecución de una comprobación | 120 s |
| Resultados que se conservan mientras no se puede llegar a la API | 10,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:
SELECTsobre las vistas de administración dinámica, las vistas de catálogo, las tablas de copias de seguridad y de trabajos demsdby la tablaExecutionLog3del servidor de informes;sys.sp_readerrorlogen una variable de tabla;sp_testlinkedserverpara los servidores vinculados. - HTTP: solo
GETyHEAD. - Azure y Wazuh: lecturas, más las pocas solicitudes
POSTque son consultas, como una consulta de Resource Graph, una consulta de ejecuciones de Data Factory o un_searchde 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.