Plugins de paneles¶

Los plugins de paneles amplían las capacidades de visualización de Grafana.

Grafana incluye varios tipos de paneles integrados, como:

Stat.
Gauge.
Bar Gauge.
Time series.
Heatmap.
Table.
Text.
Canvas.

Además, puede utilizar plugins adicionales para ofrecer visualizaciones especializadas o funciones que no están disponibles en los paneles estándar.

Los plugins permiten adaptar Grafana a diferentes necesidades:

Monitorización de infraestructuras.
Observabilidad de aplicaciones.
Visualización de redes.
Representación de topologías.
Análisis de logs.
Paneles ejecutivos.
Mapas geográficos.
Diagramas personalizados.
Integración con otras plataformas.

Objetivos¶

Al finalizar esta sección, el alumno podrá:

Explicar qué es un plugin de Grafana.
Diferenciar un plugin de panel de una fuente de datos.
Consultar los plugins instalados.
Buscar plugins disponibles.
Instalar un plugin de panel.
Actualizar un plugin.
Deshabilitar un plugin.
Eliminar un plugin.
Reiniciar Grafana después de instalar un plugin.
Crear un panel utilizando un plugin.
Configurar las opciones básicas de un plugin.
Comprobar la compatibilidad de un plugin.
Identificar los riesgos de instalar plugins de terceros.
Revisar los permisos y la firma de un plugin.
Consultar los logs relacionados con plugins.
Diagnosticar un panel que no carga correctamente.
Exportar un dashboard que utiliza un plugin.
Documentar las dependencias de un dashboard.
Aplicar buenas prácticas de seguridad y mantenimiento.

Introducción¶

Un plugin es un componente que añade funcionalidades a Grafana.

De forma conceptual:

Grafana
   |
   +-- Paneles integrados
   |
   +-- Plugins de panel
   |
   +-- Plugins de fuentes de datos
   |
   +-- Plugins de aplicaciones
   |
   +-- Plugins de autenticación o integración

En esta sección se estudiarán principalmente los plugins de paneles.

Un plugin de panel puede proporcionar una visualización especializada que recibe datos desde una fuente de datos y los representa de una forma concreta.

El flujo general es:

Fuente de datos
       |
       v
Consulta
       |
       v
Resultado
       |
       v
Plugin de panel
       |
       v
Visualización

Ejemplo:

Prometheus
    |
    v
Consulta PromQL
    |
    v
Métricas de CPU
    |
    v
Plugin de panel
    |
    v
Visualización personalizada

Tipos de plugins de Grafana¶

Grafana puede utilizar diferentes categorías de plugins.

Plugins de panel¶

Añaden visualizaciones.

Ejemplos de funciones:

Diagramas.
Mapas.
Indicadores personalizados.
Gráficos especializados.
Visualizaciones de relaciones.
Paneles con HTML o SVG.
Representaciones geográficas.

Plugins de fuentes de datos¶

Permiten consultar sistemas externos.

Ejemplos:

Prometheus.
Loki.
InfluxDB.
Elasticsearch.
PostgreSQL.
MySQL.
Microsoft SQL Server.

Plugins de aplicación¶

Añaden funcionalidades más amplias, como:

Páginas personalizadas.
Integraciones.
Configuración adicional.
Vistas de aplicación.
Flujos de trabajo.

Plugins de autenticación¶

Permiten integrar Grafana con mecanismos externos de autenticación.

Ejemplos conceptuales:

Proveedores de identidad.
Directorios corporativos.
Sistemas de autenticación externos.

En esta unidad se trabajará principalmente con:

Plugins de panel

Plugins integrados y plugins externos¶

Plugins integrados¶

Son los paneles disponibles en la instalación estándar de Grafana.

Ejemplos:

Stat
Gauge
Bar Gauge
Time series
Table
Text
Canvas
Heatmap

Ventajas:

Suelen estar probados con la versión instalada.
No requieren instalaciones adicionales.
Tienen una integración directa con Grafana.
Reciben mantenimiento dentro del ciclo de Grafana.

Plugins externos¶

Son desarrollados y distribuidos fuera del conjunto principal de Grafana.

Pueden aportar:

Visualizaciones adicionales.
Integraciones específicas.
Funciones experimentales.
Representaciones especializadas.
Soporte para necesidades concretas.

Antes de utilizarlos se debe revisar:

Compatibilidad.
Mantenimiento.
Licencia.
Procedencia.
Firma.
Versión requerida.
Permisos.
Dependencias.
Documentación.
Historial de actualizaciones.

Cuándo utilizar un plugin de panel¶

Un plugin puede ser útil cuando:

Ningún panel integrado representa correctamente los datos.
Se necesita una visualización especializada.
Se requiere un diagrama personalizado.
Se desea utilizar un mapa.
Se necesita representar una topología.
Se requiere un tipo específico de gráfico.
El equipo ya utiliza un plugin aprobado.
La visualización aporta información operativa real.

Ejemplos¶

Mapa geográfico¶

Representar:

Disponibilidad de servicios por ubicación.

