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.
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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte Uso de la versión 9 de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte Uso de la versión 8 de Grafana.
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.
- Origen de datos de origen
-
Origen de los resultados en los que se muestran los vínculos.
- Campo de resultados
-
Define dónde se muestra el vínculo en una visualización.
- Consulta de destino
-
La consulta de destino que se ejecuta cuando se hace clic en un enlace.
- Transformaciones
-
Las manipulaciones opcionales de los datos del origen incluidos se transfieren a la consulta de destino.
Para obtener más información sobre la creación de una correlación, consulte Creación de una correlación.
Origen de datos de origen y campo de resultados
Los enlaces se muestran en las visualizaciones de Explore para ver los resultados del origen 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 vínculos 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 del origen de datos de destino seleccionado 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 utilizar 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. Existen 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 del origen 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 mediante la aplicación de transformaciones a los campos existentes.
La correlación crea un vínculo 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 con los datos devueltos. Los orígenes de datos interpolan estas variables de manera automática.
Transformación de correlaciones
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.
Existen 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
La transformación logfmt solo requiere especificar el nombre del campo de entrada si desea que la transformación se aplique a un campo distinto del campo de resultados. Variables de salida de ejemplo de field = "host=srv001 endpoint=/test
app=foo":
| nombre | valor |
|---|---|
| host | srv001 |
| punto de conexión | /test |
| 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 de campo de entrada
- expresión
-
Expresión regular. Los grupos de captura con nombre 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 la propiedad mapValue (consulte los ejemplos de la tabla siguiente).
- mapValue
-
Se utiliza con grupos de expresiones regulares sencillos sin grupos coincidentes con nombres. De manera 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 es John Doe.
Varias variables de salida en función de las opciones de expresión y mapValue:
| expresión | mapValue | variables de salida | comentario |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
No se proporciona ninguna propiedad mapValue. La primera coincidencia se asigna a la variable de nombre de campo existente (employee). |
/(\w+) (\w+)/ |
nombre | 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 la propiedad mapValue se ignora. |
/(?\w+) (?\w+)/ |
nombre | firstName=John, lastName=Doe |
Igual que lo mencionado anteriormente |
