En Busca del Dashboard perfecto: InfluxDB, Telegraf y Grafana – Parte XXXIV (Monitorizando Runecast)

Saludos amigos, hoy os traigo una nueva entrada sobre Grafana, la de hoy espero que os guste, es algo específica, ya que se trata sobre importar los tan importantes números desde Runecast.

Es una versión 1.0, tengo algunas ídeas en mente sobre este Dashboard, pero no he tenido suficiente tiempo, creo que está suficientemente bien por ahora, decirme qué pensáis.

Dashboard para Runecast

Cuando terminemos la entrada tendremos algo similar a ese Dashboard que te permitirá visualizar:

Dashboard – Resumen

Este primer dashboard de la serie, porque tengo intención de crear quizá alguno más con otros detalles, etc., contiene:

Runecast Appliance Overview – IP o FQDN del Clúster, Versión, y versión de las definiciones.
Runecast Issues por Severidad – Número de incidencias por Severidad.
Runecast Issues por Issue ID – Un listado con todas las incidencias, incluyendo el Issue ID.
Runecast Issues por cada objeto – Un listado con todas las incidencias, incluyendo el Issue ID.

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 Runecast 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 Runecast usando la API RESTful, que enviará todos los datos a InfluxDB, desde donde podremos verlos cómodamente con Grafana.

Pequeños requisitos del sistema antes de continuar

Necesitaremos dos pequeños requisitos del sistema antes de continuar, el primero será JQ, que es un paquete que nos ayuda a parsear el JSON, vamos a instalarlo, yum install si CentOS:

apt-get install jq

Otro pequeño requisito del sistema es obtener el Token de acceso a la API de Runecast, para ello, vamos a nuestra consola de Runecast, en Configuración – Tokens de acceso a la API, hacemos clic en Generar Token de acceso a la API:

Seleccionemos que sea de sólo lectura y que no caduque nunca:

Descargar, y configurar el script the runecast_grafana.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:

https://raw.githubusercontent.com/jorgedlcruz/runecast-grafana/main/runecast_grafana.sh

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" #Your InfluxDB Server, http://FQDN or https://FQDN if using SSL
InfluxDBPort="8086" #Default Port
InfluxDB="telegraf" #Default Database
InfluxDBUser="INFLUXUSER" #User for Database
InfluxDBPassword='INFLUXPASS' #Password for Database

# Endpoint URL for login action
runecastToken="RUNECASTOTKEN" #Your read-only Runecast token. You can quickly create one from the portal
runecastServer="RUNECASTFQDNORIP"

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

chmod +x runecast_grafana.sh

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

Writing runecast_results_analysis to InfluxDB
HTTP/1.1 204 No Content
Content-Type: application/json
Request-Id: 6cc3cc65-9b71-11eb-8794-0050569017a8
X-Influxdb-Build: OSS
X-Influxdb-Version: 1.8.4
X-Request-Id: 6cc3cc65-9b71-11eb-8794-0050569017a8
Date: Mon, 12 Apr 2021 09:28:22 GMT

Writing runecast_results_analysis to InfluxDB
HTTP/1.1 204 No Content
Content-Type: application/json
Request-Id: 6ce92985-9b71-11eb-8795-0050569017a8
X-Influxdb-Build: OSS
X-Influxdb-Version: 1.8.4
X-Request-Id: 6ce92985-9b71-11eb-8795-0050569017a8
Date: Mon, 12 Apr 2021 09:28:22 GMT

Si es así, por favor, ahora agrega este script a tu crontab, como por ejemplo cada6 horas, no creo que nuestros Dashboards se actualicen más amenudo, pero bueno bajarlo si así es:

0 */6 * * * /home/oper/runecast_grafana.sh >> /var/log/runecast.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 Runecast, severidad, etc:

https://grafana.com/grafana/dashboards/14213

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: 14213, que es el ID único del Dashboard, o la URL:

https://grafana.com/grafana/dashboards/14213

Con los menús de arriba, podremos movernos entre KB, Severidad, etc.:

Por favor, dejar vuestros comentarios aquí, o en GitHub. ¡Muchas gracias por la lectura!

Nada más amigos, espero que os guste, y me gustaría dejaros la serie completa aquí:

M	T	W	T	F	S	S
			1	2	3	4
5	6	7	8	9	10	11
12	13	14	15	16	17	18
19	20	21	22	23	24	25
26	27	28	29	30