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. # Correlaciones en la versión 10 de Grafana **** 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](using-grafana-v9.md). 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](using-grafana-v8.md). Puede crear vínculos interactivos para que las visualizaciones de Explore ejecuten consultas relacionadas con los datos presentados mediante la configuración de las correlaciones. Una correlación define cómo se utilizan los datos de un origen de datos para consultar los datos de otro origen de datos. Presentamos algunos ejemplos: + El nombre de una aplicación devuelto en un origen de datos de registros se puede utilizar para consultar las métricas relacionadas con esa aplicación en un origen de datos de métricas. + El nombre de usuario devuelto por un origen de datos SQL se puede utilizar para consultar los registros relacionados con ese usuario concreto en un origen de datos de registros. Explore utiliza las correlaciones que define el usuario para mostrar los vínculos dentro de las visualizaciones. Puede hacer clic en un vínculo para ejecutar la consulta relacionada y ver los resultados en la vista dividida de Explore. Explore las visualizaciones que actualmente permiten mostrar vínculos en función de las correlaciones: + [Registros](v10-panels-logs.md) + [Tabla](v10-panels-table.md) Puede configurar las correlaciones desde la página **Administración > Complementos y datos > Correlaciones** en Grafana o directamente en [Explore](v10-explore-correlations.md). **Topics** + [Configuración de correlación](v10-correlations-config.md) + [Creación de una correlación](v10-correlations-create.md) # 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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md). 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](using-grafana-v8.md). 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](v10-correlations-create.md). ## 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](v10-dash-variable-syntax.md). 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](v10-panels-configure-data-links.md#v10-panels-data-link-variables) (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 llamado`employee`, 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](v10-dash-variable-add.md#v10-dash-variable-add-global) 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](https://brandur.org/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 distinto del campo de resultados. Variables de salida de ejemplo de `field = "host=srv001 endpoint=/test app=foo"`: | name | 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 | | --- | --- | --- | --- | | /\$1w\$1 (\$1w\$1)/ | - | employee=Doe | No se proporciona ninguna propiedad mapValue. La primera coincidencia se asigna a la variable de nombre de campo existente (employee). | | /(\$1w\$1) (\$1w\$1)/ | name | name=John | La primera coincidencia se asigna a una nueva variable llamada name. | | /(?\$1w\$1) (?\$1w\$1)/ | - | firstName=John, lastName=Doe | Cuando se utilizan grupos con nombre, son los nombres de las variables de salida y la propiedad mapValue se ignora. | | /(?\$1w\$1) (?\$1w\$1)/ | name | firstName=John, lastName=Doe | Igual que lo mencionado anteriormente | # Creación de una 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 los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte [Uso de la versión 9 de Grafana](using-grafana-v9.md). 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](using-grafana-v8.md). Puede crear correlaciones en el editor de correlaciones de Explore o mediante la página **Administración** de Grafana en el espacio de trabajo de Amazon Managed Grafana. **Requisitos previos** Debe tener permiso para agregar correlaciones nuevas. Solo los usuarios con permisos de escritura en los orígenes de datos pueden definir nuevas correlaciones. ## Creación de una correlación en el editor de correlaciones de Explore Puede crear una correlación en el editor de correlaciones de Explore. Para obtener más información, consulte [Creación de una correlación](v10-explore-correlations.md#v10-explore-corr-create-a-correlation). ## Creación de una correlación en la página de administración Puede utilizar la página **Administración** de la consola de Grafana para crear una correlación. **Creación de una correlación en la página de administración** 1. Vaya a la sección **Administración** de Grafana. 1. En **Complementos y datos**, abra la página **Correlaciones**. 1. Elija el botón **Agregar** situado en la esquina superior derecha. 1. Proporcione una **etiqueta** para la correlación. 1. (Opcional) Proporcione una **descripción**. 1. Vaya a la siguiente página. 1. Proporcione el **origen de datos de destino**. 1. Proporcione la **consulta de destino** mediante variables. 1. Vaya a la siguiente página. 1. Proporcione el **origen de datos de origen**. 1. Proporcione el **campo de resultados**. 1. Agregue transformaciones si necesita variables que no sean campos en el origen de datos de origen. 1. Elija **Agregar** para agregar una nueva transformación. 1. Seleccione el tipo de transformación. 1. Configure la transformación en función del tipo seleccionado. 1. Guarde la correlación. Puede editar una correlación de la misma manera, pero al editar, no puede cambiar los orígenes de datos seleccionados.