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.

Añadir y gestionar variables

En la siguiente tabla se enumeran los tipos de variables que se incluyen con Grafana.

Ingresar a las opciones generales

Debe introducir opciones generales para cualquier tipo de variable que cree.

Añadir una variable de consulta

Las variables de consulta permiten escribir una consulta de fuente de datos que puede devolver una lista de nombres de métricas, valores de etiquetas o claves. Por ejemplo, una variable de consulta puede devolver una lista de nombres de servidores, identificadores de sensores o centros de datos. Los valores de las variables cambian a medida que buscan opciones de forma dinámica con una consulta a una fuente de datos.

Por lo general, las variables de consulta solo se admiten para cadenas. Si la consulta devuelve números o cualquier otro tipo de datos, es posible que deba convertirlos en cadenas para poder utilizarlos como variables. Para la fuente de datos de Azure, por ejemplo, puede usar la función tostring para este propósito.

Las expresiones de consulta pueden contener referencias a otras variables y, de hecho, crear variables vinculadas. Grafana lo detecta y actualiza automáticamente una variable cuando cambia una de sus variables vinculadas.

Añadir una variable personalizada

Utilice una variable personalizada para un valor que no cambie, como un número o una cadena.

Por ejemplo, si tiene nombres de servidores o nombres de regiones que nunca cambian, es posible que desee crearlos como variables personalizadas en lugar de como variables de consulta. Como no cambian, puede utilizarlos en variables encadenadas en lugar de en otras variables de consulta. Eso reduciría la cantidad de consultas que Grafana debe enviar cuando se actualizan las variables encadenadas.

Añadir una variable de cuadro de texto

Las variables del cuadro de texto muestran un campo de entrada de texto libre con un valor predeterminado opcional. Es la variable más flexible, ya que puede introducir cualquier valor. Utilice este tipo de variable si tiene métricas con una cardinalidad alta o si desea actualizar varios paneles de un panel al mismo tiempo.

Añadir una variable constante

Las variables constantes permiten definir una constante oculta. Esto resulta útil para los prefijos de las rutas métricas de los cuadros de mando que desee compartir. Al exportar un panel, las variables constantes se convierten en opciones de importación.

Las variables constantes no son flexibles. Cada variable constante solo contiene un valor y no se puede actualizar a menos que actualice la configuración de la variable.

Las variables constantes son útiles cuando tiene valores complejos que debe incluir en las consultas, pero no desea volver a escribirlos en todas las consultas. Por ejemplo, si tuvieras una ruta de servidor llamadai-0b6a61efe2ab843gg, podrías reemplazarla por una variable llamada$path_gg.

Añadir una variable de fuente de datos

Las variables de la fuente de datos le permiten cambiar rápidamente la fuente de datos de un panel completo. Son útiles si tiene varias instancias de una fuente de datos, quizás en entornos diferentes.

Añadir una variable de intervalo

Utilice una variable de intervalo para representar intervalos de tiempo como 1m1h, o1d. Puede considerarlos como un comando agrupado por tiempo que abarca todo el panel de control. Las variables de intervalo cambian la forma en que se agrupan los datos en la visualización. También puede utilizar la opción automática para devolver un número determinado de puntos de datos por intervalo de tiempo.

Puedes usar una variable de intervalo como parámetro para agruparla por hora (para InfluxDB), intervalo de histograma de fecha (para Elasticsearch) o como parámetro de función de resumen (para Graphite).

Ejemplos de variables de intervalo

El siguiente ejemplo muestra una variable de plantilla myinterval en una función de grafito:

summarize($myinterval, sum, false)

Añadir filtros ad hoc

Los filtros ad hoc permiten añadir filtros clave-valor que se añaden automáticamente a todas las consultas de métricas que utilizan la fuente de datos especificada. A diferencia de otras variables, no se utilizan filtros ad hoc en las consultas. En su lugar, se utilizan filtros ad hoc para escribir filtros para las consultas existentes.

Cree filtros ad hoc

Los filtros ad hoc son una de las opciones variables más complejas y flexibles disponibles. En lugar de una lista normal de opciones variables, esta variable le permite crear una consulta ad hoc que abarque todo el panel. Los filtros que aplique de esta manera se aplican a todos los paneles del tablero.

Configure las opciones de selección de variables

Las opciones de selección son una función que puede utilizar para gestionar las selecciones de opciones variables. Todas las opciones de selección son opcionales y están desactivadas de forma predeterminada.

Variables con varios valores

Interpolar una variable con varios valores seleccionados es complicado, ya que no es fácil formatear los múltiples valores en una cadena que sea válida en el contexto dado en el que se usa la variable. Grafana intenta resolver esto permitiendo que cada complemento de fuente de datos informe al motor de interpolación de plantillas qué formato usar para varios valores.

Variables de valores múltiples con una fuente de datos de Graphite

Graphite usa expresiones globales. En este caso, una variable con varios valores se interpolaría como {host1,host2,host3} si el valor de la variable actual fuera host1, host2 y host3.

