Podemos crear un plugin en Perl para aprovechar la potencia de la herramienta de monitorización Nagios.

Transcripción

1 Creamos nuestros propios plugins para Nagios EL VIGILANTE Podemos crear un plugin en Perl para aprovechar la potencia de la herramienta de monitorización Nagios. POR MICHAEL SCHILLI Puede que le sea familiar la siguiente escena: escuchamos la voz de nuestro compañero (definitivamente tecnófobo) en el despacho contiguo gritando Mi Internet no funciona! Una posible respuesta puede ser comprobar laboriosamente si el router está realmente hablando con nuestro proveedor o si podemos acceder al servidor de DNS. Pero la localización y resolución de problemas es mucho más fácil si disponemos de un software que monitoriza las funciones críticas y nos muestra un amigable resumen basado en Web como el mostrado en la Figura 1. La herramienta en software libre Nagios es perfecta para este tipo de monitorización. Los desarrolladores disponen de una gran lista de plugins en [2]. Los plugins pueden ayudarnos a monitorizar páginas Web, bases de datos, redes y muchas otras cosas. Si tenemos alguna necesidad especial no cubierta por los plugins estándar, podemos confeccionar uno que se adapte a nuestras necesidades. Sólo por dar un ejemplo, Nagios puede llevar a cabo tests para verificar si un proveedor de hosting nos está dando un servidor con suficientes recursos, en lugar de sobrecargar el servidor albergando demasiadas páginas Web en él. Si, por razones de seguridad, la instalación de Nagios en la máquina local no tiene acceso directo a la shell del lado servidor, podemos instalar un agente en la página Web. Estadísticas E/S Si situamos el script de agente iostat.cgi (Listado 1) en el directorio CGI del servidor Web que queremos investigar, nos será de gran ayuda. El script se activa con una petición HTTP, llama al comando iostat de Linux, y envía algunos resultados al cliente, que resulta ser un plugin de Nagios. El plugin interpreta entonces los resultados y usa el código de salida para indicarle a Nagios si los valores son correctos o si ha encontrado problemas (véase Tabla 1). El script CGI, iostat.cgi, usa la función tap del módulo Sysadm::Install de CPAN para llamar al comando iostat con los valores 1 y 2 (línea 8). Debido al valor del intervalo de 1, y al valor de contador de 2, mide el rendimiento de la CPU y de la E/S del disco duro dos veces por segundo y genera el resultado de la Figura 3. El primer test nos da el valor medio desde el último reinicio, mientras que el segundo es más interesante para Nagios, ya que agrega el rendimiento por segundo mientras se está ejecutando. La columna %idle nos indica el tiempo que ha estado disponible la CPU, y iowait mide cuánto ha tenido que esperar la CPU al disco duro. Desde el punto de vista del consumidor lo más deseable es un valor alto de %idle y un valor bajo de %iowait. El script iostat.cgi del Listado 1 lee la salida de iostat y descarta el primer conjunto de valores medidos. Para ello, usa la expresión regular $RE{num}{real} del repositorio Regexp::Common para analizar los valores numéricos. A continuación Tabla 1: Valores de salida Valor de Texto Significado salida 0 OK Todo correcto 1 WARNING Problema en servicio 2 CRITICAL Problema en servicio crítico 3 UNKNOWN Problema con el plugin 54 Número 20

