Configurar enlaces de datos

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 ver los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte. Trabajando en Grafana versión 10

Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8

Puede utilizar variables de enlace de datos o enlaces de datos para crear enlaces entre paneles.

Variables de enlace de datos

Puede usar variables en los enlaces de datos para hacer referencia a campos, etiquetas y valores de series. Para obtener más información sobre los enlaces de datos, consulteVínculos de datos.

Para ver una lista de variables disponibles, escriba $ en el campo URL del enlace de datos para ver una lista de variables que puede usar.

nota

Estas variables cambiaron en la versión 6.4, así que si tienes una versión anterior de Grafana, usa el selector de versiones para seleccionar los documentos de una versión anterior de Grafana.

También puedes usar variables de plantilla en las URL de tus enlaces de datos, consulta. Añadir y administrar variables del panel

Variables del panel de intervalos de tiempo

Estas variables le permiten incluir el intervalo de tiempo actual en la URL del enlace de datos.

• __url_time_range: intervalo de tiempo del panel de control actual (¿es decir? desde=ahora-6 horas y a=ahora)

• $__from y $__to: para obtener más información, consulte. Variables globales

Variables de serie

Las variables específicas de la serie están disponibles en el espacio de nombres __series:

• __series.name: nombre de la serie de la URL

Variables de campo

Las variables específicas de cada campo están disponibles en el espacio de nombres __field:

• __field.name: el nombre del campo

• __field.labels. <LABEL>- el valor de la etiqueta para la URL. Si la etiqueta contiene puntos, utilice la sintaxis __field.labels [» «<LABEL>].

Variables de valor

Las variables de valores específicos están disponibles en el espacio de nombres __value:

• __value.time: marca de tiempo del valor (época de Unix en ms) de la URL (es decir,? time=1560268814105)

• __value.raw: valor bruto

• __value.numeric: representación numérica de un valor

• __value.text: representación textual de un valor

• __value.calc: nombre del cálculo si el valor es el resultado del cálculo

Variables de plantilla

Al vincular a otro panel que utilice variables de plantilla, seleccione valores de variables para quien haga clic en el enlace.

$ {var-myvar:queryparam}: donde var-myvar es el nombre de la variable de plantilla que coincide con una variable del panel actual que desea usar.

Estado de la variable	Resultado en la URL creada
seleccionó un valor	var-myvar=valor1
valores múltiples seleccionados	var-myvar=valor1&var-myvar=valor2
seleccionó Todos	var-myvar=Todo

Si quiere añadir todas las variables del panel actual a la URL, utilice $ {__all_variables}.

Vínculos de datos

Los enlaces de datos le permiten proporcionar un contexto más detallado a sus enlaces. Puede crear enlaces que incluyan el nombre de la serie o incluso el valor situado debajo del cursor. Por ejemplo, si la visualización muestra cuatro servidores, puede añadir un enlace de datos a uno o dos de ellos.

Se puede acceder al enlace en sí mismo de diferentes maneras en función de la visualización. Para el gráfico, debe hacer clic en un punto o línea de datos; en el caso de un panel como Stat, Gauge o Bar Gauge, puede hacer clic en cualquier parte de la visualización para abrir el menú contextual.

Puede usar variables en los enlaces de datos para enviar a las personas a un panel detallado con filtros de datos preservados. Por ejemplo, puede usar variables para especificar un rango de tiempo, una serie y una selección de variables. Para obtener más información, consulte Variables de enlace de datos.

Escriba las sugerencias con antelación

Al crear o actualizar un enlace de datos, presiona Cmd+Espacio o Ctrl+Espacio en el teclado para abrir las sugerencias de escritura anticipada y añadir variables a la URL con mayor facilidad.

Añade un enlace de datos

1. Sitúe el cursor sobre el panel al que desee añadir un enlace y, a continuación, pulse e. O bien, haz clic en la flecha desplegable situada junto al título del panel y, a continuación, haz clic en Editar.

2. En la pestaña Campo, desplácese hacia abajo hasta la sección Enlaces de datos.

3. Amplíe Vínculos de datos y, a continuación, haga clic en Agregar enlace.

4. Introduzca un título. El título es una etiqueta legible para el enlace que se mostrará en la interfaz de usuario.

5. Introduce la URL a la que quieres vincular.

   Incluso puede añadir una de las variables de plantilla definidas en el panel de control. Haga clic en el campo URL y, a continuación, escriba $ o pulse Ctrl+Espacio o Cmd+Espacio para ver una lista de las variables disponibles. Al añadir variables de plantilla al enlace del panel, el enlace envía al usuario al contexto correcto, con las variables relevantes ya configuradas. Para obtener más información, consulte Variables de enlace de datos.

6. Si quieres que el enlace se abra en una pestaña nueva, selecciona Abrir en una pestaña nueva.

7. Haz clic en Guardar para guardar los cambios y cerrar la ventana.

8. Haga clic en Guardar en la esquina superior derecha para guardar los cambios en el panel.

Actualiza un enlace de datos

1. En la pestaña Campo, busca el enlace en el que deseas realizar cambios.

2. Haz clic en el icono Editar (lápiz) para abrir la ventana Editar enlace.

3. Realice los cambios necesarios.

4. Haga clic en Guardar para guardar los cambios y cerrar la ventana.

5. Haga clic en Guardar en la esquina superior derecha para guardar los cambios en el panel.

Eliminar un enlace de datos

1. En la pestaña Campo, busca el enlace que deseas eliminar.

2. Haz clic en el icono X situado junto al enlace que deseas eliminar.

3. Haga clic en Guardar en la esquina superior derecha para guardar los cambios en el panel de control.