Diagrama de red¶

Representar:

Routers, switches, servidores y conexiones.

Visualización especializada¶

Representar:

Distribuciones, relaciones o indicadores personalizados.

Panel operativo¶

Representar:

Estado de un servicio mediante una vista diseñada para un equipo concreto.

Cuándo no utilizar un plugin¶

No conviene instalar un plugin cuando:

Un panel integrado ya resuelve el problema.
El plugin está abandonado.
No existe documentación.
No se conoce su procedencia.
Requiere permisos excesivos.
No es compatible con la versión de Grafana.
Añade complejidad sin aportar información.
El dashboard debe ser fácilmente portable.
Se necesita mantener una instalación mínima.

Regla práctica¶

Antes de instalar un plugin, comprobar si el resultado puede conseguirse con:

Un panel integrado.
Una consulta PromQL mejor diseñada.
Una transformación.
Un panel Canvas.
Un panel Text.
Variables de dashboard.
Un enlace a otro dashboard.

Instalar plugins no debe convertirse en el equivalente técnico de comprar otra taza para una cocina ya llena de tazas.

Buscar plugins¶

Desde la interfaz de Grafana se puede consultar el catálogo de plugins disponible para la instalación.

Procedimiento general:

Iniciar sesión en Grafana.
Acceder a la sección de administración.
Abrir la sección de plugins.
Buscar por nombre o categoría.
Revisar la descripción.
Revisar la versión.
Revisar el estado de firma.
Revisar la compatibilidad.
Revisar la documentación.
Confirmar si el plugin es adecuado.

La ubicación exacta de las opciones puede variar según:

La versión de Grafana.
El rol del usuario.
La edición instalada.
La configuración administrativa.
El método de instalación.

Información que se debe revisar¶

Antes de instalar un plugin, revisar:

Nombre¶

Confirmar que corresponde al plugin esperado.

Identificador¶

Los plugins tienen un identificador único.

Ejemplo conceptual:

fabric-panel-plugin

El identificador se utiliza a menudo en comandos y configuraciones.

Versión¶

Comprobar:

Versión instalada
Versión disponible
Versión mínima de Grafana

Firma¶

Determinar si el plugin está:

Firmado
No firmado
Firmado por un proveedor
Firmado por la comunidad

Compatibilidad¶

Comprobar:

Versión de Grafana.
Sistema operativo.
Arquitectura.
Navegador.
Fuente de datos.
Tipo de consultas.
Dependencias.

Mantenimiento¶

Revisar:

Fecha de la última actualización.
Frecuencia de versiones.
Problemas abiertos.
Documentación.
Actividad del proyecto.
Soporte disponible.

Permisos¶

Revisar qué permisos solicita el plugin.

Un plugin de panel no debería recibir permisos innecesarios.

Instalar un plugin desde la interfaz¶

El procedimiento general es:

Acceder a la administración de Grafana.
Abrir la sección de plugins.
Buscar el plugin.
Abrir su ficha.
Revisar la información.
Seleccionar la opción de instalación.
Confirmar la operación.
Reiniciar Grafana si es necesario.
Comprobar que el plugin aparece disponible.
Crear un panel de prueba.

La instalación puede requerir permisos administrativos.

Instalar un plugin desde la línea de comandos¶

Grafana proporciona una herramienta administrativa para gestionar plugins.

El comando habitual es:

grafana-cli plugins install ID_DEL_PLUGIN

En instalaciones recientes, la ruta y el nombre del comando pueden variar según el paquete y la distribución.

Ejemplo conceptual:

grafana-cli plugins install ejemplo-panel-plugin

Después de instalarlo, normalmente se reinicia Grafana:

sudo systemctl restart grafana-server

Comprobar el estado:

sudo systemctl status grafana-server

Comprobar los logs:

sudo journalctl -u grafana-server -n 100 --no-pager

Precauciones¶

Sustituir ID_DEL_PLUGIN por un identificador verificado.
No copiar comandos de fuentes desconocidas.
Revisar la versión de Grafana.
Crear una copia de seguridad antes de modificar producción.
Probar primero en laboratorio.

Directorios habituales de plugins¶

La ubicación depende del método de instalación y del sistema operativo.

Una ubicación habitual es:

/var/lib/grafana/plugins

Comprobar el contenido:

sudo ls -lah /var/lib/grafana/plugins

También puede ser necesario revisar la configuración de Grafana:

sudo grep -R "plugins" /etc/grafana/ 2>/dev/null

El directorio puede estar configurado mediante:

data
plugins
paths

No se debe asumir que todas las instalaciones utilizan la misma ruta.

Instalar un plugin manualmente¶

La instalación manual puede consistir en:

Descargar el paquete desde una fuente confiable.
Verificar su integridad.
Extraerlo en el directorio de plugins.
Revisar permisos.
Reiniciar Grafana.
Comprobar los logs.
Confirmar que el plugin aparece en la interfaz.

Ejemplo conceptual:

sudo mkdir -p /var/lib/grafana/plugins
sudo tar -xzf plugin.tar.gz \
  -C /var/lib/grafana/plugins

