Como monitorear Asterisk utilizando NRPE de Nagios

Transcripción

1 Como monitorear Asterisk utilizando NRPE de Nagios Instalando el agente NRPE Si tenemos instalado Asterisk sobre Centos, primero se debe instalar el agente de NRPE, bajando el archivo linux-nrpe-agent.tar.gz. Y ejecutando lo siguiente en la línea de comando: tar -xzvf linux-nrpe-agent.tar.gz cd linux-nrpe-agent./fullinstall Al nal de la instalación solicita la dirección IP del servidor nagios. Escribimos la dirección ip de nuestro servidor nagios y presionamos enter, de esta forma nalizamos la instalación. Observación: El servidor debe contar con acceso a internet debido que el agente descarga paquetes faltantes mediante yum. Si se encuentran detrás de un proxy deben editar el archivo /etc/yum.conf

2 Incluyendo los siguientes datos: proxy= proxy_username=usuario proxy_password=password Agregando el servidor Linux al Monitoreo de Nagios XI Iniciamos sesión en Nagios XI, seleccionamos la opción Congure tendremos que apreciar una plantalla parecida a la siguiente:

3 Seleccionamos la opción Run the Monitoring Wizard y nos tiene que entregar una pantalla parecida a la siguiente: Seleccionamos la opción Linux Server, nos va aparece una ventana como que vemos a continuación, nos pide dirección ip del servidor a monitorear y la distribución de Linux que tiene instalado (este wizard permite CentOS y RHEL)

4 Presionamos next y llegamos a una pantalla similar a la siguiente que en su parte de arriba nos pide el nombre, con que Nagios lo identicará. Luego en la parte de abajo están los parámetros a monitorear pudiendo deseleccionar los que no necesites y ajustar los parámetros que necesites, como por ejemplo agregar el servicio Asterisk o algún otros servicio para monitorear. Una vez terminado presionas next.

5 El siguiente paso nos muestra la frecuencia del monitoreo del servicio. Por defecto es cada 5 minutos y si detecta algún problema hace el chequeo cada un minuto, al quinto intento genera una alerta. Estos valores si se desea se pueden ajustar, pero en este caso sólo presionaremos next. El paso quinto nos muestra quien recibirá las noticaciones de alerta, se pueden modicar dependiendo las circunstancias. Y el paso 6 se puede indicar a que Host Groups, Service Groups y Parent Host pertenece el equipo a monitorear.

6 Finalizamos presionando el botón apply. Si el agente fue correctamente instalado, el resultado debería ser algo parecido a esto.

7 Monitoreando Asterisk con los scripts que NRPE trae por defecto. La aplicación NRPE se instala en los equipo que se desean monitorear, y acepta las conexión desde el servidor Nagios, NRPE es un agente de monitoreo, que se vale de un grupo de scripts, estos deben ejecutables desde la consola de Linux y funcionar con entrada y salida estándar. Los scripts se ubican en la ruta /usr/local/nagios/libexec/, en esta carpeta existe muchos scripts para monitorear distintas cosas, para monitorear servicios yum, dhcp, mysql, ntp, ssh y por su supuesto el servicio asterisk. Para asterisk el sistema viene con cuatro scripts, interesantes aunque no muy utiles y estos son: check_asterisk.pl Este es un script que monitorea el estado del servicio asterisk por medio de conexiones IAX2 y AMI, personalmente no le he encontrado mucha utilidad, pero está disponible para quien lo desea utilizar. check_asterisk_sip_peers.sh Este es un script que como lo dice su nombre, revisa el sip show peers de la consola de Asterisk, si encuentra el peer y además tiene un estado OK, devuelve un estado OK, sino devuelve un estado CRITICAL. Si deseas probarlo basta con ejecutar./check_asterisk_sip_peers.sh XXXX (nombre o numero de peer). Ojo si utilizas un nombre que puede que hacer coincidir dos o más anexos (por ejemplo utilizar 203 que coincide con los anexo 2031 y 2032) el script devolverá un error. Este script es muy útil para monitorear anexos y troncales SIP. Este script es escrito en bash y nos servirá como modelo para crear nuestros propios scripts. check_sip Este script monitoreas el protocolo SIP de los servidores Asterisk (también puede ser de otros sistemas que utilicen este protocolo). Se puede hacer consultas a un servidor tanto local como remoto. Es interesante, aunque no lo considero muy útil para más información sobre su uso ejecutar en la carpeta de los scripts./check_sip --help nagisk.pl Este script es un poco antiguo y muchas de sus funciones están obsoletas, podemos saber la cantidad de anexos logueados con anexos sip, y tiene otras funciones que ya están obsoletas, como monitoreo sobre el antiguo zaptel. El script está ahí para quien lo desee ocupar para no es muy útil.