2 Perl DESARROLLO Figura 1: Esta página resumen de Nagios nos muestra que los tests locales han sido completados con éxito, pero que el router y todo lo que está más allá, están inaccesibles. de la cabecera HTTP obligatoria, devuelve una cadena tal que user 2.99 nice 0.00 sys 0.00 iowait 0.00 idle La llamada declaración de anchura cero, \G (línea 20), evita que el motor de expresiones regulares vuelva atrás al comienzo del texto en cada ocasión y le indica que continúe la búsqueda tras la última coincidencia. Carga Límite En la parte de Nagios, el plugin del Listado 2 hace uso de LWP::Simple para llamar al script CGI que acabamos de ver en el servidor, captura la línea de salida y ejecuta split para dividir la salida en campos para guardarlos en el hash %values. Si la disponibilidad de la CPU es menor del 50%, el plugin reporta un estado crítico. Para valores menores al 80% sólo muestra un aviso. Se aplica el mismo principio al valor iowait, pero los valores umbral son del 10 y 20 por ciento en este caso. El módulo Nagios::Clientstatus de CPAN descarga algo de trabajo del plugin al verificar si éste ha pasado todos los parámetros requeridos. El método exitvalue también entiende cadenas como warning, más que el valor numérico 1 del mundo de Nagios. Si ejecutamos el plugin en línea de comandos tecleando: check_iostat -url=u el plugin devuelve las siguientes líneas de salida: IOSTAT OK - user 2.99 U nice 0.00 sys 0.00 iowait 0.00 idle Más tarde Nagios llamará al plugin de esta manera, interpretará los valores de salida y mostrará el texto resultante del plugin en stdout. Nótese que Nagios::Clientstatus requiere la versión 2.35 o superior de Getopt::Long. Integrar el Plugin Para añadir el nuevo plugin a la instalación de Nagios, el administrador debe copiar el script check_iostat al directorio /usr/local/nagios/libexec y darle permisos de ejecución. En la Figura 4 se añade una plantilla denominada ez-service a la configuración de Nagios. Esto hace más sencillo añadir más servicios posteriormente. En las configuraciones de Nagios es una práctica común definir plantillas, que se identifican con facilidad por sus entradas register 0. Las definiciones de los servicios pueden usarse más tarde para añadir entradas especiales a las plantillas. La configuración define service de la Figura 4 define el nuevo servicio Iostat. Se construye en base a la plantillas use ez-service, que definimos anteriormente, y acepta varios parámetros para ejecutar tests, notificaciones por y muchas otras cosas. Estas configuraciones de plantilla se heredan luego por la definición de servicio y pueden ser anuladas en caso necesario. Algunas configuraciones y sus significados: la entrada notification_interval 0 evita que Nagios envíe múltiples s para reportar un único problema. Los administradores pueden fijar normal_check_interval para especificar el intervalo entre tests de servicio, en minutos, y max_check_attempts para especificar qué número de tests permitimos que fallen antes de que nos lo notifique Nagios. service_notification_options especifica qué cambios en el estado de Nagios se nos deben notificar con un mensaje. La opción w se refiere a un aviso, u para desconocido, c de crítico y r de recuperación. Un principio similar se aplica a host_notification_options: además de unknown y recovery, nos permite la opción d para caído. El Servidor Solitario Si el servidor Nagios está aislado del resto del mundo debido a un fallo en la red, obviamente no vamos a recibir ningún a través de Internet. En este caso, el administrador recibe al menos un de recuperación tan pronto como se haya arreglado el problema. Nagios soporta también administradores de eventos para definir acciones que llevar a cabo al detectar un error. El sistema puede solucionar problemas de manera autónoma sin la intervención de un administrador. Con Nagios 2.0, un servicio siempre se mapea a un host al que se le comprueba la disponibilidad independientemente. Las especificaciones del host requieren entradas en el archivo de configuración. La línea host_name dreamhost en la configuración del ejemplo define el nombre del host, al que nos vamos a referir más tarde en la página de visualización de Nagios. Número 20 55