Ajustar propietario y permisos según la instalación:

sudo chown -R grafana:grafana \
  /var/lib/grafana/plugins

Reiniciar:

sudo systemctl restart grafana-server

Precaución¶

La instalación manual requiere más control y más comprobaciones que la instalación desde el catálogo.

No instalar archivos descargados de ubicaciones no verificadas.

Plugins no firmados¶

Grafana puede bloquear plugins no firmados por razones de seguridad.

En entornos de laboratorio puede habilitarse explícitamente un plugin concreto, según la configuración soportada por la versión instalada.

Una configuración conceptual puede tener este aspecto:

[plugins]
allow_loading_unsigned_plugins = ID_DEL_PLUGIN

Después de modificar la configuración:

sudo systemctl restart grafana-server

Advertencias¶

Permitir plugins no firmados:

Reduce las garantías de integridad.
Puede introducir código no verificado.
Puede incumplir las políticas de seguridad.
No debería realizarse en producción sin una revisión formal.
Debe limitarse al identificador estrictamente necesario.

No utilizar una configuración genérica que permita cualquier plugin.

Comprobar que un plugin está instalado¶

Desde la interfaz:

Abrir la sección de plugins.
Buscar el nombre.
Revisar el estado.
Comprobar la versión.
Crear un panel nuevo.
Buscar el tipo de visualización.

Desde la terminal:

grafana-cli plugins ls

También se puede revisar el directorio:

sudo find /var/lib/grafana/plugins \
  -maxdepth 1 \
  -mindepth 1 \
  -type d \
  -printf "%f\n" \
  | sort

Consultar logs:

sudo journalctl -u grafana-server \
  --since "10 minutes ago" \
  --no-pager

Actualizar un plugin¶

Antes de actualizar:

Revisar la nueva versión.
Comprobar compatibilidad.
Consultar cambios importantes.
Exportar dashboards que dependan del plugin.
Probar en laboratorio.
Programar una ventana de mantenimiento.
Actualizar.
Reiniciar Grafana si es necesario.
Revisar los dashboards.
Comprobar los logs.

Comando conceptual:

grafana-cli plugins update ID_DEL_PLUGIN

Después:

sudo systemctl restart grafana-server

Comprobaciones posteriores¶

El plugin aparece instalado.
Los paneles siguen cargando.
Las consultas siguen funcionando.
Las opciones no han cambiado.
Las transformaciones se conservan.
Los enlaces funcionan.
La exportación sigue siendo válida.

Deshabilitar un plugin¶

Deshabilitar un plugin puede ser útil cuando:

Está causando errores.
Se necesita realizar una prueba.
Se sospecha que afecta al rendimiento.
Se quiere impedir su uso temporalmente.
Se prepara una retirada.

El procedimiento depende de la versión de Grafana y del método de administración.

Antes de deshabilitarlo:

Identificar los dashboards afectados.
Exportar una copia.
Informar a los usuarios.
Registrar la modificación.
Tener un procedimiento de recuperación.

Eliminar un plugin¶

Antes de eliminar un plugin:

Buscar dashboards que lo utilizan.
Exportar esos dashboards.
Sustituir los paneles dependientes.
Confirmar que no quedan usuarios.
Detener o reiniciar Grafana según el procedimiento.
Eliminar el plugin.
Revisar los logs.
Comprobar que Grafana inicia correctamente.

Localizar referencias en dashboards exportados¶

Si existen ficheros JSON:

grep -R "ID_DEL_PLUGIN" \
  ~/laboratorio-grafana/dashboards/

También puede utilizarse:

jq '.. | strings | select(contains("ID_DEL_PLUGIN"))' \
  dashboard.json

Advertencia¶

Eliminar un plugin no convierte automáticamente sus paneles en paneles estándar.

Los dashboards que dependan de él pueden mostrar:

Panel plugin not found

Dependencias de un dashboard¶

Un dashboard puede depender de:

Un plugin de panel.
Una fuente de datos.
Una variable.
Una transformación.
Unidades específicas.
Unidades personalizadas.
Un enlace externo.
Una imagen.
Un sistema de autenticación.
Una versión concreta de Grafana.

Ejemplo de documentación¶

### Dependencias

- Grafana: versión compatible con el dashboard.
- Fuente de datos: Prometheus.
- Plugin de panel: `ejemplo-panel-plugin`.
- Versión del plugin: `1.2.0`.
- Variables: `instance`, `job`.
- Transformaciones: `Labels to fields`, `Join by field`.

Documentar estas dependencias facilita:

Migraciones.
Copias de seguridad.
Recuperación.
Formación.
Resolución de incidencias.

Exportar un dashboard que utiliza un plugin¶

Al exportar un dashboard, la definición del panel puede conservar:

Identificador del plugin.
Configuración.
Opciones.
Consultas.
Transformaciones.
Umbrales.
Enlaces.

Sin embargo, exportar el dashboard no siempre incluye el código del plugin.

En el sistema destino puede ser necesario:

