En caso de problemas hay un script que se llama verify_pnp_config.pl ubicado en el directorio de scripts. Este script le permite comprobar los valores de configuración, así como los datos de rendimiento de equipos o servicios. Puede usarse antes y durante la ejecución de PNP.

* Nota *: La información que aplica a verify_pnp_config v0.1.16 está disponible en la versión actual de desarrollo (comenzando con la Rev. 644 de SVN) descargable via http://www.pnp4nagios.org/pnp/dwnld. Versiones anteriores pueden tener menos opciones por lo que en la descripción de las opciones encontrará indicios de las versiones de PNP.
* Nota *: Las opciones “long” siempre comienzan con dos ”-” lo que no es claramente visible en el texto.

La comprobación de las configuraciones puede hacerse ejecutando

./verify_pnp_config.pl -m <mode>

sustituyendo <mode> por default, bulk o NPCD. Tenga en cuenta que default corresponde al modo síncrono, bulk al masivo, y NPCD al NPCD.

Especificando la opción -h o –-help muestra respectivamente las siguientes líneas:

-h, --help        print these lines
-b, --basedir=s   Nagios Base directory (default: /usr/local/nagios)
-B, --binary=s    Nagios binary (default: nagios)
-c, --config=s    Nagios main config file (default: /usr/local/nagios/etc/nagios.cfg)
-m, --mode=s      PNP mode ("default", "bulk", "NPCD")
-l, --logfile=s   check configure log file
-N, --npcdcfg=s   PNP config file for NPCD mode (default: /usr/local/pnp4nagios/etc/pnp/npcd.cfg)
-P, --ppcfg=s     process_perfdata config file (default: /usr/local/pnp4nagios/etc/pnp/process_perfdata.cfg)
-C, --cpcfg=s     PNP config file (config.php)
-p, --precheck    use config files instead of objects cache
-r, --rrdtool=s   specify the location of the RRDtool binary
-R, --RRDpath=s   specify the perfdata directory (default: /usr/local/pnp4nagios/var/perfdata) or "no" for no check
-U, --resource=s  location of the resource config file (default: /usr/local/nagios/etc/resource.cfg)
-M, --monitor=s   specify the monitoring product (default: nagios; may be "icinga")
-L, --layout=s    specify a layout (Nagios2, Nagios3, SuSE, Fedora)
-T, --template=s  specify the path to the templates directory (default /usr/local/pnp4nagios/share/templates.dist)
-u, --user=s      user of the perfdata directory
-g, --group=s     group of the perfdata directory 	
-q, --quiet       quiet mode, non-zero return code will indicate errors
-o, --object=s    Nagios object (host name, service description)
-n, --native      show messages in native language (so far "es" or "de")
-e, --english     show english messages/links
-d, --debug       some debugging output

El programa de Nagios y el acceso al archivo de configuración principal son siempre necesarios. Si tiene rutas no estándar debido a que ha instalado un paquete precompilado de Nagios, puede intentar usar una de las configuraciones predefinidas mediante la opción -L. “suse” y “fedora” deberían funcionar en las distribuciones apropiadas, mientras que “nagios2” y “nagios3” deberían hacerlo en el resto dependiendo de la versión de Nagios que haya instalado. Si ninguno de los métodos mencionados funciona, aún puede usar tres opciones (-b, -B and -c) para especificar el directorio base de nagios, el nombre del binario y el lugar del fichero de configuración principal. Si el nombre del programa ocmienza con una ”/” entonces este valor se toma como una ruta absoluta no modificable a posteriori. Si no comienza con ”/” entonces la ubicación es relativa, componiéndose del directorio base, la cadena “bin” y el binario. Usando -U se puede especificar la ubicación del fichero de configuración de recursos.

Si no se han especificado opciones, se muestra la página de ayuda, de tal forma que tenga información para especificar el modo u objeto.