3 específicos. En el clásico estilo de plugins de Nagios, acepta parámetros en línea de comandos para los valores umbral. Si realizamos la llamada: check_temperature -warn=30 U -crit=35 -dsname=inside Listado 2: check_iostat Figura 2: Nagios nos muestra un gráfico para indicarnos con qué frecuencia ha sido imposible acceder a un sistema. El parámetro de definición de servicio check_command especifica cómo realizar la llamada al plugin check_iostat. Sin embargo, la llamada no se realiza directamente en la definición del servicio. En su lugar, usa un comando configurado anteriormente por define command para especificar la línea de 01 #!/usr/bin/perl -w 02 use strict; 03 use Sysadm::Install qw(:all); use CGI qw(:all); 06 use Regexp::Common; 07 use Sysadm::Install qw(:all); my($stdout, $stderr, $rc) = 10 tap iostat, 1, 2; $stdout =~ 13 /avg-cpu.*?avg-cpu/gs; 14 print header(); for my $key (qw(user nice sys 17 iowait idle)) { 18 if($stdout =~ 19 /\G.*?($RE{num}{real})/gs) { 20 printf %s %s, $key, $1; 21 } 22 } Listado 1: iostat.cgi comandos a ejecutar. La línea check_command puede tomar argumentos opcionales, que pasa a continuación a la definición del comando. Separada por un signo de exclamación, la URL de la línea check_command se pasa a la definición del comando iostat y reemplaza al parámetro de sustitución $ARG1$. El valor 24x7 de check_period y notification_period requiere configuraciones para definir la dirección de del administrador y la disponibilidad. Podemos encontrar un archivo de ejemplo llamado eznagios.cfg en [1], y añadir una línea tal que: cfg_file=u /usr/local/nagios/etc/eznagios.cfg al archivo de configuración nagios.cfg. Al mismo tiempo, eznagios.cfg define los tests de Nagios que nos indican cuanto espacio en disco está ocupado y si el router y servidor de DNS de nuestro proveedor están funcionando. Calentito, calentito check_temperature es otro ejemplo claro de plugin de cosecha propia para Nagios. El script (véase el Listado 3) contacta una base de datos round-robin en busca de la medida de temperatura indicada en [3], y nos alerta si la medida más reciente de la temperatura externa o interna excede unos umbrales 01 #!/usr/bin/perl 02 ############################## 03 use strict; 04 use LWP::Simple; 05 use Log::Log4perl qw(:easy); 06 use Nagios::Clientstatus; my $version = 0.01 ; 09 my $ncli = Nagios::Clientstatus->new( 10 help_subref => 11 sub{ print usage: $0 url\n }, 12 version => $version, 13 mandatory_args => [ url ], 14 ); my $url = $ncli->get_given_arg( url ); my $data = get $url; unless($data) { 21 print Failed to get $url\n ; 22 exit $ncli->exitvalue( unknown ); 23 } my %values = split, $data; my $status = 28 $values{idle} < 50? critical : 29 $values{idle} < 70? warning : 30 $values{iowait} > 20? critical : 31 $values{iowait} > 10? warning : 32 ok ; print IOSTAT, uc($status), - $data\n ; exit $ncli->exitvalue($status); 56 Número 20

4 Perl DESARROLLO Figura 3: iostat muestra el tiempo que ha estado la CPU sin utilizar y cuánto ha estado esperando al disco duro. se dispara un aviso si la temperatura interna sube por encima de los 30º centígrados. El umbral crítico es 35º. La Figura 5 muestra varios Listado 3: check_temperature valores resultado y la salida del plugin para distintas configuraciones de los parámetros. De un modo similar al plugin Iostat que hemos visto anteriormente, la entrada del servicio check_command check_temperature!25!30!inside pasa los parámetros 25, 30 e Inside al script. La entrada command correspondiente es algo como: define command { command_name check_temper ature command_line U $USER1$/check_temperature U -warn=$arg1$ -crit=$arg2$ U -dsname=$arg3$ } La sección central de la colorida tabla de la Figura 1 muestra que ambas temperaturas son bastante normales: 18.8º C (internos) y 15.9º C (externos). Al menos mi apartamento no está en llamas. 01 #!/usr/bin/perl -w 02 ############################## 03 use strict; 04 use RRDTool::OO; 05 use Getopt::Std; 06 use Pod::Usage; 07 use Nagios::Clientstatus; my $N = TEMPERATURE ; my $nc = Nagios::Clientstatus->new( 12 help_subref => sub { pod2usage() }, 13 mandatory_args => [qw( 14 crit warn dsname 15 )], 16 ); my $rrd = RRDTool::OO->new( 19 file => /tmp/temperature.rrd ); my $dsnames = $rrd->meta_data( dsnames ); $rrd->fetch_start( 24 start => time() - 6*60, 25 end => time() 26 ); my $temp; = 31 $rrd->fetch_next()) { 32 for(my $i=0; $i<@$dsnames; $i++) { 33 if($dsnames->[$i] eq 34 $nc->get_given_arg( dsname )) { 35 $temp = $values[$i]; 36 last; 37 } 38 } 39 } my $status = ok ; if(! defined $temp) { 44 $status = unknown ; 45 } 46 elsif($temp >= 47 $nc->get_given_arg( crit )) { 48 $status = critical ; 49 } 50 elsif($temp >= 51 $nc->get_given_arg( warn )) { 52 $status = warning ; 53 } printf $N %s - %s: %s\n, 56 uc($status), 57 $nc->get_given_arg( dsname ), 58 defined $temp? 59 sprintf( %.1f, $temp) : 60 NODATA ; exit $nc->exitvalue($status); Figura 4: Configuración de Nagios para el nuevo plugin Iostat. Creamos un usuario y grupo para Nagios: adduser nagios cd nagios-2.0./configure make all Instalamos los ejecutables, los scripts CGI y las páginas HTML. Creamos el script de arranque en /etc/rc.d/init.d, y generamos por último una configuración de ejemplo: make install Instalar Nagios make install-init make install-config Número 20 57