Variables de valores múltiples con una fuente de datos de Prometheus o InfluxDB

InfluxDB y Prometheus usan expresiones regex, por lo que se interpolaría la misma variable como. (host1|host2|host3) Cada valor también estaría excluido de expresiones regulares. De lo contrario, un valor con un carácter de control de expresión regular rompería la expresión regular.

Variables de valores múltiples con una fuente de datos elástica

Elasticsearch usa la sintaxis de consulta de Lucene, por lo que se formatearía la misma variable como. ("host1" OR "host2" OR "host3") En este caso, todos los valores deben estar separados para que solo contengan palabras de control y comillas de Lucene.

Solucione los problemas de las variables con varios valores

El escape y el formateo automáticos pueden causar problemas y puede resultar complicado entender la lógica que hay detrás de esto. Especialmente para InfluxDB y Prometheus, donde el uso de la sintaxis de expresiones regulares requiere que la variable se use en el contexto del operador de expresiones regulares.

Si no desea que Grafana realice este escape y formateo automáticos de expresiones regulares, debe realizar una de las siguientes acciones:

Opción Incluir todo

Grafana añade una All opción a la lista desplegable de variables. Si un usuario selecciona esta opción, se seleccionan todas las opciones variables.

Personalice todos los valores

Esta opción solo está visible si se selecciona la opción Incluir todo.

Introduzca la sintaxis de expresiones regulares, globos o lucene en el campo Personalizar todos los valores para definir el valor de la opción. All

De forma predeterminada, el All valor incluye todas las opciones de una expresión combinada. Esto puede llegar a ser muy largo y provocar problemas de rendimiento. A veces puede ser mejor especificar un valor único personalizado, como una expresión regular con caracteres comodín.

Para tener una sintaxis personalizada de expresiones regulares, globos o lucene en la opción Personalizar todos los valores, nunca se escapa, por lo que tendrá que pensar en cuál es un valor válido para su fuente de datos.

Variables globales

Grafana tiene variables globales integradas que se pueden usar en expresiones en el editor de consultas. En este tema se enumeran en orden alfabético y se definen. Estas variables son útiles en consultas, enlaces de paneles, enlaces de paneles y enlaces de datos.

$__dashboard

Esta variable es el nombre del panel actual.

$__from y $__to

Grafana tiene dos variables de rango de tiempo integradas: $__from y. $__to Actualmente, siempre se interpolan como milisegundos de época de forma predeterminada, pero puede controlar el formato de la fecha.

La sintaxis anterior también funciona con${__to}.

$__interval

Puede usar la $__interval variable como parámetro para agrupar por hora (para InfluxDB, MySQL, Postgres, MSSQL), intervalo de histograma de fecha (para Elasticsearch) o como parámetro de función de resumen (para Graphite).

Grafana calcula automáticamente un intervalo que se puede utilizar para agrupar por tiempo en las consultas. Cuando hay más puntos de datos de los que se pueden mostrar en un gráfico, las consultas se pueden hacer más eficientes agrupándolas por un intervalo mayor. Por ejemplo, si está viendo un gráfico de datos de 3 meses, es posible que no pueda ver los detalles a nivel de minutos. Agrupar por hora o día hace que la consulta sea más eficiente sin afectar a lo que muestra el gráfico. $__intervalSe calcula utilizando el intervalo de tiempo y el ancho del gráfico (el número de píxeles).

Cálculo aproximado: (to - from) / resolution

Por ejemplo, si el intervalo de tiempo es de 1 hora y el gráfico está en pantalla completa, el intervalo podría calcularse de la siguiente manera2m: los puntos se agrupan en intervalos de 2 minutos. Si el intervalo de tiempo es de 6 meses y el gráfico es de pantalla completa, el intervalo puede ser 1d (1 día); los puntos se agrupan por día.

En la fuente de datos de InfluxDB, la variable heredada $interval es la misma variable. $__intervaldebería usarse en su lugar.

Las fuentes de datos de InfluxDB y Elasticsearch tienen Group by time interval campos que se utilizan para codificar el intervalo o para establecer el límite mínimo de la $__interval variable (mediante la > sintaxis ->). >10m

$__interval_ms

Esta variable es la $__interval variable en milisegundos, no una cadena con formato de intervalo de tiempo. Por ejemplo, si $__interval es, 20m entonces $__interval_ms es1200000.

$__org

Esta variable es el identificador de la organización actual. ${__org.name}es el nombre de la organización actual.

$__user

${__user.id}es el ID del usuario actual. ${__user.login}es el identificador de inicio de sesión del usuario actual. ${__user.email}es el correo electrónico del usuario actual.

$__range

Actualmente solo es compatible con las fuentes de datos de Prometheus y Loki. Esta variable representa el rango del panel de control actual. Se calcula medianteto - from. Tiene un milisegundo y una segunda representación llamada $__range_ms y$__range_s.

$__rate_interval

Actualmente solo es compatible con las fuentes de datos de Prometheus. La $__rate_interval variable está destinada a usarse en la función de tasa.