Usando la opción -m (–mode) se especifica uno de los modos de PNP para comprobar esos valores. La opción -l <filename> (–logfile=<filename>) permite comprobar la configuración necesaria durante la instalación de PNP. Tiene que ejecutar ./configure (con las opciones adicionales necesarias) antes de que se cree el ficheroconfig.log. Este nombre se debe pasar como parámetro. El script comprueba si los requerimientos de software son correctos y si algunos valores de configuración han sido especificados correctamente. Esto incluye una invoación al binario de RRDtool por lo que se debería usar la opción -r <location> (–rrdtool <location>) si el binario no se encuentra en /usr/bin/rrdtool.

El script comprueba si el propietario y el grupo de los directorios y ficheros que están por debajo del directorio de perfdata corresponden a los valores presentes en nagios.cfg. Además, los ficheros xml se comprueban para los valores de retorno (que no sean 0) de RRDtool. Usando la opción -R (–RRDpath) se especifica el directorio donde los ficheros de RRD están ubicados, si tienen una localización no estándar. Si no desea que estas comprobaciones se realicen, especifique “no” como nombre de directorio. Usando las opciones -u (–user) y -g (–group) se puede especificar el usuario/grupo del directorio de perfdata si éstos no coinciden con los valores del usuario de nagios.

Después de la instalación, los cambios en nagios.cfg se pueden comprobar usando la opción -p (–precheck) antes de reiniciar nagios. De esta forma, puede corregir cualquier error sin necesidad de reiniciar cada vez.

Junto con la opción-o <object> (–object=<object>) se puede especificar una cadena que se compare con los nombres de equipos y/o las descripciones de los servicios en el fichero de caché de objetos. La cadena debería estar entrecomillada para escapar los espacios en blanco y otros caracteres especiales. Si la cadena coincide con el nombre y cualquier dato de rendimiento, se mostrará. Si no se mostrarán los pertinentes mensajes de información.

Añadiendo un punto y coma a la cadena, obtendremos que sólo se compararan los nombres de los equipos, si el punto y coma se pone al principio de la cadena, sólo se inspeccionan las descripciones de los servicios. Un punto y coma dentro de la cadena, separa el nombre del equipo y la descripción del servicio.

• nombre de equipo/descripción de servicio ⇒ la cadena compara nombre de equipo o descripción de servicio
• nombre de equipo; ⇒ la cadena compara nombre(s) de equipo(s)
• ;service description ⇒ la cadena compara descripción(es) de servicio(s)
• hostname;service description ⇒ nombre de equipo y descripción de servicio son comparados

Cuando use el modo NPCD puede utilizar -N <config file> (–npcdcfg=<config file>) para especificar la ubicación del fichero de configuración si su nombre o ubicación difiere de los valores por defecto (/usr/local/pnp4nagios/etc/npcd.cfg).

Usando la opción -P <config file> (–ppcfg=<config file>) puede especificar el nombre del fichero de configuración para process_perfdata.pl si su nombre o ubicación difiere de los valores por defecto (/usr/local/pnp4nagios/etc/process_perfdata.cfg).

Usando la opción -M (–monitor) le permite especificar el producto que entrega los datos a PNP. El defecto es “nagios” pero “icinga” está soportado también. Adicionalmente puede querer usar las opciones -b, -B y -c.

Algunas veces, los cambios en las plantillas generan un error que es difícil de encontrar mediante la GUI web. Usando la opción -T las plantillas se comprueban en busca de errores. Especifique la ruta al directorio de plantillas como parámetro.

Usando -n (–native) se puede especificar “es” o “de” para ver los mensajes en español o alemán, respectivamente.

La opción -e (–english) fuerza el uso de los mensajes en inglés si el script detecta valores de otros lenguajes para los que tenga traducción.

La opción -d (–debug) mostrará líneas adicionales de información que podrían ser útiles en el proceso de localizar probemas, donde -q (–quiet) elimina todos los mensajes. Los errores se mostrarán con un valor de retorno distinto de cero.

Cada línea de información comienza con una letra que identifica el tipo de información mostrada:

[I] mensaje de información sobre los valores de configuración, cosas a ser realizadas, …
[A] acciones que deben ser realizadas
[W] mensaje de aviso
[E] mensaje de error: PNP no funcionará si no se resuelve el(los) problema(s)
[H] sugerencia: valdría la pena leer la documentación apropiada
[D] mensaje de depuración, esperamos que se muestre el origen de su problema

volver a contenidos | frontal web