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.

# Editor de correlaciones en Explore
<a name="v10-explore-correlations"></a>

****  
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).

Las correlaciones permiten a los usuarios crear un enlace entre dos orígenes de datos. Para obtener más información, incluida una descripción general de las correlaciones, consulte [Correlaciones en la versión 10 de Grafana](v10-correlations.md).

## Creación de una correlación
<a name="v10-explore-corr-create-a-correlation"></a>

Puede crear correlaciones desde la página de Explore.

**Creación de una correlación**

1. En el espacio de trabajo de Amazon Managed Grafana, vaya a la página de Explore.

1. Seleccione un origen de datos que desee que sirva de origen para una nueva correlación.

1. Ejecute una consulta que genere datos en una visualización compatible.
**nota**  
Las visualizaciones compatibles son [Registros](v10-panels-logs.md) y [Tablas](v10-panels-table.md).

1. Elija **\$1 Agregar** en la barra de herramientas superior y seleccione **Agregar correlación** (también puede seleccionar el **Editor de correlaciones** en la [Paleta de comandos](v10-search.md#v10-search-palette)).

   Explore se encuentra ahora en el modo de editor de correlaciones, indicado por un borde azul y una barra superior. Para salir del Editor de correlaciones, seleccione **Salir** en la barra superior.

1. Ahora puede crear las siguientes correlaciones nuevas para la visualización con enlaces adjuntos a los datos que puede utilizar para crear una nueva consulta:
   + *Registros*: los enlaces se muestran junto a los valores de los campos dentro de los detalles del registro de cada fila del registro.
   + *Tabla*: cada celda de la tabla es un enlace.

1. Elija un enlace para agregar una nueva correlación. Los enlaces están asociados a un campo que se utiliza como campo de resultado de una correlación. Para obtener más información, consulte [Configuración de correlación](v10-correlations-config.md).

1. En la vista dividida que se abre, utilice el panel derecho para configurar el origen de consulta de destino de la correlación. Para obtener más información, consulte [Consulta de destino](v10-correlations-config.md#v10-correlations-config-target-query).

1. Para crear una consulta de destino, utilice la [sintaxis de variables](v10-dash-variable-syntax.md) con variables de la lista que aparece en la parte superior del panel. La lista contiene valores de muestra de la fila de datos seleccionada.

1. Proporcione una etiqueta y una descripción (opcional). Se utilizará una etiqueta como nombre del enlace dentro de la visualización y puede contener variables.

1. Proporcione transformaciones (opcional; consulte los detalles a continuación).

1. Seleccione **Guardar** en la barra de herramientas superior para guardar la correlación y salir del modo Editor de correlaciones. El enlace utilizado para crear la correlación se sustituye por un enlace de datos en cada fila. Cuando se selecciona el enlace, la consulta que ha definido se ejecutará en otro panel y las variables se sustituirán dinámicamente por los valores de la fila seleccionada.

## Transformaciones
<a name="v10-explore-corr-transformations"></a>

Las transformaciones permiten extraer valores que existen en un campo con otros datos. Por ejemplo, al utilizar una transformación, puede extraer una parte de una línea de registro para utilizarla en una correlación. Para obtener más información sobre las transformaciones en las correlaciones, consulte [Transformación de correlaciones](v10-correlations-config.md#v10-correlations-config-transformations).

Tras elegir uno de los enlaces generados en el modo editor, puede seleccionar **Agregar transformación** en el menú desplegable **Transformaciones** para agregar transformaciones.

**Uso de una transformación en una correlación**

1. Seleccione un campo en el que aplicar la transformación. Seleccione la parte del campo que desea utilizar para la transformación. Por ejemplo, una línea de registro. Una vez seleccionado, el valor de este campo se utilizará para ayudarle a crear la transformación.

1. Seleccione el tipo de transformación. Consulte [Transformación de correlaciones](v10-correlations-config.md#v10-correlations-config-transformations) para ver las opciones y los ajustes pertinentes. 

1. Según su selección, es posible que vea que se rellenan una o más variables o que necesite proporcionar más especificaciones en las opciones que se muestran.

1. Seleccione **Agregar transformación a la correlación** para agregar las variables especificadas a la lista de variables disponibles.

**nota**  
En el caso de las expresiones regulares de este cuadro de diálogo, el valor `mapValue` al que se hace referencia en otros documentos se denomina `Variable Name` aquí. Grafana resalta cualquier texto que coincida con la expresión del valor del campo. Utilice grupos de captura de expresiones regulares para seleccionar qué parte de la coincidencia debe extraerse. Cuando se proporciona una expresión regular válida, la variable y el valor de esa variable aparecen debajo del campo `Variable Name`.

## Ejemplos de correlación
<a name="v10-explore-corr-examples"></a>

Los siguientes ejemplos muestran cómo crear correlaciones con el editor de correlaciones de Explore. Si desea seguir estos ejemplos, asegúrese de configurar un [origen de datos de prueba](testdata-data-source.md).

### Creación de una correlación entre texto y gráfico
<a name="v10-explore-corr-text-to-graph"></a>

Este ejemplo muestra cómo crear correlaciones con el Editor de correlaciones de Explore.

Las correlaciones permiten usar los resultados de una consulta para ejecutar una nueva consulta en cualquier origen de datos. En este ejemplo, ejecutará una consulta que representa datos tabulares. Los datos se utilizarán para ejecutar una consulta diferente que produzca un resultado gráfico.

Para seguir este ejemplo, asegúrese de haber configurado un [origen de datos de prueba](testdata-data-source.md).

**Creación de una correlación entre texto y gráfico**

1. En Grafana, vaya a **Explore**.

1. Seleccione el **origen de datos de prueba** en el menú desplegable de la parte superior izquierda de la página.

1. Seleccione **\$1 Agregar** en el menú desplegable de la derecha y seleccione **Agregar correlación**.

1. Explore se encuentra ahora en el modo Editor de correlaciones, indicado por un borde azul.

1. Seleccione el siguiente escenario en el menú desplegable del escenario: **archivo CSV**.

1. Seleccione el archivo **population\$1by\$1state.csv**. Cada celda es un enlace en el que puede hacer clic para empezar a crear una nueva correlación.

1. Haga clic en cualquier celda de la columna `State` para crear una nueva correlación que adjunte un enlace de datos a esa entrada. Por ejemplo, seleccione `California`.

1. En la vista dividida, seleccione el mismo origen de datos que ha seleccionado en el panel izquierdo. El asistente situado encima del editor de consultas contiene todas las variables disponibles que puede utilizar en la consulta de destino. Las variables contienen todos los campos de datos (columnas de la tabla) de la fila seleccionada.

1. En el menú **Escenario**, seleccione **Valores de métricas en CSV**. El campo `String Input` del Editor de consultas proporciona variables con valores de población para cada año: `${1980},${2000},${2020}`. Esto generará un gráfico con valores variables.

1. En el campo **Alias** del editor de consultas, ingrese `${State}`.

   Ejecute una consulta para comprobar que produce un gráfico con valores de muestra de las variables.

1. Seleccione **Guardar** para guardar la correlación y salir del modo Editor de correlaciones.

   Una vez guardada la correlación, Explore volverá a ejecutar la consulta en el panel izquierdo. Al hacer clic en el nombre de un estado, la consulta de la derecha se vuelve a ejecutar con los valores de la fila insertados en el CSV, lo que modifica el gráfico. La consulta se vuelve a ejecutar con valores actualizados cada vez que se hace clic en el nombre de un estado.

Puede aplicar los mismos pasos a cualquier origen de datos. Las correlaciones permiten crear enlaces en las visualizaciones para ejecutar consultas dinámicas basadas en los datos seleccionados. En este ejemplo, utilizamos los datos devueltos por una consulta para crear una consulta nueva que generara una visualización diferente con el mismo origen de datos. Sin embargo, puede crear correlaciones entre cualquier origen de datos para crear flujos de exploración personalizados.

### Creación de una correlación entre registros y tablas
<a name="v10-explore-corr-logs-to-table"></a>

En este ejemplo, creará una correlación para demostrar cómo utilizar las transformaciones para extraer valores de la línea de registro y de otro campo.

Para seguir este ejemplo, asegúrese de haber configurado un [origen de datos de prueba](testdata-data-source.md).

**Creación de una correlación entre registros y tablas**

1. En Grafana, vaya a **Explore**.

1. Seleccione el **origen de datos de prueba** en el menú desplegable de la parte superior izquierda de la página.

1. Seleccione **\$1 Agregar** en el menú desplegable de la derecha y seleccione **Agregar correlación**.

1. Explore se encuentra ahora en el modo Editor de correlaciones, indicado por un borde azul.

1. En el menú **Escenario**, seleccione **Registros**.

1. Amplíe una línea de registro para ver los enlaces de correlación. Seleccione `Correlate with hostname`.

1. Explore se abre en una vista dividida. Seleccione el mismo origen de datos que ha seleccionado en el panel izquierdo. El asistente situado encima del editor de consultas contiene todas las variables disponibles que puede utilizar en la consulta de destino.

1. Amplíe la sección de transformaciones y haga clic en **Agregar transformación**.

1. En el menú desplegable **Campo**, seleccione **Mensaje**. La línea de registro se muestra como datos de ejemplo.

1. En **Tipo**, seleccione **Logfmt**. Esto rellena la lista de variables.

1. Elija **Agregar transformación a la correlación**.

1. Vuelva a seleccionar **Agregar transformación** y, en **Campo**, seleccione el **nombre del servidor**.

1. En **Tipo**, seleccione **Expresión regular**.

1. En **Expresión**, ingrese lo siguiente: `-([0-9]\*)`. Esto selecciona cualquier número a la derecha del guion.

1. En **Nombre de la variable**, ingrese lo siguiente: `hostNumber`. Esto rellena la lista de variables. 

1. Elija **Agregar transformación a la correlación** para agregarla a las demás variables.

1. En el editor de orígenes de datos, abra el menú desplegable **Escenario** y seleccione **Contenido CSV**.

1. En el cuadro de texto siguiente, proporcione lo siguiente y guarde la correlación:

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   De este modo, se cierra la vista dividida y se vuelve a ejecutar la consulta de la izquierda. Amplíe cualquier línea de registro para ver el botón de correlación. Al seleccionar el botón de correlación, se abre la vista dividida con `time` (un campo), `msg` (extraído con *logfmt* de la línea de registro), `host number` (extraído con *expresiones regulares* de `hostname`) y `status` (extraído con *logfmt* de la línea de registro).