Skip to main content.

Archive for Diciembre, 2008

Monitorización de Asterisk con Munin

Jueves, Diciembre 11th, 2008

Todos los que nos dedicamos a esto de Asterisk hacemos nuestros pinitos con mon, nagios, snmp y similares para atender nuestras centralitas y saber cuándo algo va mal. Este tipo de monitorización, depende del soporte que se haya vendido, no le importa al cliente ya que a él sólo le importa que la centralita funcione. Pero hay algunas estadísticas que sí que le pueden interesar al cliente, como saber cuántas llamadas concurrentes suele tener, si las licencias de su ASR están en uso por picos o de forma constante, si el balanceo de sus primarios está correctamente hecho o si por el contrario estamos saturando alguno… etc. Me refiero a estadísticas de uso de los recursos de Asterisk.

Esto no es nada nuevo. Hay multitud de programas y desarrollos a medida que nos permiten monitorizar estos casos y que nos generan gráficos y estadísticas en flash, con animaciones y todo. En este post vamos a hablar de Munin como sistema de monitorización de la centralita.

Para los que no lo conozcan, Munin es un sistema que nos genera gráficos de cualquier cosa que podamos imaginar: Uso de la CPU, colas del MTA, queries de Mysql, uso de la swap, uso de la RAM… todo a base de unos sencillos plugins.

Para usar munin no tenemos más que instalar los paquetes correspondientes:

apt-get install munin munin-node apache2

Una vez hecho esto esperaramos hasta 5 minutos para que munin genere las primeras imágenes y al acceder a la URL http://localhost/munin ¡SORPRESA! Tenemos un fea y anticuada web maquetada con tablas en la que a medida que pase el tiempo veremos cómo van dibujándose gráficos referentes a los recursos y servicios que tengamos instalados.

Por defecto munin trae bastantes plugins de monitorización de servicios. Los plugins en el caso de Debian se guardan en /usr/share/munin/plugins y se activan mediante enlaces simbólicos en /etc/munin/plugins/ y configuran en /etc/munin/plugin-conf.d/munin-node. Claro que hasta ahora no ha hecho falta tocar nada de todo esto porque funciona de serie.

Ya tenemos un sistema que genera gráficas de los servicios típicos que tenemos en un servidor GNU/Linux. Ahora sólo falta la parte de monitorizar asterisk usando los plugins que no vienen de serie con el programa.
Zap channels

En la web de munin podemos encontrar plugins generados por los usuarios. A partir de un plugin genérico que se conecta al manager de asterisk, mete un comando y parsea la respuesta podemos sacar casi todas las estadísticas que nos interesen: Canales zap, misdn, sip, iax, llamadas simultáneas, licencias G729 en uso…

Veamos un ejemplo de un plugin de munin que vía Manager saca las llamadas concurrentes en el asterisk:

  1. #!/usr/bin/perl -w                                                                                                                                                                  
  2. use strict;
  3. my $ret = undef;
  4. if (! eval "require Net::Telnet;")
  5. {                                
  6.     $ret = "Net::Telnet not found";
  7. }                                  
  8. if ($ARGV[0] and $ARGV[0] eq "config")
  9. {
  10.     print "graph_title Asterisk active CALLS\n";
  11.     print "graph_args –base 1000 -l 0\n";
  12.     print "graph_vlabel calls\n";
  13.     print "graph_category asterisk\n";
  14.     print "channels.draw AREA\n";
  15.     print "channels.label channels\n";
  16.     exit 0;
  17. }
  18.  
  19. my $host = exists $ENV{‘host’} ? $ENV{‘host’} : "127.0.0.1";
  20. my $port = exists $ENV{‘port’} ? $ENV{‘port’} : "5038";
  21.  
  22. my $username = "administrador";
  23. my $secret   = "secretillo";
  24.  
  25. my $pop = new Net::Telnet (Telnetmode => 0);
  26. $pop->open(Host => $host,
  27.            Port => $port);
  28.  
  29. ## Read connection message.
  30. my $line = $pop->getline;
  31. die $line unless $line =~ /^Asterisk/;
  32.  
  33. ## Send user name.
  34. $pop->print("Action: login");
  35. $pop->print("Username: $username");
  36. $pop->print("Secret: $secret");
  37. $pop->print("Events: off");
  38. $pop->print("");
  39.  
  40. ## Request status of messages.
  41. $pop->print("Action: command");
  42. $pop->print("Command: core show channels");
  43. $pop->print("");
  44. my $result;
  45. while (($line = $pop->getline) and ($line !~ /END COMMAND/o))
  46. {
  47.     print $line;
  48.     $result = $line if $line =~ /active call/;
  49. }
  50.  
  51. my $nb = (split ‘ ‘,$result)[0];
  52. $pop->print("Action: logoff");
  53. $pop->print("");
  54.  
  55. print "channels.value $nb\n";

