En esta oportunidad quisiera compartir cómo agregar un gráfico de torta (o pie chart en inglés) en un dashboard de Grafana.

Grafana provee un plugin oficial para generar gráficos de torta llamado grafana-piechart-panel. Aunque por defecto éste no se encuentra instalado.

La forma más simple de instalarlo es a través de la herramienta de línea de comandos grafana-cli, provista por el paquete grafana:

root@devuan:/home/emi# grafana-cli 
NAME:
   Grafana cli

USAGE:
   grafana-cli [global options] command [command options] [arguments...]

VERSION:
   5.2.3

AUTHOR:
   Grafana Project <https://github.com/grafana/grafana>

COMMANDS:
     plugins  Manage plugins for grafana
     admin    Grafana admin commands
     help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --pluginsDir value  path to the grafana plugin directory (default: "/var/lib/grafana/plugins") [$GF_PLUGIN_DIR]
   --repo value        url to the plugin repository (default: "https://grafana.com/api/plugins") [$GF_PLUGIN_REPO]
   --pluginUrl value   Full url to the plugin zip file instead of downloading the plugin from grafana.com/api [$GF_PLUGIN_URL]
   --insecure          Skip TLS verification (insecure)
   --debug, -d         enable debug logging
   --help, -h          show help
   --version, -v       print the version

Para instalar el plugin "grafana-piechart-panel", simplemente ejecutar el siguiente comando en el servidor donde se ha instalado Grafana:

# grafana-cli plugins install grafana-piechart-panel

Ejemplo de instalación:

root@devuan:/home/emi# grafana-cli plugins install grafana-piechart-panel
installing grafana-piechart-panel @ 1.3.3
from url: https://grafana.com/api/plugins/grafana-piechart-panel/versions/1.3.3/download
into: /var/lib/grafana/plugins

✔ Installed grafana-piechart-panel successfully 

Restart grafana after installing plugins . <service grafana-server restart>

Una vez instalado, es necesario reiniciar el servidor Grafana:

root@devuan:/home/emi# service grafana-server restart
[ ok ] Stopping Grafana Server:.
[ ok ] Starting Grafana Server:.

Habiendo reiniciado el servidor Grafana, y luego de recargar la página, es posible agregar nuestro primer gráfico de torta seleccionando el panel de tipo "Pie Chart":

Editar el panel para configurar la consulta:

En este caso se trata de un conjunto de datos recuperados desde una base de datos PostgreSQL:

La consulta SQL recupera dos columnas que corresponden a espacio en disco utilizado y disponible:

SELECT
  $__time(fecha),
  pfree as "Disponible"
  100-pfree as "Utilizado"
FROM
  datastore_space
WHERE
  $__timeFilter(fecha)
  AND name='ds-production;

La cantidad de columnas recuperadas en la consulta corresponde con la cantidad de "porciones" de la torta.

En el caso de que se trate de valores porcentuales, es necesario seleccionar la unidad "percent (0-100)" en la pestaña de opciones:

Finalmente guardar los cambios (es importante no olvidar guardar los cambios cada vez que se agrega un nuevo panel):

Resultado:

Luego de agregar algunos gráficos de torta más, puedo visualizar en todo momento el uso de mis datastores desde una vista simple (incluyendo la evolución histórica para todos ellos):

Esa es la vista que logré con Grafana, versus la vista de mi solución vmware-datastores :

Al cabo que la había desarrollado sólo por gusto.

Referencias


Tal vez pueda interesarte


Compartí este artículo