El Blog de Jorge de la Cruz

El Blog de Jorge de la Cruz - Todas las novedades sobre VMware, Veeam, InfluxData, Grafana, Zimbra, etc.

En Busca del Dashboard perfecto: InfluxDB, Telegraf y Grafana – Parte XXXI (Monitorizando Unifi Protect)

- Escrito en: opensource

Saludos amigos, hoy os traigo una nueva entrada sobre Grafana y Unifi, que estoy seguro que os gustará y que espero pongáis en vuestra colección. Si, ya se que hay una versión que se llama Unifi Poller, que hace más o menos lo que explico aquí, pero la complejidad de añadirlo a mi entorno ya funcionando, y que por ahora no necesito tanto me ha hecho crear esta versión más ligera, solamente para Unifi Protect (recordar, el tema de las cámaras)

Hoy, me complace traeros un completo y acabado Dashboard para monitorizar Unifi Protect, sin límite de Cámaras, Cloud Key Gen2, o UDM Pro, o NVR.

Dashboard para Unifi Protect

Cuando terminemos la entrada tendremos algo similar a ese Dashboard que te permitirá visualizar, haz clic en cada enlace para verlo en vivo:

Dashboard – Resumen

  • Resumen – Nombre del dispositivo de grabación de Protect, con su versión, IP, etc.
  • CPU-RAM-Temperatura – Encontramos la CPU, RAM, y Temperatura en cómodos cuadrados para ver lo más reciente.
  • Histórico CPU-RAM-Temperatura – Encontramos la CPU, RAM, y Temperatura en cómodas gráficas para ver los datos en unas gráficas sobre tiempo.
  • Cámaras IP – Una tabla muy completa donde se nos muestra todas nuestras cámaras, el estado de las mismas, información sobre firmware, etc.

Topología con todos los componentes lógicos

Esta entrada es similar a las anteriores ya que en este caso, usaremos una combinación de un shell script para recolectar las métricas de Unifi Protect usando RESTful API e InfluxDB. El diseño sería algo similar a esto:

Como podemos ver, el shell script descargará las métricas de Unifi Protect usando la API RESTful, que enviará todos los datos a InfluxDB, desde donde podremos verlos cómodamente con Grafana.

Descargar, y configurar el script the unifi-protect.sh

Tenemos casi todo listo, tenemos un último paso, el guión que hará que todo esto funcione, descargaremos la última versión del repositorio Github:

Este script de shell, puede ser descargado y ejecutado desde el servidor de telegraf, o influxDB, o cualquier otro Linux. Tendremos que editar los parámetros de configuración:

# Configurations
##
# Endpoint URL for InfluxDB
InfluxDBURL="http://YOURINFLUXSERVER" #Use https if required
InfluxDBPort="8086" #Default Port
InfluxDB="telegraf" #Default Database
InfluxDBUser="YOURTELEGRAFUSER" #User for Database
InfluxDBPassword="YOURTELEGRAFPASSWORD" #Password for Database

# Endpoint URL for login action
UnifiUsername="YOURUNIFIUSER"
UnifiPassword="YOURUNIFIPASS"
UnifiProtectServer="https://YOURUNIFIPROTECTIP"
CookiePath="/tmp/cookies.txt"

Una vez que los cambios estén hechos, haz el script ejecutable con chmod:

chmod +x unifi-protect.sh

Lo ejecutamos, y la salida del comando debe ser algo parecido a la siguiente, sin errores:

HTTP/1.1 204 No Content
Content-Type: application/json
Request-Id: 30147ef9-6744-11eb-b261-0050569017a8
X-Influxdb-Build: OSS
X-Influxdb-Version: 1.8.3
X-Request-Id: 30147ef9-6744-11eb-b261-0050569017a8
Date: Thu, 04 Feb 2021 23:53:32 GMT

Si es así, por favor, ahora agrega este script a tu crontab, como por ejemplo cada 30 minutos:

*/30 * * * * /home/oper/unifi-protect.sh >> /var/log/unifi.log 2>&1

Estamos listos para irnos al siguiente paso.

Grafana Dashboards

He creado un Dashboard desde cero seleccionando las mejores solicitudes a la base de datos, terminando los colores, pensando en los gráficos y en cómo mostrarlos, y todo está automatizado para que se ajuste a nuestro entorno sin ningún problema y sin tener que editar nada manualmente. El Dashboard se puede encontrar aquí, una vez importado, puedes usar los menús desplegables superiores para seleccionar entre dispositivos de Protect, etc:

Importar el Dashboard de Grafana de manera sencilla

Para que no tengas que perder horas configurando un nuevo Dashboard, e ingiriendo y depurando lo que quieras, ya he creado un maravilloso Dashboards con todo lo que necesitas para monitorizar nuestro entorno de una forma muy sencilla, se verá como la imagen que te mostré arriba. Selecciona el nombre que quieras e introduce el ID: 13835, que es el ID único del Dashboard, o la URL:

Con los menús de arriba, podremos movernos entre algunas opciones:Por favor, dejar vuestros comentarios aquí, o en GitHub. ¡Muchas gracias por la lectura!

Espero que os guste, y me gustaría dejaros la serie completa aquí, para que empecéis a jugar con los plugins que os he ido contando todos estos años:

Reader Interactions

Trackbacks

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.