Instalar el mismo plugin.
Utilizar una versión compatible.
Configurar la fuente de datos.
Importar el dashboard.
Revisar cada panel.

Proceso recomendado¶

Exportar dashboard
        |
        v
Documentar dependencias
        |
        v
Instalar plugin en destino
        |
        v
Configurar fuente de datos
        |
        v
Importar dashboard
        |
        v
Probar paneles

Diagnóstico de plugins¶

Cuando un panel basado en un plugin no funciona, revisar en este orden:

1. Plugin instalado.
2. Plugin habilitado.
3. Versión compatible.
4. Firma y permisos.
5. Fuente de datos disponible.
6. Consulta válida.
7. Variables correctas.
8. Transformaciones compatibles.
9. Logs de Grafana.
10. Compatibilidad del navegador.

Comprobar el panel¶

Revisar si aparece:

Plugin not found
Panel plugin not found
Plugin failed to load
Unknown panel type
Error loading plugin

Revisar logs¶

sudo journalctl -u grafana-server \
  --since "30 minutes ago" \
  --no-pager

Filtrar por términos:

sudo journalctl -u grafana-server \
  --since "30 minutes ago" \
  --no-pager \
  | grep -Ei "plugin|panel|error|signature"

Problemas habituales¶

El plugin no aparece en la lista¶

Comprobar:

Instalación finalizada.
Identificador correcto.
Directorio de plugins.
Permisos.
Reinicio de Grafana.
Logs.
Compatibilidad de versión.
Firma del plugin.

Aparece “Plugin not found”¶

Posibles causas:

El plugin no está instalado.
Se eliminó el plugin.
El identificador ha cambiado.
El dashboard se importó en otra instancia.
La versión no reconoce el plugin.

Solución general:

Identificar el plugin.
Instalar una versión compatible.
Reiniciar Grafana.
Volver a abrir el dashboard.

El plugin aparece, pero el panel está vacío¶

Comprobar:

Fuente de datos.
Consulta.
Variables.
Rango temporal.
Formato esperado.
Transformaciones.
Opciones específicas del plugin.

El plugin provoca errores en Grafana¶

Revisar:

Logs.
Compatibilidad.
Dependencias.
Arquitectura.
Permisos.
Versión de Node o runtime, si aplica.
Documentación del proveedor.

En laboratorio se puede deshabilitar temporalmente para aislar el problema.

El plugin no está firmado¶

No habilitarlo automáticamente en producción.

Revisar:

Procedencia.
Código fuente.
Reputación.
Firma disponible.
Política de seguridad.
Necesidad real.
Alcance de la configuración.

El panel cambia después de actualizar¶

Posibles causas:

Cambios de configuración.
Campos renombrados.
Opciones eliminadas.
Transformaciones incompatibles.
Cambios en el formato de datos.
Cambios en la consulta.
Cambios en la unidad.

Comparar:

Versión anterior.
Versión nueva.
Exportación JSON.
Documentación de cambios.

El dashboard no se puede importar¶

Comprobar:

Plugin instalado.
Versión compatible.
Fuentes de datos.
Variables.
Transformaciones.
Permisos.
Identificadores de panel.

Seguridad de los plugins¶

Los plugins son software que se ejecuta o se integra con Grafana.

Por ello deben tratarse como componentes de la plataforma.

Buenas prácticas¶

Instalar plugins desde fuentes confiables.
Revisar firmas.
Mantenerlos actualizados.
Aplicar el principio de mínimo privilegio.
Probar antes en laboratorio.
Documentar versiones.
Revisar cambios.
Limitar plugins no firmados.
Eliminar plugins no utilizados.
Supervisar los logs.
Mantener copias de seguridad.
No instalar plugins por recomendación no verificada.

En producción¶

Antes de instalar un plugin:

1. Solicitar aprobación.
2. Revisar seguridad.
3. Probar compatibilidad.
4. Evaluar impacto.
5. Documentar el cambio.
6. Planificar reversión.
7. Aplicar en una ventana controlada.

Rendimiento¶

Un plugin puede afectar al rendimiento de:

El navegador.
Grafana.
Prometheus.
La red.
La experiencia del usuario.

Factores que pueden aumentar el coste¶

Muchas consultas.
Muchas series.
Imágenes grandes.
Actualización frecuente.
Transformaciones complejas.
Código poco optimizado.
Paneles muy grandes.
Uso simultáneo por muchos usuarios.

Recomendaciones¶

Limitar el número de paneles.
Limitar la cantidad de series.
Utilizar rangos temporales razonables.
Utilizar filtros PromQL.
Reducir la frecuencia de actualización.
Evitar imágenes innecesariamente grandes.
Medir el rendimiento antes y después.

Plugins y permisos de usuario¶

No todos los usuarios deben poder:

Instalar plugins.
Actualizar plugins.
Eliminar plugins.
Configurar plugins.
Administrar Grafana.

Separación de responsabilidades¶

Rol	Acceso habitual
Viewer	Utilizar dashboards
Editor	Modificar paneles
Admin	Gestionar configuración y plugins