$TimeFilter o $__TimeFilter

La $timeFilter variable devuelve el intervalo de tiempo actualmente seleccionado como una expresión. Por ejemplo, la Last 7 days expresión del intervalo de tiempo estime > now() - 7d.

Se usa en varios lugares, entre ellos:

Variables encadenadas

Las variables encadenadas, también denominadas variables vinculadas o variables anidadas, son variables de consulta con una o más variables adicionales en su consulta de variables. En esta sección se explica cómo funcionan las variables encadenadas y se proporcionan enlaces a ejemplos de paneles que utilizan variables encadenadas.

Las consultas de variables encadenadas son diferentes para cada fuente de datos, pero la premisa es la misma para todas. Puede utilizar consultas de variables encadenadas en cualquier fuente de datos que las permita.

Es posible utilizar tableros de mando con plantillas enlazadas extremadamente complejos, de 5 o 10 niveles de profundidad. Técnicamente, no hay límite en cuanto a la profundidad o complejidad que puedas tener, pero cuantos más enlaces tengas, mayor será la carga de consultas.

Prácticas recomendadas y consejos

Las siguientes prácticas harán que sus cuadros de mando y variables sean más fáciles de usar.

Crear nuevas variables vinculadas

Orden variable

Puede cambiar el orden de las variables en la lista de variables del panel de control haciendo clic en las flechas arriba y abajo situadas a la derecha de cada entrada. Grafana muestra los menús desplegables de variables de izquierda a derecha según esta lista, con la variable en la parte superior en el extremo izquierdo.

Consideraciones sobre la complejidad

Cuantos más niveles de dependencia haya en las variables, más tiempo tardará en actualizar los paneles después de cambiar las variables.

Por ejemplo, si tiene una serie de cuatro variables vinculadas (país, región, servidor, métrica) y cambia el valor de una variable raíz (país), Grafana debe ejecutar consultas para todas las variables dependientes antes de actualizar las visualizaciones en el panel.

Gestiona las variables

La página de variables le permite añadir variables y gestionar las variables existentes. También le permite inspeccionar las variables e identificar si una variable está siendo referenciada (o utilizada) en otras variables o en el panel de control.

Mover: puede mover una variable hacia arriba o hacia abajo en la lista arrastrando y soltando.

Clonar: para clonar una variable, haga clic en el icono de clonación del conjunto de iconos de la derecha. Esto crea una copia de la variable con el nombre de la variable original como prefijo. copy_of_

Eliminar: para eliminar una variable, haga clic en el icono de la papelera del conjunto de iconos de la derecha.

Filtra variables con expresiones regulares

Con la opción Consulta de expresiones regulares, se filtra la lista de opciones devuelta por la consulta de variables o se modifican las opciones devueltas.

En esta página se muestra cómo utilizar las expresiones regulares para filtrar/modificar valores en el menú desplegable de variables.

Con la opción de consulta de expresiones regulares, se filtra la lista de opciones devueltas por la consulta de variables o se modifican las opciones devueltas. Para obtener más información, consulta la guía de Mozilla sobre expresiones regulares.

Los siguientes ejemplos muestran el filtrado de la siguiente lista de opciones

backend_01
backend_02
backend_03
backend_04

Filtre para que solo se devuelvan las opciones que terminan en 01 o 02 se devuelven

Regex:

/
(
01|02 
) 
$/

Resultado:

backend_01
backend_02

Filtre y modifique las opciones mediante un grupo de captura de expresiones regulares para devolver parte del texto

Regex:

/.* 
(
01|02 
)
/

Resultado:

01
02

Filtrar y modificar: ejemplo de Prometheus

Lista de opciones:

up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000

Regex:

/. *instance="
(
[^"]*
)
.*/

Resultado:

demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100

Filtre y modifique mediante grupos de captura de valores y texto con nombre asignado

Al usar grupos de captura con nombre, puede capturar partes separadas de «texto» y «valor» de las opciones devueltas por la consulta de variables. Esto permite que la lista desplegable de variables contenga un nombre descriptivo para cada valor que se pueda seleccionar.

Por ejemplo, al consultar la métrica de node_hwmon_chip_names Prometheus, es mucho más chip_name amigable que el valor. chip Por lo tanto, el siguiente resultado de la consulta variable:

node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1

Pasó por la siguiente expresión regular:

/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g

Produciría la siguiente lista desplegable:

Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3

Solo se admiten los nombres de los grupos de value captura text y los nombres de los grupos.

La página de variables le permite identificar fácilmente si se hace referencia a una variable (o se utiliza) en otras variables o en el panel de control.

Todas las variables a las que se hace referencia o se utilizan tienen una marca de verificación verde junto a ellas, mientras que las variables no referenciadas tienen un icono de precaución naranja junto a ellas. Además, todas las variables a las que se hace referencia tienen un icono de dependencia junto a la marca de verificación verde. Puede seleccionar el icono para ver el mapa de dependencias. El mapa de dependencias se puede mover. Puede acercar o alejar la imagen con la rueda del ratón o una herramienta similar.