Errores del recolector
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
| Tipo | Se muestra como | Significa | Cuenta para Sin conexión |
|---|---|---|---|
unreachable | Inaccesible | Error de red, nombre sin resolver, conexión rechazada o interrumpida, error en el protocolo de enlace TLS | Sí |
auth | Inicio de sesión rechazado | Error de inicio de sesión, o el inicio de sesión no puede abrir la base de datos que necesita | Sí |
timeout | Tiempo de espera agotado | La conexión, o la comprobación completa, tardó más de lo permitido | Sí |
query | La consulta falló | El sistema respondió, pero la instrucción falló, normalmente por un permiso que falta | No |
query_timeout | La consulta tardó demasiado | Se conectó, pero la instrucción superó su tiempo de espera | No |
config | Configuración | Algo que debes corregir en Excubius: falta el host, falta la credencial o es de un tipo incorrecto, un secreto no se puede leer | No |
unsupported | No compatible | El recolector no tiene un transporte para esta comprobación | No |
internal | Error del recolector | Un error de programación en el recolector; el mensaje indica dónde | No |
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 como | Normalmente | Qué revisar |
|---|---|---|
| Credenciales rechazadas | Clave o secreto incorrecto o vencido, o región incorrecta | Reemplaza el secreto, revisa la región o el centro de datos |
| Falta un permiso | Falta un rol o un ámbito | Probar indica qué lectura falló; concede lo que indica Permisos |
| No encontrado | Id. de cuenta, organización o suscripción incorrecto | Revisa los id. en la fuente |
| Límite de peticiones | La plataforma limita las solicitudes | Sube los intervalos de sondeo |
| Inaccesible, Tiempo de espera agotado | El servidor no puede llegar a la API de la plataforma | Permite el HTTPS saliente hacia la plataforma |
| Error de la plataforma | La API de la plataforma respondió con un error | Vuelve a intentarlo más tarde; revisa el estado de la plataforma |
| Secretos ilegibles | EXCUBIUS_DATA_KEY cambió desde que se guardaron los secretos | Vuelve a escribirlos |
| Ningún recolector la tomó | El recolector no está en ejecución | Consulta la sección anterior |
| Actualidad de los datos Desactualizada | Ningú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 Rechazados | La fuente está desactivada o en modo Sondeo, o el encabezado secreto es incorrecto | Revisa el modo y el encabezado que envía la plataforma |