La configuración exacta depende de la organización y de la versión de Grafana.

Recomendación¶

Limitar la administración de plugins a usuarios responsables de la plataforma.

Ejemplo completo 1: documentar un plugin de panel¶

Contenido recomendado¶

## Plugin de panel utilizado

### Identificador

```text
ejemplo-panel-plugin

Versión¶

1.2.0

Finalidad¶

Representar visualmente la distribución de estados de los servicios monitorizados.

Fuente de datos¶

Prometheus

Dashboards dependientes¶

Resumen de infraestructura.
Estado de aplicaciones.

Requisitos¶

Grafana compatible.
Prometheus configurado.
Variables instance y job.

Mantenimiento¶

Revisar la compatibilidad antes de actualizar Grafana.

---

## Ejemplo completo 2: instalar un plugin en laboratorio

### Objetivo

Practicar el proceso de instalación de un plugin sin afectar a producción.

### Pasos conceptuales

1. Consultar el catálogo.
2. Seleccionar un plugin aprobado para el laboratorio.
3. Anotar su identificador.
4. Revisar la documentación.
5. Revisar la versión de Grafana.
6. Exportar los dashboards existentes.
7. Instalar el plugin.
8. Reiniciar Grafana.
9. Revisar los logs.
10. Crear un panel de prueba.
11. Guardar el resultado.
12. Documentar la instalación.

### Comandos de comprobación

```bash
grafana-cli plugins ls

sudo systemctl restart grafana-server

sudo systemctl status grafana-server

sudo journalctl -u grafana-server \
  --since "10 minutes ago" \
  --no-pager

Actividades¶

Identifica el plugin instalado.
Anota su versión.
Comprueba su estado.
Crea un panel.
Selecciona el plugin.
Utiliza una consulta de Prometheus.
Documenta las opciones disponibles.

Ejemplo completo 3: crear un panel con un plugin¶

Objetivo¶

Utilizar un plugin de panel para mostrar una métrica.

Consulta¶

100 * avg(up)

Pasos¶

Crear un dashboard de laboratorio.
Añadir un panel.
Seleccionar el plugin instalado.
Seleccionar Prometheus.
Introducir la consulta.
Configurar la unidad como porcentaje.
Configurar los umbrales.
Revisar la visualización.
Guardar el panel.
Guardar el dashboard.

Actividades¶

Cambia la consulta a:

100 - (
  avg(
    rate(node_cpu_seconds_total{mode="idle"}[5m])
  ) * 100
)

Cambia la unidad.
Prueba una variable de instancia.
Exporta el dashboard.
Documenta la dependencia del plugin.

Ejemplo de sesión 1: inventario de plugins¶

Objetivo¶

Identificar los plugins disponibles en una instalación de Grafana.

Pasos¶

Abrir Grafana.
Acceder a la sección de plugins.
Revisar los paneles integrados.
Revisar los plugins externos.
Anotar:
Nombre.
Identificador.
Versión.
Estado.
Firma.
Comparar la lista con la salida de:

grafana-cli plugins ls

Actividades¶

Crear una tabla:

Nombre	Identificador	Versión	Firmado	Uso

Responder:

¿Qué plugins están instalados?
¿Cuáles son paneles?
¿Cuáles son fuentes de datos?
¿Hay plugins no utilizados?
¿Hay plugins pendientes de actualización?

Ejemplo de sesión 2: instalar y comprobar un plugin¶

Objetivo¶

Instalar un plugin aprobado para el laboratorio.

Pasos¶

Seleccionar el plugin.
Revisar la documentación.
Anotar el identificador.
Exportar los dashboards.
Ejecutar la instalación:

grafana-cli plugins install ID_DEL_PLUGIN

Reiniciar Grafana:

sudo systemctl restart grafana-server

Comprobar el estado:

sudo systemctl status grafana-server

Revisar los logs:

sudo journalctl -u grafana-server \
  --since "10 minutes ago" \
  --no-pager

Confirmar que aparece en Grafana.
Crear un panel de prueba.

Actividades¶

Anota el resultado de cada paso.
Comprueba la versión instalada.
Comprueba si requiere una fuente de datos concreta.
Crea una captura del panel.
Completa el informe de instalación.

Ejemplo de sesión 3: probar la compatibilidad¶

Objetivo¶

Comprobar que un plugin funciona con una consulta Prometheus.

Consulta inicial¶

up

Pasos¶

Crear un panel con el plugin.
Ejecutar la consulta.
Comprobar que muestra datos.
Cambiar la consulta a:

node_load1

Comprobar el cambio de unidad.
Cambiar la consulta a:

100 * avg(up)

Configurar umbrales.
Probar una variable.
Guardar el panel.

Actividades¶

¿Qué tipos de datos acepta el plugin?
¿Permite varias series?
¿Admite transformaciones?
¿Permite variables?
¿Permite enlaces?
¿Qué opciones son específicas del plugin?

Ejemplo de sesión 4: actualizar un plugin¶

Objetivo¶

Practicar una actualización controlada.

