Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte Uso de la versión 10 de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte Uso de la versión 8 de Grafana.
Una variable es un marcador de posición para un valor. Puede utilizar variables en las consultas de métricas y en los títulos de los paneles. Al cambiar el valor mediante la lista desplegable situada en la parte superior del panel de control, las consultas de métricas del panel reflejarán el nuevo valor.
Las variables le permiten crear paneles de control más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de servidores, aplicaciones y sensores en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como listas desplegables en la parte superior del panel de control. Estos menús desplegables facilitan el cambio de datos que se muestran en el panel de control.
Pueden resultar especialmente útiles para los administradores que quieren permitir a los visualizadores de Grafana ajustar las visualizaciones rápidamente, pero no quieren concederles permisos de edición completos. Los visualizadores de Grafana pueden utilizar variables.
Las variables y plantillas también le permiten gestionar paneles de control de un único origen. Si tiene varios orígenes de datos o servidores idénticos, puede crear un panel de control y utilizar variables para cambiar lo que está viendo. Esto simplifica considerablemente el mantenimiento y la conservación.
Plantillas
Una plantilla es cualquier consulta que contiene una variable. Por ejemplo, si administrara un panel de control para supervisar varios servidores, podría crear un panel de control para cada servidor o podría crear un panel de control y utilizar paneles con consultas de plantilla, como las siguientes.
wmi_system_threads{instance=~"$server"}Los valores de las variables siempre se sincronizan con la URL mediante la sintaxis var-<varname>=value.
Ejemplos
Las variables se muestran en listas desplegables en la parte superior de la pantalla. Seleccione diferentes variables para ver cómo cambian las visualizaciones.
Para ver la configuración de las variables, vaya a Configuración del panel > Variables. Haga clic en una variable de la lista para ver su configuración.
Las variables se pueden usar en los títulos, descripciones, paneles de texto y consultas. Las consultas cuyo texto comienza por $ son plantillas. No todos los paneles tendrán consultas de plantilla.
Prácticas recomendadas de variables
-
Las listas desplegables de variables se muestran en el orden en que aparecen en la lista de variables de Configuración del panel.
-
Coloque las variables que cambiará con frecuencia en la parte superior, de modo que se muestren primero (en el extremo izquierdo del panel de control).
