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.
Contenido
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:
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.
Manuales
- SNPservices Instalacion SNPServices mediante GIT. Aqui hay explicacion interesante, pero GIT no esta actualizado. Mejor usar instalacion de snpservices como servicio de Debian con metodo at-get
- Servidor de gráficas 1 (Debian/Ubuntu) método apt + configuración virtualhost apache
- Servidor de gráficas 2 (Debian/Ubuntu) método dpkg
- Servidor de gráficas 3 (Debian/Ubuntu) extendido
- [http:www3.uji.es/~vrubert/guifi_linux/graph.html Tutorial servicio SNPServices]
PMF
- 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.