Pasos¶

Consultar la versión instalada:

grafana-cli plugins ls

Exportar el dashboard.
Anotar la versión actual.
Revisar la versión disponible.
Consultar cambios importantes.
Actualizar:

grafana-cli plugins update ID_DEL_PLUGIN

Reiniciar Grafana:

sudo systemctl restart grafana-server

Revisar los logs.
Abrir el dashboard.
Comprobar el panel.
Comparar con la exportación anterior.

Actividades¶

Documenta la versión anterior.
Documenta la versión nueva.
Comprueba las opciones.
Comprueba las consultas.
Comprueba los colores.
Comprueba las transformaciones.
Registra cualquier cambio.

Ejemplo de sesión 5: simular una migración¶

Objetivo¶

Importar un dashboard que utiliza un plugin en otra instancia de Grafana.

Instancia origen¶

Grafana A

Instancia destino¶

Grafana B

Pasos¶

En Grafana A, identificar el plugin.
Exportar el dashboard.
Documentar la versión.
Instalar la misma versión en Grafana B.
Configurar Prometheus en Grafana B.
Importar el dashboard.
Seleccionar la fuente de datos.
Comprobar el panel.
Comparar las configuraciones.

Actividades¶

Importa el dashboard sin instalar el plugin.
Documenta el error.
Instala el plugin.
Repite la importación.
Explica la diferencia.
Completa la tabla de dependencias.

Ejemplo de sesión 6: diagnosticar un plugin ausente¶

Objetivo¶

Resolver un dashboard que muestra un panel desconocido.

Situación¶

El dashboard presenta:

Panel plugin not found

Procedimiento¶

Exportar el dashboard.
Abrir el JSON.
Localizar el identificador del panel.
Buscar el identificador en la instalación.
Consultar la lista de plugins:

grafana-cli plugins ls

Instalar una versión compatible.
Reiniciar Grafana.
Volver a abrir el dashboard.
Comprobar el panel.

Actividades¶

Documentar:

Identificador del plugin:
Versión requerida:
Versión instalada:
Error inicial:
Acción aplicada:
Resultado:

Ejemplo de sesión 7: probar un plugin no firmado en laboratorio¶

Objetivo¶

Comprender las implicaciones de un plugin no firmado.

Advertencia¶

Esta actividad debe realizarse únicamente en un entorno aislado y autorizado.

Pasos¶

Revisar el identificador del plugin.
Confirmar que la fuente es confiable.
Revisar el código o la documentación.
Añadir únicamente el identificador permitido a la configuración.
Reiniciar Grafana.
Revisar los logs.
Crear un panel de prueba.
Registrar la configuración.
Retirar el permiso al finalizar.
Reiniciar Grafana.

Configuración conceptual:

[plugins]
allow_loading_unsigned_plugins = ID_DEL_PLUGIN

Actividades¶

Explica por qué se requiere una configuración especial.
Explica los riesgos.
Comprueba que el plugin funciona.
Elimina la autorización.
Comprueba el comportamiento posterior.
Documenta la reversión.

Ejemplo de sesión 8: eliminar un plugin no utilizado¶

Objetivo¶

Retirar un plugin después de comprobar que no existen dependencias.

Pasos¶

Listar los plugins:

grafana-cli plugins ls

Identificar el plugin.
Buscar su identificador en dashboards exportados:

grep -R "ID_DEL_PLUGIN" \
  ~/laboratorio-grafana/dashboards/

Exportar los dashboards afectados.
Sustituir los paneles dependientes.
Eliminar el plugin mediante el procedimiento aprobado.
Reiniciar Grafana.
Revisar los logs.
Comprobar los dashboards.
Documentar la retirada.

Actividades¶

Identifica qué dashboards dependían del plugin.
Registra cómo se sustituyeron.
Comprueba que Grafana funciona.
Verifica que no aparecen errores de plugin.

Ejemplo de sesión 9: revisar rendimiento¶

Objetivo¶

Observar el impacto de un panel basado en un plugin.

Pasos¶

Abrir el panel.
Utilizar un rango de una hora.
Observar el tiempo de carga.
Cambiar el rango a 24 horas.
Aumentar el número de series.
Reducir el número de series.
Comparar el comportamiento.
Revisar los logs.
Utilizar las herramientas del navegador si están disponibles.

Actividades¶

¿Cambia el tiempo de carga?
¿Qué ocurre al mostrar más series?
¿Qué parte del procesamiento realiza Grafana?
¿Qué parte realiza Prometheus?
¿Cómo reducirías la carga?

Ejemplo de sesión 10: documentar una dependencia¶

Objetivo¶

Crear documentación para que otro administrador pueda recuperar el dashboard.

Contenido¶

## Dependencias del dashboard

### Grafana

Versión probada:

