Configuración de correlación

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

Cada correlación se configura con las siguientes opciones:

Etiqueta

Etiqueta de enlace, que se muestra en la visualización.

Descripción

Descripción opcional.

Fuente: fuente de datos

La fuente de los resultados en los que se muestran los enlaces.

Campo de resultados

Define dónde se muestra el enlace en una visualización.

Consulta de destino

La consulta de destino se ejecuta cuando se hace clic en un enlace.

Transformaciones

Las manipulaciones opcionales de los datos de origen incluidos se transfieren a la consulta de destino.

Para obtener más información sobre la creación de una correlación, consulte Crear una correlación.

Fuente de datos de origen y campo de resultados

Los enlaces se muestran en las visualizaciones de Explore para ver los resultados de la fuente de datos de origen de la correlación. Se asigna un enlace a uno de los campos a partir del resultado proporcionado en la configuración de correlación (el campo de resultados). Cada visualización muestra los campos con enlaces de una manera diferente.

Consulta de destino

La consulta de destino se ejecuta cuando se hace clic en un enlace de la visualización. Puede utilizar el editor de consultas de la fuente de datos de destino seleccionada para especificar la consulta de destino. Se puede acceder a los resultados de los datos de origen dentro de la consulta de destino con variables.

Variables de correlación

Puede usar variables dentro de la consulta de destino para acceder a los datos de origen relacionados con la consulta. Las correlaciones utilizan la sintaxis de variables de Grafana. Cuando se elige el enlace, las variables se rellenan con valores de los resultados de origen. Hay dos tipos de variables que puede utilizar:

• Variables de campo (para acceder a los valores y etiquetas de los campos).

• Variables de correlación (para acceder a los valores y transformaciones de los campos).

Ejemplo: si los resultados de la fuente contienen un campo llamadoemployee, se puede acceder al valor del campo con:

• Una variable de campo${__data.fields.employee}.

• Variable de correlación que asigna el valor de campo anterior a${employee}.

Además de asignar valores de campo a nombres de variables más cortos, se pueden crear más variables de correlación aplicando transformaciones a los campos existentes.

La correlación crea un enlace de datos solo si todas las variables tienen valores en la fila de datos seleccionada. Las variables globales son la excepción a esta regla y no es necesario rellenarlas a partir de los datos devueltos. Estas variables son interpoladas automáticamente por las fuentes de datos.

Transformaciones de correlación

Las transformaciones proporcionan una forma de extraer más variables de los valores de campo. El resultado de las transformaciones es un conjunto de variables nuevas a las que se puede acceder como cualquier otra variable.

Hay dos tipos de transformaciones: logfmt y expresión regular.

Cada transformación utiliza un valor de campo seleccionado como entrada. El resultado de una transformación es un conjunto de variables nuevas basadas en el tipo y las opciones de la transformación.

Transformación Logfmt

La transformación logfmt deconstruye un valor de campo que contiene texto formateado con pares clave/valor de logfmt. Cada par se convierte en una variable y la clave es el nombre de la variable.

La transformación logfmt solo requiere especificar el nombre del campo de entrada si desea que la transformación se aplique a un campo diferente al campo de resultados. Ejemplos de variables de salida para: field = "host=srv001 endpoint=/test app=foo"

name	valor
host	srv001
punto de conexión	/prueba
Aplicación	foo

Transformación de expresiones regulares

La transformación de expresiones regulares deconstruye un valor de campo en función de la expresión regular proporcionada.

Opciones de transformación de expresiones regulares:

campo

Nombre del campo de entrada

expresión

Expresión regular. Los grupos de captura con nombre asignado se asignan a variables que coinciden con el nombre del grupo. Si se utilizan grupos coincidentes sin nombre, se crea una variable a partir de la primera coincidencia. El valor anula la variable que coincide con el campo de entrada o se crea una nueva variable si se proporciona MapValue (consulte los ejemplos de la tabla siguiente).

MapValue

Se utiliza con grupos de expresiones regulares simples sin grupos coincidentes con nombres. De forma predeterminada, la primera coincidencia anula la variable con el nombre del campo que se utiliza como entrada. Para cambiar ese comportamiento predeterminado, puede especificar la propiedad MapValue. El nombre proporcionado se utiliza para crear una nueva variable. Esto puede resultar útil si la consulta de destino requiere tanto el valor exacto como una parte del valor extraído con la transformación.

Ejemplo: Supongamos que el nombre del campo seleccionado es employee y el valor del campo esJohn Doe.

Varias variables de salida basadas en las opciones de expresión y mapValue:

expresión	MapValue	variables de salida	comentario
/\w+ (\w+)/	-	employee=Doe	No se ha proporcionado MapValue. La primera coincidencia se asigna a la variable de nombre de campo existente ()employee.
/(\w+) (\w+)/	name	name=John	La primera coincidencia se asigna a una nueva variable llamada. name
/(?\w+) (?\w+)/	-	firstName=John, lastName=Doe	Cuando se utilizan grupos con nombre, son los nombres de las variables de salida y mapValue se ignora.
/(?\w+) (?\w+)/	name	firstName=John, lastName=Doe	Igual que el anterior