8 Para habilitar el uso de estos scripts debemos seguir dos pasos: Primero ir al archivo ubicado en /usr/local/nagios/etc/nrpe/asterisk.cfg en este archivo están los nombres de los scripts utilizados para monitorear el servicio asterisk, los nombres tienen la siguiente sintaxis: command[nombre_pluggin_remoto]=/ruta_archivo/nombre_script $ARG1$ primero va la palabra command luego entre corchetes el nombre del pluggin de NRPE que nagios consultará remotamente, después un signo de igualdad, después la ruta hacia el script que este caso es /usr/local/nagios/libexec/ y al nal de este el nombre del script que va a responder las consultas remotas, para nalizar el o los argumentos que se utilizarán para denir nuestra consulta, estos parámetros están representados por $ARG1$, podemos poner más de uno de la forma $ARG1$ $ARG2$ $ARG3$ etc pero con uno basta independiente la cantidad de argumentos utilizados, ejemplo de esto es: command[check_asterisk]=/usr/local/nagios/libexec/check_asterisk.pl $ARG1$ Como este archivo viene listo ya para los scripts por defecto, no lo modicaremos todavía, pero tengamos presente que existe y que el nombre que consultaremos remotamente en nuestro servidor nagios es el que aparece entre corchetes en este archivo. Segundo debemos modicar los permisos de sudo, entrando a visudo, modicamos estos permisos, en este caso como es por defecto sólo descomentamos la última línea, eliminando el símbolo gato (#) del comienzo de la línea, esta debería se la siguiente línea : #nagios ALL=NOPASSWD: /usr/local/nagios/libexec/check_asterisk_sip_peers.sh, /usr/local/nagios/libexec/nagisk.pl, /usr/sbin/asterisk Monitoreando un anexo SIP Ahora utilizando el script check_asterisk_sip_peers.sh monitoreamos una extensión sip (por extensión me puede referir a un anexo como a una troncal), primero vamos a probar nuestro monitoreo de forma local: Primero nos dirigimos a la carpeta donde se encuentra el script cd /usr/local/nagios/libexec Luego ejecutamos el script incluyendo como parámetro el numero de un peer (si el peer posee un nombre también podemos incluirlo en lugar del número)../check_asterisk_sip_peers.sh 6400

9 Debido a que esta extensión estaba conectada nos arroja el siguiente mensaje, donde el segundo valor lo gracará Nagios XI. OK: 6400/ D N OK (103 ms) time=103ms Ahora probamos con otro anexo, este sabemos que esta conectado, para ver que mensaje arroja../check_asterisk_sip_peers.sh 6401 Debido a que no encontró con estado OK este anexo, arroja un estado CRITICAL. CRITICAL: Something is wrong with 6401 Esta misma prueba se puede hacer remota, ingresando al servidor de Nagios, a la carpeta /usr/local/nagios/libexec, y ejecutando por medio del script check_nrpe, junto al cual incluimos después el host, el pluggin y el parámetro, como se ve en el ejemplo siguiente../check_nrpe -H c check_asterisk_sip_peers -a 6400 OK: 6400/ D N OK (103 ms) time=103ms Ahora agregamos este monitoreo a un peer sip al monitoreo de Nagios XI, ingresando a Run monitoring wizard que se encuentra en la pestaña congure, aquí seleccionamos la opción NRPE.

10 En el segundo paso hacemos lo mismo en el ejemplo anterior, anotamos la dirección ip y el sistema operativo de la maquina que en este ejemplo es Centos. Luego presionamos next. Al igual que el ejemplo anterior, la ventana siguiente en su parte de arriba nos pide el nombre que deseamos darle al servidor, y como este el mismo del ejemplo anterior, le damos el mismo nombre a la maquina. En la parte de debajo de la pantalla, aparecen pestañas con los nombres de otros monitoreos, borramos todo y colocamos lo que deseamos monitorear, que en este caso es el anexo sip Como podemos ver en la siguiente imagen.

11 Los pasos siguientes son los mismos del ejemplo anterior, no necesitaremos revisarlos en estos momentos. Finalmente presionamos el botón apply y revisamos, si todo fue hecho de la forma correcta, deberíamos poder tener algo parecido a esto. Poco a poco, el valor de registro de la extensión sip, que cuando ejecutábamos el script aparecía detrás del símbolo pipa ( ) va generando un gráco, el que se puede consulta cuando se revisa el servicio en Nagios XI.

12 Creando scripts para monitorear asterisk Asterisk puede ser monitoreado de distintas formas, puede monitorearse el log utilizando el servicio syslog y volcándolo a un servidor de Syslog, puede monitorearse por SNMP por medio del módulo que tiene para ello, utilizando un sistema de monitoreo SNMP como SNMPc de CastleRock o SolarWinds, incluso el mismo nagios; puede monitorearse por medio de AMI de nagios, utilizando alguna aplicación que interprete la información contenida en él, puede monitorearse por medio de muchas maneras Pero sin embargo la que más me gusta a mi por la mucha información y por lo simple que es, consultar los comandos de la consola asterisk, que uno suele ver con asterisk -r o rasterisk, si uno puede escribir directamente sobre la consola asterisk rx comando y optener los datos que necesita. De esta forma podemos crear fácilmente scripts que utilizará la aplicación NRPE, como vimos existen algunos scripts ya creados para Asterisk como check_asterisk_sip_peers.sh, que utilizamos en el ejemplo anterior. Utilizamos este como modelo para crear un script que nos permita monitorear un peer IAX2. Monitoreando un peer IAX2 Este script es muy sencillo y basta unos sencillos pasos para dejarlo operativo: Vamos a la carpeta de los scripts cd /usr/local/nagios/libexec Copiamos el script cp check_asterisk_sip_peers.sh en la misma carpeta pero con el nombre check_asterisk_iax2_peer.sh cp check_asterisk_sip_peers.sh check_asterisk_iax2_peers.sh Luego editamos el archivo check_asterisk_iax2_peers.sh, en mi caso utilizaré vim, pero ustedes puede utilizar el editor que deseen. vim check_asterisk_iax2_peers.sh En el caso de utilice vim utilice el comando :%s/sip/iax2/g

13 agregamos la línea: command[check_asterisk_iax2_peers]=sudo usr/local/nagios/libexec/check_asterisk_iax2_peers.sh $ARG1$ en el archivo /usr/local/nagios/etc/nrpe/asterisk.cfg y en agregamos en los privilegios sudo, ingresando a visudo, la siguiente línea: nagios ALL=NOPASSWD: /usr/local/nagios/libexec/check_asterisk_iax2_peers.sh

14 Siguiendo el ejemplo anterior agregamos el peer IAX2 al monitoreo. Si no existen problemas, el resultado debiera ser posítivo.

15 Otros scripts con bash Llamadas simultaneas Este sencillo script permite conocer la cantidad de llamadas simultáneas. Se basa en el principio anterior obteniendo del comando de asterisk core show channels el número de llamadas simultáneas. Se pueden denir umbrales y se puede monitorear sin ellos para sólo obtener el número de llamadas simultaneas. #!bash llamadas=`/usr/sbin/asterisk -rx "core show channels" grep active\ call cut -d" " -f1` if [ $# == 0 ]; then exit 0 echo "OK:$llamadas llamadas simultaneas llamadas=$llamadas" if [ "$1" == "-h" -o "$1" == "--help" ]; then echo "Ayuda" echo "La sintaxis correcta es:" echo "$0 [XX] [YY]" echo "XX es el valor de umbral de alerta warning" echo "YY es el valor de umbral de alerta critical" exit 3 elif [ -z "$llamadas" ]; then echo "ERROR:Existe un error, puede que la ruta de asterisk se incorrecta o la version no sea compatible" exit 3 if [ -n "$2" ];then

16 if [ "$1" -gt "$2" ];then echo "ERROR:Error de Sintaxis, umbral WARNING debe menor o igual al umbral CRITICAL" echo "$0 $1 $2" exit 2 if [ "$llamadas" -ge $1 -a "$llamadas" -lt $2 ];then echo "WARNING:$llamadas llamadas simultaneas llamadas=$llamadas" exit 2 if [ "$llamadas" -ge "$2" ];then echo "CRITICAL:$llamadas llamadas simultaneas llamadas=$llamadas" exit 2 elif [ "$llamadas" -ge "$1" ];then echo "WARNING:$llamadas llamadas simultaneas llamadas=$llamadas" exit 2 if [ "$llamadas" -lt "$1" ];then echo "OK:$llamadas simultaneas llamadas=$llamadas" exit 0

17 Llamadas en la Cola Parecido al ejemplo anterior pero este consulta al comando de asterisk queue show #!bash llamadas=`/usr/sbin/asterisk -rx "queue show $1" grep ringall cut -d" " -f3` if [ $# == 0 -o "$1" == "-h" -o $# -gt 3 -o -z "$2" ]; then echo "ERROR:Sintaxis incorrecta" echo "La sintaxis correcta es:" echo "$0 ZZZZ XX [YY]" echo "ZZZ es el nombre de la cola" echo "XX es el valor de umbral de alerta warning" echo "YY es el valor de umbral de alerta critical" exit 3 elif [ -z "$llamadas" ]; then echo "ERROR:No se encuentra la cola buscada" exit 3 if [ -n "$3" ];then if [ "$2" -gt "$3" ];then echo "ERROR:Error de Sintaxis, umbral WARNING debe menor o igual al umbral CRITICAL" echo "$0 $1 $2 $3" exit 2 if [ "$llamadas" -ge $2 -a "$llamadas" -lt $3 ];then

18 echo "WARNING:$llamadas llamadas en cola cola=$llamadas" exit 2 if [ "$llamadas" -ge "$3" ];then echo "CRITICAL:$llamadas llamadas en cola cola=$llamadas" exit 2 elif [ "$llamadas" -ge "$2" ];then echo "WARNING:$llamadas llamadas en cola cola=$llamadas" exit 2 if [ "$llamadas" -lt "$2" ];then echo "OK:$llamadas llamadas en cola cola=$llamadas" exit 0

19 Conexión de CDR a base de datos MySQL. Este ejemplo es muy sencillo se consulta al comando de asterisk cdr mysql status #!/bin/bash LINE=`/usr/sbin/asterisk -r -x "cdr mysql status" grep "Connected to"` ERROR=`/usr/sbin/asterisk -r -x "cdr mysql status"` if [ "$LINE" ]; then echo -n "OK: " echo -n $LINE exit 0 elif [ -z "$LINE" ]; then echo "CRITICAL: $ERROR"; exit 2 else echo $LINE exit 2

20 Conclusión Los ejemplos que les mostré sólo son ilustrativos de las potencialidades de NRPE, si maneja otros lenguajes como python, perl, etc Pueden hacer mucho más.