5 Figura 5: Resultados y valores del plugin de la temperatura con diferentes parámetros en línea de comandos. Instalación El tarball de la distribución 2.0 de Nagios está disponible en la página Web del proyecto [4]. Tras desempaquetarla, podemos seguir las instrucciones del cuadro Instalar Nagios para conseguir un servidor Nagios operativo. Otro tarball [2] contiene los plugins estándar para Nagios 2.0. Tenemos que desempaquetar el tarball en /usr/local/nagios/libexec. El principal obstáculo para echar a andar Nagios es la configuración. Tras instalar la herramienta, el administrador debe crear al menos seis(!) archivos de configuración diferentes. 01 # cgi.cfg: 02 default_user_name=guest 03 Listado 4: Guest Access 04 authorized_for_system_information=nagiosadmin,guest Afortunadamente, la distribución nos ofrece una colección de archivos de ejemplo que podemos editar. Para ello, simplemente renombramos los archivos.cfg-sample bajo /usr/local/nagios/etc a.cfg. La instalación de Nagios no debería ser accesible públicamente a través de Internet. Puede que queramos usar los ajustes de la Figura 6 al configurar el servidor Web de nuestro Nagios. Tras ejecutar el demonio de Nagios tecleando /etc/rc.d/init.d/nagios restart (como root), y enviar una señal HUP al servidor Web, los usuarios autenticados pueden acceder a los datos medidos y las series de reportes en (véase Figura 1). Si la página de Nagios está ubicada tras un firewall, y estamos seguros de que sólo puede accederse por usuarios autorizados, podemos ignorar la autenticación y comentar las líneas Require valid-user. En el archivo de configuración de 05 authorized_for_configuration_information=nagiosadmin, 06 authorized_for_all_services=nagiosadmin,guest 07 authorized_for_all_hosts=nagiosadmin,guest 08 authorized_for_all_service_commands=nagiosadmin,guest 09 authorized_for_all_host_commands=nagiosadmin,guest Figura 6: Configuración del servidor Web para Nagios. Nagios, cgi.cfg, las entradas del Listado 4 permitirían a un usuario no autenticado acceder a toda la información y comandos de servicio. Dormir a Pierna Suelta Tras realizar todos estos cambios en los archivos de configuración, podría ser una buena idea verificar si la configuración está libre de errores antes de intentar reiniciar el demonio. Para verificar la sintaxis: cd /usr/local/nagios bin/nagios -v etc/nagios.cfg Una buena estrategia de monitorización, llevada a cabo de manera fiable por Nagios, garantiza al administrador el poder dormir a pierna suelta, a menos que salten las alarmas, claro. Siempre será preferible despertarse por un aviso de Nagios a nuestro busca que saltar de la cama por un usuario malhumorado que nos llama en mitad de la noche. RECURSOS [1] Listados de este artículo: linux-magazine.es/magazine/ Downloads/20 [2] Plugins estándar para Nagios-2.0: nagiosplug/nagios-plugins tar. gz [3] Michael Schilli, Está que arde?, Número 18 de Linux Magazine edición en castellano, pag. 46 [4] Nagios: 58 Número 20