Saltar al contenido principal
Versión: 0.4 · actual

Agregar un recurso

Guía paso a pasoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Un recurso es algo que Excubius monitorea: una instancia de SQL Server, un punto de conexión web, un servidor de informes, un host. Cuando agregas uno, Excubius configura de inmediato las comprobaciones predeterminadas de su tipo. Esta guía muestra cómo agregar un recurso con el asistente Agregar recurso, probar su conexión, descubrir lo que se ejecuta en él, y editarlo o eliminarlo.

Antes de empezar​

  • Necesitas el rol Administrador de entidad en la entidad que contendrá el recurso.
  • La credencial que necesita el recurso está guardada, o estás listo para crearla en el asistente. Consulta Guardar una credencial para el recolector.
  • El servidor de Excubius llega al sistema en el puerto correcto. Consulta Rutas de red.

Los recursos que informa una fuente, como los recursos de Azure desde Azure Monitor o los dispositivos desde NinjaOne, aparecen por sí solos. Solo agregas lo que alcanza el recolector nativo. Las bases de datos y los servidores vinculados tampoco se agregan a mano: los descubres desde su instancia.

Agregar el recurso​

  1. Abre Recursos y selecciona Agregar recurso.
  2. Tipo: elige qué es. Cada tipo muestra cuántas comprobaciones recibe de forma predeterminada y los datos que necesita.
  3. Ubicación y nombre: elige la Entidad, que decide lo que hereda (umbrales, canales, credenciales), y escribe el Nombre que se muestra en todas partes, por ejemplo sql-ventas-01.
  4. Conexión: escribe los datos del tipo, primero los obligatorios. Se validan antes de continuar.
  5. Etiquetas: agrega pares key:value, al menos env, role y client, y una Criticidad de 1 (baja) a 5 (crítica).
  6. Credencial: elige una credencial adecuada que esté a su alcance, Ninguna para usar la del recurso padre, o Nueva credencial para crear una aquí.
  7. En Revisión, comprueba lo que escribiste y selecciona Crear recurso.

Las comprobaciones predeterminadas se configuran de inmediato y los primeros valores llegan en uno o dos minutos. La última pantalla ofrece Probar conexión, Descubrir para las instancias de SQL Server, Abrir el recurso y Agregar otro.

Datos por tipo​

TipoObligatorioOtros datos
Instancia de SQL Serverhostport (1433 de forma predeterminada); instance para una instancia con nombre sin puerto fijo, a la que se llega mediante SQL Server Browser en UDP 1434
Grupo de disponibilidad Always Onag_nameNormalmente lo crea el descubrimiento, con su listener, sus réplicas y sus bases de datos
SQL Server Reporting Servicesportal_urltest_report_path para representar un informe; host, port, instance y report_server_db (ReportServer de forma predeterminada) para la comprobación del registro de ejecución
Punto de conexión web / portalurlexpect_status, expect_text; domain (el dominio registrable) para el vencimiento del dominio
Servidor Windows—ip; sin ella, el recolector se conecta al nombre del recurso
Servidor Linux—ip y ssh_port (22 de forma predeterminada); sin ip, el recolector se conecta al nombre del recurso
Servidor PostgreSQL—host, port
Inquilino de Entra ID / servicios de dominio—tenant_id, domain; contiene las comprobaciones de identidad
La propia plataforma de monitoreo—heartbeat_url; contiene las comprobaciones de toda la plataforma, como los feeds de actualizaciones y la postura en la nube
Recursos de Azure—resource_id; normalmente los agrega la fuente Azure Monitor

Probar la conexión​

En la página del recurso, selecciona Probar conexión. El recolector toma la prueba en unos 10 segundos y se conecta con la credencial del recurso.

TipoUna prueba correcta muestra
Instancia de SQL Server, grupo de disponibilidadEl nombre del servidor, la versión, la edición y la latencia, los permisos del inicio de sesión con los que falten, y una advertencia cuando el inicio de sesión es sysadmin
Servidor de informes, punto de conexión webLa dirección, el estado HTTP, la versión y la latencia

Una prueba fallida muestra el tipo de error con una sugerencia:

Tipo de errorRevisa
authEl inicio de sesión y la contraseña, y que la instancia acepte inicios de sesión de SQL
unreachableEl nombre de host, el puerto y el firewall entre el servidor de Excubius y el sistema
timeoutLa ruta de red; el sistema no respondió a tiempo
queryUn permiso que le falta al inicio de sesión
configAlgo que hay que corregir en Excubius: el host, la credencial o un secreto guardado

Cuando la prueba se queda en esperando al recolector y termina con Ningún recolector la tomó, el recolector no está en ejecución, no tiene token o no ofrece ese transporte. Consulta Errores del recolector.

Descubrir lo que se ejecuta en una instancia​

En una instancia de SQL Server, selecciona Descubrir. El descubrimiento lee el servidor, sus grupos de disponibilidad con sus réplicas, roles y listener, sus bases de datos, sus servidores vinculados y un resumen del Agente SQL. Los agrega, o los actualiza, como recursos hijos con sus propias comprobaciones, e informa cuántos se crearon, cuántos se actualizaron y cuántos ya no se encontraron.

  • Vuelve a ejecutar el descubrimiento cada vez que cambie la topología.
  • Un hijo que ya no se encuentra se marca como falta y se conserva con su historial. El descubrimiento nunca lo elimina; elimínalo tú cuando haya desaparecido definitivamente.
  • En un grupo de disponibilidad, agrega cada réplica como instancia y ejecuta el descubrimiento en una de ellas. Consulta Inicio rápido: agregar un grupo de disponibilidad.

Editar o eliminar un recurso​

  • Editar cambia el nombre, la criticidad, las etiquetas y la credencial. Los datos de conexión y la entidad se cambian mediante la API: PATCH /api/v1/resources/{id} con attributes o entity_id.
  • Eliminar quita el recurso con sus hijos descubiertos, sus comprobaciones, sus métricas y sus alertas. El sistema monitoreado en sí nunca se toca.

Los editores activan o desactivan las comprobaciones y cambian su intervalo y sus umbrales para un recurso en su pestaña Comprobaciones; consulta Recursos y la página del recurso.