Català  

Servidor de gráficas

De Guifi.net - Wiki Hispano

El servidor de gráficas se basa en el servicio de Guifi.net llamado SNPServices.

El servidor SNPServices, y para ser mas exactos cliente SNPServices es un servidor linux, con php, apache, mrtg y rrdtool, no necesita nada mas.

Definición

Le llamamos cliente porque el servidor Master SNPServices es un servidor que nos enviará información a nuestro servidor cliente SNPServices.

A continuación se muestra un esquema de esta definición:

SNPServices.png

Definición para expertos

El cliente SNPServices consulta al Master SNPServices la lista de nodos a monitorizar, recogida previamente del servidor web mediante CNML, se parsea la lista y formatea scripts mrtg y los ejecuta (pings y trafico) para generar un rrd. Con consultas http desde el servidor web, se ejecuta un php que convierte los .rrd en imágenes y las muestra.

El servidor web de Guifi.net conoce la url del servidor de gráficas de la zona de un nodo, o sea, los SNPServices clientes de cada zona. La web muestra sus datos locales y los datos remotos.

Funcionamiento paso a paso

Paso 1. Un nodo crea un servicio de servidor de gráficas en la web. Este servicio le concede un número único que lo identifica. A este valor le llamamos $SNPGraphServerId.

En este servidor de gráficas se instalará un servicio Apache, con php y el paquete SNPServices. La dirección web la llamaremos $SNPDataServer_url.

Este servicio puede ser además supernodo de una zona y por tanto tiene el código de la zona. A este valor el llamamos $rootZone.

Paso 2. Al crearse este nodo, se actualiza la BBDD de la web. Esta base de datos contiene toda la información de los nodos, servicios y demás datos de Guifi.net.

Pasos 3 y 4 Antes de continuar con el trabajo que hace el servidor SNPServices client, el Master SNPServices debe hacer un trabajo. El Master SNPServices consulta al servidor Web una lista de todos los nodos de una zona. Esta pregunta la hace con el script php que se llama refresh_cnml.php.. El servidor web le devuelve una lista de nodos en formato CNML que almacena en un archivo llamado /var/lib/snpservices/data/guifi.cnml.

Esta es la cabecera del archivo guifi.cnml:

<?xml version="1.0"?>
<cnml version="0.1" server_id="1" server_url="http://guifi.net" generated="20121105 1247">

El archivo que abre exactamente es: http:// $SNPDataServer_url /guifi/cnml/ $rootZone /detail

El servidor web devuelve un archivo y el servidor SNPServices lo guarda en /var/lib/snpservices/data/guifi.cnml. Este archivo se actualiza de tanto en tanto y es necesario hacerlo ya que los cambios en la web no se reflejarían en los servicios a monitorizar.

Pasos 5 y 6. Volvemos al servidor cliente SNPServices que estamos montando.

El servidor SNPServices tiene una dirección donde buscar el archivo cnml creado por el Master SNPServices:

$MRTGConfigSource = '$SNPDataServer_url . "/graphs/cnml2mrtgcsv.php?server" . =' . $SNPGraphServerId;

En esta dirección se descarga la lista de nodos a monitorizar y transforma el contenido en un archivo que contiene los nodos a monitorizar y en un lenguaje que puede entender el servicio mrtg.

Esta es la cabecera del archivo mrtg.cfg:

# PathAdd: /usr/local/rrdtool-1.2.12/bin
# LibAdd: /usr/local/rrdtool-1.2.12/lib/perl/5.8.8/i386-linux-thread-multi
HtmlDir: /var/lib/snpservices/rrimg/
ImageDir: /var/lib/snpservices/rrimg/ 
LogDir: /var/lib/snpservices/rrdb/
LogFormat: rrdtool
ThreshDir: /var/lib/snpservices/rrdb/
Forks: 12
Title[11833_ping]: Temps del ping de Futbol-Remei-VicRd1 

Para ver esta lista en formato CSV desde web la podemos pedir así:

$SNPDataServer_url/snpservices/graphs/cnml2mrtgcsv.php?server=$SNPGraphServerId

Ejemplo:

http://192.168.1.44/snpservices/graphs/cnml2mrtgcsv.php?server=6833

De paso, veremos si hasta ahora funciona todo.

El log del sistema que guarda los movimientos de este proceso están en /var/log/snpservices/mrtgccfg.log.

Al instalar el servicio SNPServices, se nos añade un cron. Este cron (script que se ejecuta automáticamente según el tiempo definido) está en /etc/cron.d/snpservices.

*/30 *  * * *   root    if [ -x /usr/bin/php ]; then env LANG=C /usr/bin/php /usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php >> /var/log/snpservices/mrtgccfg.log 2>&1; fi
*/5 *   * * *   root    if [ ! -x /var/lock/mrtg ]; then mkdir /var/lock/mrtg ; fi; if [ -x /usr/bin/mrtg ] && [ -r /var/lib/snpservices/data/mrtg.cfg ]; then env LANG=C /usr/bin/mrtg /var/lib/snpservices/data/mrtg.cfg --lock-file /var/lock/mrtg/guifi_l >> /var/log/snpservices/mrtg.log 2>&1; fi
/usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php 

Este quiere decir que mediante el script /usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php, consulte el archivo guifi.cnml antes descrito y transforme el contenido en un XML disponible para el servicio mrtg. Lo almacena en /var/lib/snpservices/data/mrtg.cfg.

Una vez que nuestro servidor SNPServices client tiene los datos de los nodos a monitorizar, es cuando se ejecuta el proceso de búsqueda de datos con el sistema mrtg. Lo hace con:

/usr/bin/mrtg /var/lib/snpservices/data/mrtg.cfg

Paso 7. El servicio mrtg consulta los datos con ping y los envía a rrdtool que fabrica la gráfica.

El log de los movimientos del servicio mrtg están en /var/log/snpservices/mrtgc.log

Los datos para hacer la gráfica se almacenan en /var/lib/snpservices/rrdb.

Paso 8. Los clientes que quieren información de los nodos, la buscan en el servidor web. Éste buscalos datos y los encuentra dentro de su MySQL, pero las gráficas las busca en el servidor de gráficas de aquel nodo, es decir, en el servidor $SNPGraphServerId.

Véase también

Preguntas más frecuentes

  • Regenerar los ficheros rrd
  • tener en cuenta que al connectar un dispositivo por cable ponerlo en Lan o en la ubicacion que sea, sino puede que no grafique correctamente.

Referencias

Enlaces externos

Herramientas personales