15 Diagnóstico y resolución de problemas
15.1 Niveles de log#
Tabla 15.1. Niveles de log
| Nivel | Qué se registra |
|---|---|
| 3 | Errores (valor por defecto). |
| 4 | Avisos. |
| 5 | Eventos relevantes: arranque de monitores, errores de conexión y reintentos. |
| 6 | Información de funcionamiento: ejecuciones y tiempo hasta el siguiente ciclo. |
| 7 | Depuración, incluida la configuración completa del monitor al arrancar. |
| 9 | Además, el texto de cada SQL ejecutado y cada fila obtenida. |
| 10 | Además, la estructura completa de los XML analizados. |
El nivel se puede fijar para todo el demonio en databbix.conf o solo para un monitor en su fichero. Los niveles 9 y 10 generan mucho volumen: conviene usarlos solo durante las pruebas.
Seguridad. Los niveles altos de log están pensados para depurar y registran datos sensibles. Desde el nivel 7, el log incluye los tokens de sesión que obtienen los autenticadores de servicios web. Desde el nivel 9, incluye también las credenciales completas (usuario, contraseña y demás datos) que se envían al servicio, porque pueden ser la causa del problema que se está depurando. Los logs se crean con permisos 0640; aun así, al terminar de depurar baje el nivel y borre los logs generados con esos niveles.
Cada monitor escribe en su propio fichero, por defecto /var/log/databbix/<Name>.log. El proceso principal escribe en databbix.log.
15.2 Problemas frecuentes#
| Síntoma | Causa probable y solución |
|---|---|
| El monitor no arranca: “General.Name is not present” u otro parámetro obligatorio | Falta ese parámetro en el .conf. Revise las secciones [General], [Zabbix], [Data] y la del motor. |
| “Monitor initialization error” con un error de sintaxis | Error en el XML: atributo desconocido, consulta sin module, ítem duplicado… El mensaje indica la consulta afectada. |
| “Item name … already defined” | Dos consultas definen el mismo nombre de ítem en los ficheros cargados. |
| “Zabbix server error …, retry in 60 seconds” | No se llega al servidor Zabbix, o el servidor no conoce el host. Compruebe Server, Port, el cortafuegos y que el Host name de Zabbix coincide con General.Name. |
| “Error connecting to data source” | Cadena de conexión, usuario o contraseña incorrectos, o variables TNS_ADMIN/ODBCINI sin definir para el servicio. |
| El ítem aparece como no soportado en Zabbix | El nombre del ítem no existe en los XML cargados, el número de parámetros de la clave no coincide, la fila buscada no existe (use default), la consulta básica devuelve 0 o varias filas, o el SQL falla (véase el log con nivel 9). |
| “Excessive execution time” | La consulta tarda más que maxExecTime/MaxQueryExecTimeLog. Optimice el SQL o aumente maxCache para ejecutarla menos. |
| “Too many errors …, exiting” | El monitor ha superado MaxErrors ejecuciones fallidas seguidas y se ha detenido. Corrija la causa y reinicie el servicio. |
| Los ítems nuevos tardan en recibir datos | Databbix pide la lista de ítems cada Zabbix.Refresh segundos. Espere o reinicie el servicio. |
Los cambios en el XML o el .conf no se aplican |
Solo se leen al arrancar. Reinicie el servicio. |