Variables de URL del panel

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

Grafana puede aplicar valores variables pasados como parámetros de consulta en las URL del panel de control. Para obtener más información, consulte Administrar los enlaces y las plantillas y variables del panel de control.

Pasar variables como parámetros de consulta

Grafana interpreta los parámetros de la cadena de consulta con el prefijo var- como variables en el panel dado.

Por ejemplo, en esta URL:

https://${your-domain}/path/to/your/dashboard?var-example=value

El parámetro de consulta var-example=value representa el ejemplo de la variable del panel de control con un valor devalue.

Pasar varios valores a una variable

Para pasar varios valores, repita el parámetro de la variable una vez para cada valor.

https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2

Grafana se interpreta var-example=value1&var-example=value2 como el ejemplo de la variable del tablero con dos valores: y. value1 value2

Añadir variables a los enlaces del panel

Grafana puede añadir variables a los enlaces del panel cuando las generas a partir de la configuración de un panel. Para obtener más información y los pasos para añadir variables, consulta Administrar los enlaces del panel de control.

Pasar filtros ad hoc

Los filtros ad hoc aplican filtros de clave o valor a todas las consultas de métricas que utilizan una fuente de datos específica. Para obtener más información, consulte Filtros ad hoc.

Para pasar un filtro ad hoc como parámetro de consulta, utilice la sintaxis de la variable para pasar la variable de filtro ad hoc y proporcione también la clave, el operador como valor y el valor como una lista separada por tuberías.

Por ejemplo, en esta URL:

https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value

El parámetro de consulta var-adhoc=key|=|value aplica el filtro ad hoc configurado como variable de panel ad hoc mediante la example_key clave, el = operador y el example_value valor.

nota

Al compartir direcciones URL con filtros ad hoc, recuerde codificar la dirección URL. En el ejemplo anterior, sustituya los tubos (|) por %7C y el operador de igualdad (=) por. %3D

Controlar el intervalo de tiempo mediante la URL

Para establecer el intervalo de tiempo de un panel, utilice los parámetros fromto,time, y de time.window consulta. Como no son variables, no requieren el var- prefijo.