Como puede verse leyendo un poco el código, la base del script es siempre el mismo, datos, establecimiento de la conexión… etc. Con sólo cambiar unas pocas líneas podemos ir sacando y monitorizando toda la información que deseemos. Las líneas clave serían:
$pop->print("Command: core show channels"); Donde metemos el comando que queremos.
$result = $line if $line =~ /active call/; Es la línea que tiene el resultado que queremos. Si ejecutamos a mano un asterisk -rx "core show channels" podemos ver que la respuesta es del estilo
root@pbx:/etc/asterisk/dialplan# asterisk -rx "core show channels"
Channel Location State Application(Data)
SIP/sarenet-09130f90 946571015@default:1 Ringing AppDial((Outgoing Line))
SIP/2627-b32fade0 s-VOIP@macro-salient Ring Dial(SIP/sarenet/946571015|80|
SIP/2100-08f814c0 2100@desde-usuarios: Ringing AppDial((Outgoing Line))
SIP/2652-b2cdd190 s@macro-llamadainter Ring Dial(SIP/2100|45|Tt)
SIP/sarenet-08b4d478 (None) Up Bridged Call(SIP/2404-b2ff03f0
SIP/2404-b2ff03f0 s-VOIP@macro-salient Up Dial(SIP/sarenet/943446826|80|
mISDN/1-u981 s@ivr-operadorbuzon: Up BackGround(locuciones/EUS_IVR_
SIP/sarenet-082f7388 (None) Up Bridged Call(SIP/2612-089c0d50
SIP/2612-089c0d50 s-VOIP@macro-salient Up Dial(SIP/sarenet/944806571|80|
9 active channels
5 active calls Está claro que en el caso de querer monitorizar las llamadas concurrentes a lo largo del tiempo lo que nos interesa es la línea última que es la que tiene el número de llamadas concurrentes en ese momento. Una vez tenemos la línea en la que está la información lo único que hace falta es sacar el dato de esa línea y sacar el resultado en el formato que a munin le interesa:
my $nb = (split ‘ ‘,$result)[0];
print "channels.value $nb\n";
De hecho, si ejecutamos el script a mano desde la consola lo que veremos será la salida que se le pasará a munin cuando éste ejecute dicho script de forma periódica:
root@pbx:~# /usr/share/munin/plugins/asteriskcalls
Response: Success
Message: Authentication accepted
Response: Follows
Privilege: Command
Channel Location State Application(Data)
mISDN/1-u994 s@macro-getcallerid: Ringing AGI(getcallerid.php|943085756)
SIP/sarenet-08e41cd0 (None) Up Bridged Call(SIP/2626-b318d338
SIP/2626-b318d338 s-VOIP@macro-salient Up Dial(SIP/sarenet/630642987|80|
SIP/sarenet-08b4d478 (None) Up Bridged Call(SIP/2404-b2ff03f0
SIP/2404-b2ff03f0 s-VOIP@macro-salient Up Dial(SIP/sarenet/943446826|80|
SIP/sarenet-082f7388 (None) Up Bridged Call(SIP/2612-089c0d50
SIP/2612-089c0d50 s-VOIP@macro-salient Up Dial(SIP/sarenet/944806571|80|
7 active channels
4 active calls
channels.value 4
Si nos fijamos en el principio del script podemos ver que “channels.value” es el valor que le interesa a munin para hacer la gráfica ya que hemos puesto “channels” en la vertical.

Este script hace las cosas bien, con manager y todo. Pero no tenemos por qué limitarnos a eso. Al final munin sólo quiere un valor para un campo vertical que irá pintando a lo largo del tiempo. Podemos hacer cosas menos bonitas y más imaginativas. Ejemplo de uso de un primario que pertenece a un grupo de varios:

  1. #!/bin/sh
  2.  
  3. LISTAZAP=$(asterisk -rx ‘core show channels’ | cut -d ‘ ‘ -f 1 | grep -a ‘Zap/’ | cut -d ‘/’ -f 2 | cut -d ‘-’ -f 1)
  4.  
  5. ZAP1=0
  6. ZAP2=0
  7. ZAP3=0
  8. if [ $# = 1 ]; then
  9.         if [ $1 == "config" ]; then
  10.             echo "graph_title Asterisk PRI 3";
  11.             echo "graph_args –base 1000 -l 0";
  12.             echo "graph_vlabel channels";
  13.             echo "graph_category asterisk";
  14.             echo "channels.draw AREA";
  15.             echo "channels.label channels";
  16.             exit 0
  17.         fi
  18. fi
  19.  
  20. for actual in $LISTAZAP;do
  21.         if [ $actual -lt 32 ]; then
  22.                 ZAP1=$(expr $ZAP1 + 1)
  23.         else    if [ $actual -lt 63 ]; then
  24.                         ZAP2=$(expr $ZAP2 + 1)
  25.                 else    if [ $actual -lt 94 ]; then
  26.                         ZAP3=$(expr $ZAP3 + 1)
  27.                         fi
  28.                 fi
  29.         fi
  30. done
  31.  
  32. echo "channels.value $ZAP3"
  33.  

Muchas veces este sencillo programa, que hace gráficas feas, pero que es muy sencillo de instalar y de configurar puede salvarte la vida ya que puedes ver que los últimos días ha habido errores en eth0, que las querys de mysql han aumentado demasiado, que las interrupciones están por las nubes… y te permite diagnosticar momentos de congestión o fallos pasados que no son posibles reproducir en el presente.

Posted in Asterisk, General | 2 Comments »

2005 © Irontec S.L. :: Powered by Irontec & Wordpress
[ IRONTEC S.L. - C.I.F. B-95274890 ]
[ Ctra. Basurto-Kastrexana nº70 / Enpresaldea ]
[ 48002 - Bilbao - Bizkaia ]