Saltar al contenido principal
Versión: 0.4 · actual

Errores del recolector

Solución de problemasRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad, Editor, Operador
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Cuando una comprobación no se puede ejecutar, informa un tipo de error en lugar de un valor. El tipo aparece en la comprobación, en el historial del recurso y en el resultado de Probar conexión, y acota la causa. Este artículo enumera todos los tipos, explica la alerta Sin conexión e indica qué revisar en cada síntoma, tanto para las comprobaciones como para las fuentes.

Tipos de error​

TipoSe muestra comoSignificaCuenta para Sin conexión
unreachableInaccesibleError de red, nombre sin resolver, conexión rechazada o interrumpida, error en el protocolo de enlace TLSSí
authInicio de sesión rechazadoError de inicio de sesión, o el inicio de sesión no puede abrir la base de datos que necesitaSí
timeoutTiempo de espera agotadoLa conexión, o la comprobación completa, tardó más de lo permitidoSí
queryLa consulta fallóEl sistema respondió, pero la instrucción falló, normalmente por un permiso que faltaNo
query_timeoutLa consulta tardó demasiadoSe conectó, pero la instrucción superó su tiempo de esperaNo
configConfiguraciónAlgo que debes corregir en Excubius: falta el host, falta la credencial o es de un tipo incorrecto, un secreto no se puede leerNo
unsupportedNo compatibleEl recolector no tiene un transporte para esta comprobaciónNo
internalError del recolectorUn error de programación en el recolector; el mensaje indica dóndeNo

Un recurso muestra una sola alerta "Sin conexión"​

Síntoma. Aparece una alerta crítica Sin conexión en un recurso, y sus demás alertas la indican como su causa raíz.

Causa. De manera predeterminada, 3 ejecuciones consecutivas de una comprobación de ese recurso fallaron con unreachable, auth o timeout. En lugar de una alerta por cada comprobación que falla, Excubius abre una sola alerta y retiene las notificaciones de las demás alertas del recurso mientras está abierta. La cantidad de errores la define EXCUBIUS_UNREACHABLE_AFTER.

Solución. Corrige la conexión y, luego, selecciona Probar conexión en el recurso para confirmarlo. La alerta se resuelve sola en cuanto las comprobaciones que fallaban vuelven a funcionar; hasta entonces, las notificaciones de las demás alertas del recurso quedan en espera.

Las comprobaciones fallan con auth​

Causa. La contraseña es incorrecta o venció, el inicio de sesión está deshabilitado, la instancia no acepta inicios de sesión de SQL, o el inicio de sesión no tiene usuario en una base de datos que abre una comprobación. En un grupo de disponibilidad, el inicio de sesión puede tener un SID distinto en la nueva primaria después de una conmutación por error.

Solución. Revisa la credencial y que la instancia funcione en modo mixto. En los grupos de disponibilidad, crea el inicio de sesión con el mismo SID en todas las réplicas; consulta Requisitos previos para grupos de disponibilidad.

Las comprobaciones fallan con unreachable o timeout​

Causa. El nombre de host no se resuelve desde el servidor de Excubius, un firewall bloquea el puerto, el servicio no está activo o la ruta de red es lenta.

Solución. Revisa el DNS y el firewall entre el servidor de Excubius y el sistema, en el puerto correcto: el puerto SQL (y UDP 1434 para las instancias con nombre sin puerto fijo), 443 u 80 para los puntos de conexión web, 5986 para WinRM, 22 para SSH. En los listeners de varias subredes, permite todas las IP del listener. Consulta Rutas de red.

Las comprobaciones fallan con query​

Causa. El sistema respondió, pero rechazó la instrucción, casi siempre porque al inicio de sesión le falta un permiso. Una comprobación que necesita msdb o CONNECT ANY DATABASE falla así mientras las demás funcionan.

Solución. Selecciona Probar conexión: en SQL Server, enumera los permisos del inicio de sesión y lo que falta. Concede lo que indica Permisos, y nada más.

Las comprobaciones fallan con query_timeout​

Causa. La instrucción se ejecutó durante más tiempo que su tiempo de espera, 30 segundos de manera predeterminada en SQL Server, normalmente en una instancia con mucha carga.

Solución. Vuelve a intentarlo más tarde. Si persiste en una instancia muy ocupada, sube el parámetro query_timeout_seconds de la comprobación para ese recurso.

Las comprobaciones fallan con config​

Causa. Algo está incompleto en Excubius: el recurso no tiene host, ninguna credencial llega a él, la credencial es de un tipo que la comprobación no puede usar, o el secreto guardado no se puede descifrar porque cambió EXCUBIUS_DATA_KEY.

Solución. Edita el recurso o la credencial. Una comprobación debajo de un servidor de informes que tiene una cuenta de Windows necesita un inicio de sesión de SQL para sus comprobaciones de T-SQL; consulta Qué credencial usa un recurso. Si los secretos no se pueden leer, vuelve a escribirlos.

Las comprobaciones fallan con unsupported, o siguen en Desconocido​

Causa. Ningún recolector ofrece el transporte que necesita la comprobación. Puede que EXCUBIUS_COLLECTOR_TRANSPORTS lo excluya, o que el transporte todavía no exista: las comprobaciones de PostgreSQL siguen en Desconocido en esta versión.

Solución. Quita el transporte de la restricción, o desactiva la comprobación en ese recurso. Consulta Compatibilidad.

Un trabajo termina con "Ningún recolector la tomó"​

Síntoma. Probar conexión, Descubrir o el botón Probar de una fuente se queda en esperando al recolector y luego termina con Ningún recolector la tomó.

Causa. Ningún recolector tomó el trabajo en 10 minutos. El recolector no está en ejecución, no tiene token (EXCUBIUS_COLLECTOR_TOKEN está vacío y, en ese caso, queda inactivo) o no ofrece el transporte. Un trabajo que un recolector tomó pero cuyo resultado no informó en 15 minutos falla con timeout.

Solución. Revisa el último latido del recolector en la zona Fuentes de la Vista general. En el servidor, como la cuenta de servicio, ejecuta <dir>/current/scripts/compose.sh ps y <dir>/current/scripts/compose.sh logs collector.

Errores de las fuentes​

Una fuente muestra su último error con uno de estos tipos:

Se muestra comoNormalmenteQué revisar
Credenciales rechazadasClave o secreto incorrecto o vencido, o región incorrectaReemplaza el secreto, revisa la región o el centro de datos
Falta un permisoFalta un rol o un ámbitoProbar indica qué lectura falló; concede lo que indica Permisos
No encontradoId. de cuenta, organización o suscripción incorrectoRevisa los id. en la fuente
Límite de peticionesLa plataforma limita las solicitudesSube los intervalos de sondeo
Inaccesible, Tiempo de espera agotadoEl servidor no puede llegar a la API de la plataformaPermite el HTTPS saliente hacia la plataforma
Error de la plataformaLa API de la plataforma respondió con un errorVuelve a intentarlo más tarde; revisa el estado de la plataforma
Secretos ilegiblesEXCUBIUS_DATA_KEY cambió desde que se guardaron los secretosVuelve a escribirlos
Ningún recolector la tomóEl recolector no está en ejecuciónConsulta la sección anterior
Actualidad de los datos DesactualizadaNingún sondeo correcto en tres intervalos, como mínimo 15 minutos; en una fuente de solo webhook, no se recibió nada en un día¿Está en ejecución el recolector? ¿La plataforma está enviando webhooks?
Webhooks RechazadosLa fuente está desactivada o en modo Sondeo, o el encabezado secreto es incorrectoRevisa el modo y el encabezado que envía la plataforma