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.
Variables
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.
Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9
Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8
Una variable es un marcador de posición para un valor. Puede usar variables en las consultas de métricas y en los títulos de los paneles. Por lo tanto, cuando cambies el valor mediante el menú desplegable de la parte superior del panel, las consultas de métricas del panel cambiarán para reflejar el nuevo valor.
Las variables te permiten crear paneles más interactivos y dinámicos. En lugar de codificar de forma rígida elementos como los nombres de los servidores, las aplicaciones y los sensores en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran en forma de listas desplegables en la parte superior del panel de control. Estos menús desplegables facilitan el cambio de los datos que se muestran en el panel.
Pueden resultar especialmente útiles para los administradores que desean permitir que los espectadores de Grafana ajusten rápidamente las visualizaciones, pero no quieren concederles permisos de edición completos. Los visores de Grafana pueden usar variables.
Las variables y las plantillas también permiten crear paneles de control de una sola fuente. Si tiene varias fuentes de datos o servidores idénticos, puede crear un panel y usar variables para cambiar lo que está viendo. Esto simplifica enormemente el mantenimiento y la conservación.
Plantillas
Una plantilla es cualquier consulta que contiene una variable. Por ejemplo, si administrara un panel para supervisar varios servidores, podría crear un panel para cada servidor o podría crear un panel 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- =value<varname>.
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 de control > Variables. Haga clic en una variable de la lista para ver su configuración.
Las variables se pueden usar en los títulos, las descripciones, los paneles de texto y las consultas. Las consultas cuyo texto comienza con $ son plantillas. No todos los paneles tendrán consultas de plantilla.
Mejores prácticas variables
-
Las listas desplegables de variables se muestran en el orden en que aparecen en la lista de variables de la configuración del panel de control.
-
Coloca las variables que cambiarás con frecuencia en la parte superior para que se muestren primero (en el extremo izquierdo del panel de control).
-
De forma predeterminada, las variables preseleccionan el valor superior de la lista desplegable. Si prefiere elegir un valor vacío, cambie la configuración de las variables de la siguiente manera:
-
Seleccione la casilla de verificación Incluir todas las opciones.
-
En el campo Personalizar todos los valores, introduzca el valor
+.
-
