Integración de Grafana en Domoticz
Daniel Montesinos del grupo «Domoticz a lo spain» de telegram nos explica cómo ha integrado Grafana en Domoticz para aprovechar sus gráficos incluso desde el móvil.
Mencionar que para poder seguir este tutorial debemos tener previamente instalado Grafana en nuestro sistema. Si no lo tienes instalado, deberás seguir los pasos de este otro tutorial para la parte que te interese (si solo necesitas Grafana – Influxdb, etc): «Instalación desde cero de domoticz, mqtt, influxdb, grafana y node red«.
Dividimos esta guía en varias partes
Software necesario
WinSCP
En primer lugar necesitaremos descargar e instalar WinSCP para entrar en los directorios de nuestra raspberry desde el ordenador.
Para descargarlo e instalarlo clica aquí.
Putty
El programa puTTY lo utilizaremos para conectar con nuestra raspberry por consola. Lo podéis descargar de aquí https://www.putty.org/
Lo más seguro es que vuestro PC, si es moderno, sea de 64 bits. En caso de duda bajar la versión de 32, o bien probar y si la de 64 bits no os funciona ya os bajáis la de 32 bits.
Notepad++
El programa Notepad++ lo utilizaremos para editar archivos de texto. Lo podéis descargar de aquí https://notepad-plus-plus.org/downloads
Configuración en domoticz
Domoticz nos permite crear menús y páginas customizadas donde poner lo que queramos. En el menú Custom (https://www.domoticz.com/wiki/Custom_menu), podremos poner todas las páginas que queramos y las podremos programar en html.
Para habilitar el tab Custom, tendremos que ir al tab Setup>Setting y habilitar el tab Custom:
Configuración en Winscp
Las páginas web (archivos html) estarán en la carpeta /home/pi/domoticz/www/templates, que podremos acceder a ella mediante el programa WinSCP, como ya se ha visto en otros domotutos. Todos los archivos html que tengamos en esta carpeta serán interpretados por domoticz como un nuevo menú.
En el caso de la imagen, dos archivos html, Grafana.html y plugins-manager.html, crean dos paginas en el tab Custom. E incluso, se puede añadir archivos de estilo css y javascript (por ejempo, el archivo plugins-manager.js).
El archivo custom.example es un ejemplo de lo que se puede hacer. Solo con renombrarlo a custom.html, nos aparecerá una nueva página llamada custom.
De esta forma podemos generar infinidad de menús y pantallas. Podeis encontrar más información en la wiki de domoticz: https://www.domoticz.com/wiki/Customization.
Con este procedimiento podemos incrustar paneles de Grafana en una pagina Custom. Para ello tendremos que crear un nuevo archivo html (os dejamos este de ejemplo, Grafana.html) y configurarlo para incrustar los paneles.
Antes, pero, tenemos que configurar Grafana para que nos permita incrustar paneles en otras paginas web y le tendremos que permitir un acceso anónimo.
Para ello, buscaremos el archivo grafana.ini en donde tengamos instalado Grafana. Lo podemos buscar con WinSCP con la opción buscar archivos.
Configuración en puTTY
Tendremos que modificar algunas líneas de la configuración de Grafana. Para ello, abriremos una conexión ssh con Putty en donde tengamos instalado Grafana y editaremos el archivo mediante el comando
sudo nano /etc/grafana/grafana.ini
Se nos abrirá el editor de texto nano.
Buscaremos la línea que pone
;allow_embedding = false
Y quitaremos el ; (punto y coma) y pondremos = true, de forma que habilitaremos los frames incrustados.
Ahora buscaremos la sección [auth.anonymous] y habilitaremos el acceso anónimo. Hay que comprender los riesgos que esto supone de acceso a nuestro Grafana. Esta opción es opcional. Si no lo habilitamos, no pedirá el user y password de grafana. Si usas https en domoticz ten en cuenta que tendrás también que usar https en grafana.
Y finalmente, modificaremos también la línea:
Finalmente guardaremos los cambios presionando CTRL+X, le damos a Y, presionamos intro para confirmar el nombre del archivo y listos.
Para que los cambios en la configuración de Grafana tengan efecto, hay que parar el servidor de Grafana introduciendo en puTTY lo siguiente:
sudo /bin/systemctl stop grafana-server
Y volver a arrancar:
sudo /bin/systemctl start grafana-server
Con esto ya tenemos listo Grafana para poder incrustar los paneles en otros archivos html.
Configuración en Grafana
Para obtener los links para incrustarlos en el archivo html, debemos primero ir al panel, en este caso de la tensión de red, y seleccionar Share.
Nos aparecerá un menú como este en el que en la pestaña Embed, nos va a aparecer el código para incrustar en un archivo html. Hay que desactivar la option Current time rango para que vaya actualizando los datos de forma automática. Le damos a copy to clipboard y ya lo tendremos copiado en el porta papeles.
Notepad++
Este código lo tendremos que incrustar en el archivo html que os hemos dejado de ejemplo. Este archivo lo podemos editar desde nuestro ordenador con cualquier editor de texto, Notepad o Notepad++, por ejemplo. En este ejemplo hemos incrustado cuatro paneles iguales que en la página Custom aparecerán en formato 2×2.
Continuamos en WinSCP
Una vez modificado el archivo Grafana.html, lo debemos guardar en la carpeta /home/pi/domoticz/www/templates con WinSCP, refrescar el navegador y ya veremos en Domoticz los cuatro paneles.
Información importante
Para los que no uséis Grafana ni Domoticz en https, tendréis que permitir que el navegador os muestre contenido no seguro.
Para cualquier duda o consulta tienes disponible el grupo de telegram «Domoticz a lo Spain» para entrar, ponerte cómodo y participar cuanto quieras.
Cualquier duda, sugerencia o comentario será bien recibida en la web!