```text
Indicar versión

Plugin de panel¶

Identificador:

ID_DEL_PLUGIN

Versión:

Indicar versión

Fuente de datos¶

Prometheus

Variables¶

instance
job

Transformaciones¶

Labels to fields
Organize fields by name
Reduce

Procedimiento de recuperación¶

Instalar Grafana.
Configurar Prometheus.
Instalar el plugin.
Comprobar la versión.
Importar el dashboard.
Seleccionar la fuente de datos.
Revisar las variables.

Probar el panel.

### Actividades

1. Completa la documentación.
2. Exporta el dashboard.
3. Entrega el JSON junto con la documentación.
4. Comprueba que otra persona puede reproducir el entorno.

---

## Gestión de plugins mediante configuración

Grafana puede tener opciones relacionadas con plugins en su fichero de configuración.

La ubicación depende de la instalación.

Una ruta habitual es:

```text
/etc/grafana/grafana.ini

Consultar parámetros relacionados:

sudo grep -n "\[plugins\]" \
  /etc/grafana/grafana.ini

Consultar la sección:

sudo sed -n '/^\[plugins\]/,/^\[/p' \
  /etc/grafana/grafana.ini

Las opciones pueden incluir:

Directorio de plugins.
Plugins permitidos.
Plugins no firmados.
Configuración de actualizaciones.
Opciones de carga.

No modificar la configuración sin:

Copia de seguridad.
Registro del cambio.
Revisión de sintaxis.
Plan de reversión.
Reinicio controlado.

Plugins y archivos JSON¶

Un dashboard exportado puede incluir referencias como:

{
  "type": "ID_DEL_PLUGIN",
  "title": "Panel personalizado"
}

El campo type identifica el tipo de panel.

Para localizar paneles de un plugin:

jq '.. | objects | select(.type? == "ID_DEL_PLUGIN")' \
  dashboard.json

Buscar referencias de forma general:

grep -n "ID_DEL_PLUGIN" dashboard.json

Actividades¶

Exporta un dashboard con un plugin.
Busca su identificador.
Localiza su configuración.
Identifica las consultas.
Comprueba las opciones específicas.
Documenta los campos relevantes.

Buenas prácticas de ciclo de vida¶

Antes de instalar¶

1. Definir la necesidad.
2. Comprobar si existe una alternativa integrada.
3. Revisar el plugin.
4. Comprobar compatibilidad.
5. Evaluar seguridad.
6. Probar en laboratorio.

Durante la instalación¶

1. Registrar versión.
2. Registrar identificador.
3. Revisar permisos.
4. Instalar desde una fuente confiable.
5. Reiniciar según el procedimiento.
6. Revisar logs.

Durante la operación¶

1. Supervisar errores.
2. Revisar compatibilidad.
3. Mantener dashboards documentados.
4. Controlar actualizaciones.
5. Revisar rendimiento.

Antes de eliminar¶

1. Buscar dependencias.
2. Exportar dashboards.
3. Sustituir paneles.
4. Informar a los usuarios.
5. Ejecutar la retirada.
6. Verificar el resultado.

Evidencias de la práctica¶

Crear el directorio:

mkdir -p ~/laboratorio-grafana/evidencias/plugins-paneles

Guardar el inventario:

grafana-cli plugins ls \
  > ~/laboratorio-grafana/evidencias/plugins-paneles/plugins.txt

Guardar información del servicio:

systemctl status grafana-server --no-pager \
  > ~/laboratorio-grafana/evidencias/plugins-paneles/grafana-status.txt

Guardar logs recientes:

sudo journalctl -u grafana-server \
  --since "30 minutes ago" \
  --no-pager \
  > ~/laboratorio-grafana/evidencias/plugins-paneles/grafana-logs.txt

Guardar la documentación del plugin:

cat > ~/laboratorio-grafana/evidencias/plugins-paneles/plugin.txt <<'EOF'
Plugin utilizado:

Identificador:

Versión:

Tipo:
Panel

Fuente de instalación:

Estado de firma:

Versión de Grafana:

Dashboards dependientes:

Problemas encontrados:

Soluciones aplicadas:
EOF

Guardar un informe:

cat > ~/laboratorio-grafana/evidencias/plugins-paneles/informe.txt <<'EOF'
Práctica: Plugins de paneles

Plugin utilizado:

Identificador:

Versión inicial:

Versión final:

Instalación realizada:
- Interfaz
- Línea de comandos
- Manual

Paneles creados:

Consultas utilizadas:

Transformaciones utilizadas:

Actualización realizada:

Problemas encontrados:

Soluciones aplicadas:

Revisión de seguridad:

Conclusiones:
EOF

Capturas recomendadas:

01-lista-plugins.png
02-detalle-plugin.png
03-plugin-instalado.png
04-panel-plugin.png
05-panel-configurado.png
06-error-plugin-ausente.png
07-plugin-recuperado.png
08-dashboard-final.png

Práctica integradora¶

Objetivo¶

Instalar, utilizar, documentar y mantener un plugin de panel en un entorno de laboratorio.

Requisitos¶

Utilizar un plugin aprobado por el instructor.

Registrar:

Identificador
Versión
Tipo
Firma
Compatibilidad
Fuente de instalación

Tareas¶

