Jorge Turbica / blog · Blog ← Todos los artículos EN · Read in English
Tecnologías

Grafana 13.3: una variable para todos tus dashboards y un cambio en RBAC que revisar

Grafana 13.3 trae variables compartidas entre dashboards, Notebooks e importación de Alertmanager, y amplía quién puede revocar permisos. Cómo actualizar.

Si tienes veinte dashboards con el mismo selector de cluster, hasta ahora tenías veinte variables que mantener a mano. Grafana 13.3, anunciada el 29 de octubre de 2026, permite definir esa variable una vez y reutilizarla en toda la organización. Llega junto a Notebooks para documentar investigaciones, el mayor rediseño visual desde Grafana 7 y varios cambios en alertas que interesan más a quien está de guardia que a quien diseña dashboards.

Variables compartidas entre dashboards

Es la novedad que más trabajo ahorra. Las variables se crean en Dashboards > Variables con uno de dos alcances:

  • Global: disponible en todos los dashboards de la organización.
  • Carpeta: solo en los dashboards de esa carpeta.

Al editar un dashboard, la variable se añade desde la barra lateral como Global or folder variable. Quien mira el dashboard puede seguir cambiando su valor, pero la definición (la consulta, las opciones, el valor por defecto) vive en un único sitio. El problema que resuelve es la deriva de configuración: el dashboard de un equipo que filtra por env con una regex distinta a la de los demás y que nadie detecta hasta que un incidente no cuadra.

Está en public preview en todas las ediciones. En Grafana autogestionado se activa con el feature toggle grafana.dashboardGlobalVariables.

Notebooks para las investigaciones y los postmortems

Una investigación suele quedar repartida entre un panel, una consulta en Explore, una conversación con Grafana Assistant y capturas en el chat del incidente. Los Notebooks juntan todo en un documento editable: paneles de dashboards o de Explore, hallazgos de Assistant y tus notas al lado de los datos. Se guardan, se comparten y se pueden buscar, filtrar y exportar desde su propia página.

El uso más claro para un SRE es preparar la revisión post-incidente con los paneles relevantes ya colocados, en lugar de reconstruirlos días después. También en public preview; el toggle es dashboard.notebooks.

Alertas: menos migración manual y reglas con contexto obligatorio

Tres cambios que no salen en el titular del anuncio pero importan más en el día a día:

  • Importar la configuración de Alertmanager. Al migrar reglas de Prometheus o Mimir a Grafana Alerting, ahora puedes traer también el enrutado y las notificaciones en lugar de rehacerlos a mano.
  • Alert Advisor. Defines qué etiquetas y anotaciones son obligatorias en las reglas gestionadas por Grafana (un runbook_url, una etiqueta team para enrutar), encuentras las que no las tienen y, si quieres, obligas a cumplirlo en las escrituras por provisioning.
  • Plugin Prometheus Alerting. La gestión de reglas de Prometheus, Mimir y Loki (grupos, rutas, receptores, silencios) pasa a una app aparte. Los enlaces antiguos siguen funcionando y redirigen al plugin; las alertas gestionadas por Grafana se quedan en el núcleo.

Otras novedades útiles

  • Panel time settings y comparación temporal, ya en GA: cambiar o desplazar el rango de un solo panel, o compararlo con un periodo anterior, sin entrar en modo edición.
  • Umbrales con variables: el valor de un umbral puede ser $mi-variable, útil para reutilizar un mismo dashboard con SLO distintos.
  • refIds estáticos en transformaciones: Merge, Join by field, Join by labels o Series to rows generaban un refId del tipo merge-A-B que cambiaba al renombrar o quitar una consulta y rompía las transformaciones posteriores. Ahora la cadena se mantiene estable.
  • Git Sync muestra cada Markdown de una carpeta provisionada como pestaña, con diagramas Mermaid: los runbooks al lado del dashboard.
  • Rediseño visual (public preview, toggle grafana.visualDesignRefresh): colores, tipografía y componentes nuevos, sin cambios de navegación ni roturas en plugins. Se puede volver al diseño anterior.

El cambio incompatible: revocar permisos que no tienes

La única entrada en la lista de breaking changes afecta a RBAC. Quien tenga permiso para gestionar roles o asignaciones de roles puede ahora revocar accesos que él mismo no tiene, al editar o borrar un rol o al quitar asignaciones a través de las APIs /api/access-control/. Si delegas la gestión de roles en equipos o en automatizaciones, revisa quién tiene esos permisos antes de actualizar: su capacidad de quitar acceso es ahora más amplia.

Cómo actualizar a Grafana 13.3

Primero, la copia de seguridad. Con la base de datos SQLite por defecto, para el servicio antes de copiarla:

bash
sudo systemctl stop grafana-server
sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.bak-13.2
sudo cp /etc/grafana/grafana.ini /etc/grafana/grafana.ini.bak-13.2

Con MySQL o PostgreSQL, mysqldump o pg_dump de la base grafana. Después, según cómo lo tengas instalado:

bash
# Repositorio APT de Grafana Labs
sudo apt-get update
sudo apt-get upgrade

# Docker
docker pull grafana/grafana:13.3.0

Para probar las funciones en preview, activa los toggles con entradas individuales en la sección [feature_toggles] de grafana.ini (la opción enable = a,b está obsoleta y se eliminará en una versión mayor):

ini
[feature_toggles]
grafana.dashboardGlobalVariables = true
dashboard.notebooks = true
grafana.visualDesignRefresh = true

En Docker, monta ese fichero en /etc/grafana/grafana.ini, que es la ruta de configuración por defecto de la imagen.

Checklist antes de producción

  1. Actualiza primero un entorno de pruebas con una copia de la base de datos de producción.
  2. Revisa quién tiene permisos de gestión de roles y si alguna automatización llama a /api/access-control/.
  3. Abre los dashboards con transformaciones encadenadas (Merge, Join) y comprueba que los paneles siguen mostrando datos.
  4. Si usas reglas gestionadas por fuentes de datos (Prometheus, Mimir, Loki), comprueba que los enlaces de tus runbooks y notificaciones llevan a la página correcta.
  5. Activa las previews solo en pruebas: son funciones que aún pueden cambiar.

Fuentes

Jorge Turbica

Software Engineer y SRE. Escribo sobre los retos reales que me encuentro en producción.

Ver portfolio ↗