Català  

Diferencia entre revisiones de «Servidor de gráficas»

De Guifi.net - Wiki Hispano

(Página creada con ''''Crear servidor de gráficas de guifi.net''' = Introducción = Nirinini… (entrando con la música de bricomanía)… Hoy vamos a montar un servidor de gráficas para grafi...')
 
 
(No se muestran 42 ediciones intermedias realizadas por 8 usuarios)
Línea 1: Línea 1:
'''Crear servidor de gráficas de guifi.net'''
+
El servidor de gráficas se basa en el servicio de Guifi.net llamado [[SNPServices]].
  
= Introducción =
+
El servidor SNPServices, y para ser mas exactos cliente SNPServices es un servidor linux, con php, apache, mrtg y rrdtool, no
Nirinini… (entrando con la música de bricomanía)…
+
necesita nada mas.
  
Hoy vamos a montar un servidor de gráficas para graficar nuestros nodos y supernodos. El motivo de este servidor es graficar los supernodos que están dentro de la red de xsf (cooperativa xarxa sense fils).
+
== Definición ==
 +
Le llamamos cliente porque el servidor Master SNPServices es un servidor que nos enviará información a nuestro servidor cliente SNPServices.
  
= Metodología =
+
A continuación se muestra un esquema de esta definición:
Lo primero de todo será escojer un servidor víctima, en este caso fermat, que ya es un servidor que se dedica a ofrecer otros servicios a guifi, como la wiki.
+
  
 +
[[Archivo:SNPServices.png|center]]
  
Entramos por ssh a la máquina y añadimos los repositorios de apt de guifi en el fichero /etc/apt/sources.list.
+
=== Definición para expertos ===
  
<pre># vi /etc/apt/sources.list
+
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.
#repo guifi
+
deb http://repo.vic.guifi.net/debian/  ./</pre>
+
  
actualizamos el repositorio:
+
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.
  
<pre># apt-get update</pre>
+
== Funcionamiento paso a paso ==
  
e instalamos el paquete snpservices
+
'''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'''.
  
<pre># apt-get install snpservices</pre>
+
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'''.
  
snpservices con un conjunto de herramientas que permitirán capturar las gráficas de los nodos y supernodos que estén configurados a este servidor. Esta máquina tendrá que tener así salida a guifi.net y a internet, ya que hasta el momento el servidor de guifi.net es sólo accesible desde internet.
+
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'''.
Para leer las gráficas, el servidor de guifi.net preguntará a nuestro servidor, vía web las gráficas de los nodos que están configurados con este servidor.
+
  
El servidor va guardando la información que le mandan los nodos mediante unos scripts que vemos en /etc/cron.d/snpservices
+
'''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.
  
<pre>fermat:~# cat /etc/cron.d/snpservices
+
'''Pasos 3 y 4''' Antes de continuar con el trabajo que hace el servidor SNPServices client, el Master SNPServices debe hacer un trabajo.
*/30 *  * * *  root    if [ -x /var/www/snpservices/graphs ]; then cd /var/www/snpservices/graphs ; fi; if [ -x /usr/bin/php ] && [ -r /var/www/snpservices/graphs/mrtgcsv2mrtgcfg.php ]; then env LANG=C /usr/bin/php mrtgcsv2mrtgcfg.php >> /var/log/snpservices/mrtgccfg.log 2>&1;fi
+
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''.
*/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</pre>
+
  
Ahora ya sólo faltará añadir a la web de guifi nuestro servidor de gráficas.
+
Esta es la cabecera del archivo ''guifi.cnml'':
 +
<pre>
 +
<?xml version="1.0"?>
 +
<cnml version="0.1" server_id="1" server_url="http://guifi.net" generated="20121105 1247">
 +
</pre>
  
Si no tenemos ningún servidor en nuestro nodo, lo añadimos en la página del nodo:
+
El archivo que abre exactamente es: http:// $SNPDataServer_url /guifi/cnml/ $rootZone /detail
  
Servidor computador.
+
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.
Si tenemos un supernodo asignamos la ip en editar la radio del supernodo > editar > sección de conexiones por cable > 1 interfaz > wLan/Lan > ip/red > enchufe > Enlaza un trasto (Fermat) > create.
+
  
Con el servidor creado y con la ip si es posible, vamos al menú de arriba, crea contenidos y Guifi.net service.
+
'''Pasos 5 y 6'''. Volvemos al servidor cliente SNPServices que estamos montando.
  
Rellenamos la información:
+
El servidor SNPServices tiene una dirección donde buscar el archivo cnml creado por el Master SNPServices:
'''Nombre del servicio:''' Servidor de Gràfiques de Marsupi – BCNRossello208
+
$MRTGConfigSource = '$SNPDataServer_url . "/graphs/cnml2mrtgcsv.php?server" . =' . $SNPGraphServerId;
'''Nombre corto:''' BCNRossello208GRAF
+
'''Trasto:''' 23843-BCN, BCNrossello208 Fermat (este nombre lo generamos escribiendo el nombre de nuestro nodo, en mi caso BCNrossello208, y la ruedecilla de la derecha empezará a girar y saldrá en un menú desplegable los servidores disponibles en este nodo)
+
'''Servicio:''' SNP Graph server
+
'''Estado:''' Operativo
+
SNPgraphs configuración >
+
'''Versión:''' 2.0
+
'''url:''' http://graf1.marsupi.org (esta será la url por la que el servidor de guifi.net llegará a los datos de nuestro snmp, normalmente bajo /var/www/snpservices).
+
  
Guardamos y ahora en el nodo en la pestaña servicios vemos el servicio añadido.
+
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.
  
En este punto podemos acceder al servicio snpservices via web en la siguiente url:
+
Esta es la cabecera del archivo ''mrtg.cfg'':
 +
<pre>
 +
# 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
 +
</pre>
  
<pre>http://ipdelservidor/snpservices</pre>
+
Para ver esta lista en formato CSV desde web la podemos pedir así:
  
ahí nos saldran todo de letritas con algo de información del servicio y tal.
+
$SNPDataServer_url/snpservices/graphs/cnml2mrtgcsv.php?server=$SNPGraphServerId
  
Como nos gusta complicar las cosas (o dejarlas un poco ordenadas), vamos a crear un subdominio en nuestro dominio llamado graf1, voy al DNS y apunto el subdominio a la ip de internet de esta máquina y configuro el virtualhost en la máquina apuntando al directorio snpservices que es un link simbólico (atención añadir la opción FollowSymLinks). '''Este paso es opcional'''.
+
Ejemplo:
 +
http://192.168.1.44/snpservices/graphs/cnml2mrtgcsv.php?server=6833
  
<pre><VirtualHost *:80>
+
De paso, veremos si hasta ahora funciona todo.
ServerAdmin marsupi@marsupi.org
+
ServerAlias graf1.marsupi.org *.graf1.marsupi.org
+
ServerName graf1.marsupi.org
+
  
DocumentRoot /var/www/snpservices
+
El log del sistema que guarda los movimientos de este proceso están en ''/var/log/snpservices/mrtgccfg.log''.
  
#habilitar en cas de debugging
+
Al instalar el servicio SNPServices, se nos añade un cron.
#ErrorLog /var/log/apache2/graf1.marsupi.org_error.log
+
Este cron (script que se ejecuta automáticamente según el tiempo definido) está en ''/etc/cron.d/snpservices''.
#LogLevel warn
+
#CustomLog /var/log/apache2/graf1.marsupi.org_access.log combined
+
  
<Directory />
+
<pre>
Options FollowSymLinks
+
*/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
AllowOverride None
+
*/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
</Directory>
+
/usr/share/snpservices/graphs/mrtgcsv2mrtgcfg.php
<Directory /var/www/snpservices>
+
</pre>
Options FollowSymLinks
+
AllowOverride None
+
Order allow,deny
+
Allow from all
+
</Directory>
+
</VirtualHost></pre>
+
  
Por ultimo tendremos que comprobar que el snpservices de este servidor esté identificado por el numero que nos da la web de guifi. Si vamos al servicio es el numero que tenemos en la URL.
+
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''.
  
<pre># vi /etc/snpservices/config.php
+
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:
$SNPGraphServerId = 35207;</pre>
+
/usr/bin/mrtg /var/lib/snpservices/data/mrtg.cfg
  
A partir de ahora cuando configuremos nuestros nodos podremos usar este servidor de gráficas.
+
'''Paso 7'''. El servicio mrtg consulta los datos con ping y los envía a rrdtool que fabrica la gráfica.
  
El snpservices de nuestra máquina está configurado para consultarle a la web de guifi qué nodos tiene que guardar las gráficas. Los scripts se ejecutan cada 5 minutos para recolectar los datos y cada media hora para saber qué nodos graficar.
+
El log de los movimientos del servicio mrtg están en ''/var/log/snpservices/mrtgc.log''
  
= Agradecimientos =
+
Los datos para hacer la gráfica se almacenan en ''/var/lib/snpservices/rrdb''.
Thnks Zunbado y Locke.
+
 
 +
'''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 ==
 +
* [[Instalar servidor de gráficas en OpenWRT]]
 +
* [[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
 +
* [[Servidor de gráficas en una red mesh con QMP y Airmax]]
 +
 
 +
== 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 ==
 +
* [http://www.guifi.net/proxy-debian manual debian de guifi.net]
 +
* [http://asociacionjuvenilelcueto.info/node/156 manual de la associació Juvenil el Cueto (Rioja)]
 +
 
 +
== Enlaces externos ==
 +
* [http://www3.uji.es/~vrubert/guifi_linux/graph.html Tutorial servicio SNPServices]
  
[[Categoria:Servidor]]
 
 
[[ca:Servidor de gràfiques]]
 
[[ca:Servidor de gràfiques]]

Última revisión de 01:31 14 feb 2014

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