Consultar los plugins instalados.
Seleccionar un plugin de panel.
Revisar su documentación.
Comprobar su compatibilidad.
Exportar los dashboards actuales.
Instalar el plugin.
Reiniciar Grafana.
Revisar los logs.
Crear un panel de prueba.
Utilizar una consulta Prometheus.
Configurar la unidad.
Configurar colores o umbrales.
Añadir una variable.
Añadir una transformación si es compatible.
Guardar el panel.
Exportar el dashboard.
Importar una copia en otra instancia o carpeta.
Comprobar la dependencia del plugin.
Actualizar el plugin en laboratorio.
Comparar el comportamiento.
Documentar la actualización.
Desinstalarlo o dejarlo documentado según las instrucciones del curso.

Tabla de resultados¶

Comprobación	Resultado	Observaciones
Plugin localizado
Identificador comprobado
Versión registrada
Firma revisada
Compatibilidad comprobada
Dashboard exportado
Plugin instalado
Grafana reiniciado
Logs revisados
Panel de prueba creado
Consulta configurada
Unidad configurada
Variables comprobadas
Transformaciones comprobadas
Dashboard exportado
Dashboard importado
Actualización realizada
Dependencias documentadas
Plugin retirado o mantenido
Evidencias guardadas

Puntos clave¶

Un plugin amplía las capacidades de Grafana.
Los plugins de panel añaden nuevas visualizaciones.
Los plugins de fuentes de datos permiten consultar sistemas externos.
Los plugins de aplicación ofrecen funciones más amplias.
Los plugins integrados suelen requerir menos mantenimiento.
Los plugins externos deben revisarse antes de instalarse.
La firma, la procedencia y la compatibilidad son aspectos importantes.
Un plugin puede requerir una versión concreta de Grafana.
Después de instalar un plugin puede ser necesario reiniciar Grafana.
Los logs ayudan a diagnosticar errores de carga.
Un dashboard exportado no incluye necesariamente el código del plugin.
Para restaurar un dashboard se debe instalar el plugin compatible.
Los plugins no firmados deben limitarse a entornos controlados.
No se deben permitir plugins no firmados de forma genérica.
Antes de actualizar un plugin conviene exportar los dashboards dependientes.
Antes de eliminar un plugin hay que localizar sus dependencias.
Los plugins pueden afectar al rendimiento.
Los usuarios deben disponer únicamente de los permisos necesarios.
Las dependencias deben documentarse junto al dashboard.
Un plugin debe utilizarse cuando aporta valor real.
Un panel integrado puede ser preferible por simplicidad y portabilidad.
La gestión de plugins forma parte de la administración de Grafana.

Preguntas de comprobación¶

¿Qué es un plugin de Grafana?
¿Qué diferencia existe entre un plugin de panel y un plugin de fuente de datos?
¿Qué ventajas ofrecen los plugins integrados?
¿Qué riesgos pueden tener los plugins externos?
¿Qué información revisarías antes de instalar un plugin?
¿Qué es el identificador de un plugin?
¿Qué significa que un plugin esté firmado?
¿Por qué es importante comprobar la compatibilidad?
¿Qué pasos realizarías después de instalar un plugin?
¿Qué comando permite consultar los plugins instalados?
¿Dónde buscarías los logs de Grafana?
¿Qué puede ocurrir si se importa un dashboard sin instalar su plugin?
¿Qué diferencia existe entre exportar un dashboard y exportar un plugin?
¿Qué precauciones tomarías al habilitar un plugin no firmado?
¿Qué pasos seguirías antes de actualizar un plugin?
¿Qué pasos seguirías antes de eliminar un plugin?
¿Cómo buscarías dashboards que dependan de un plugin?
¿Qué factores pueden afectar al rendimiento de un plugin?
¿Qué permisos deberían tener los usuarios que administran plugins?
¿Qué información documentarías sobre una dependencia?
¿Cómo diagnosticarías un mensaje Plugin not found?
¿Qué comprobarías si el plugin aparece, pero el panel está vacío?
¿Cuándo utilizarías un panel integrado en lugar de un plugin?
¿Qué evidencias guardarías durante la práctica?
¿Qué características debe cumplir un plugin apto para producción?

Resultado esperado¶

Al finalizar esta sección, el alumno debe ser capaz de gestionar plugins de paneles de forma controlada.

El proceso completo será:

Definir la necesidad
        |
        v
Buscar una solución integrada
        |
        v
Evaluar el plugin
        |
        v
Comprobar seguridad y compatibilidad
        |
        v
Probar en laboratorio
        |
        v
Instalar y reiniciar
        |
        v
Crear un panel de prueba
        |
        v
Revisar logs y rendimiento
        |
        v
Documentar dependencias
        |
        v
Actualizar o retirar de forma controlada

El resultado final debe ser una instalación de Grafana en la que los plugins estén justificados, documentados, actualizados y gestionados con criterios de seguridad y mantenimiento.

Un plugin no debe instalarse únicamente porque su captura de pantalla sea llamativa. Debe resolver una necesidad concreta y poder mantenerse durante todo el ciclo de vida del dashboard.