Editor de correlaciones en Explore

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

Las correlaciones permiten a los usuarios crear un enlace entre dos fuentes de datos. Para obtener más información, incluida una descripción general de las correlaciones, consulte. Correlaciones en Grafana versión 10

Crear una correlación

Puede crear correlaciones desde la página Explorar.

Para crear una correlación

1. En tu espacio de trabajo de Grafana gestionado por Amazon, ve a la página Explorar.

2. Seleccione una fuente de datos que desee que sirva de fuente para una nueva correlación.

3. Ejecute una consulta que genere datos en una visualización compatible.

   nota

   Las visualizaciones compatibles son los registros y las tablas.

4. Elija + Añadir en la barra de herramientas superior y seleccione Añadir correlación (también puede seleccionar el Editor de correlaciones en la paleta de comandos).

   Explore está ahora en el modo de editor de correlaciones, indicado por un borde azul y una barra superior. Puede salir del Editor de correlaciones seleccionando Salir en la barra superior.

5. 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.

6. Elija un enlace para añadir 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.

7. En la vista dividida que se abre, utilice el panel derecho para configurar la fuente de consulta de destino de la correlación. Para obtener más información, consulte Consulta de destino.

8. Cree una consulta de destino utilizando la sintaxis de variables 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.

9. 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.

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

11. 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

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, consulteTransformaciones de correlación.

Tras elegir uno de los enlaces generados en el modo editor, puede añadir transformaciones seleccionando Añadir transformación en el menú desplegable Transformaciones.

Para usar una transformación en una correlación

1. Seleccione un campo al que aplicar la transformación. Seleccione la parte del campo que desee usar 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.

2. Seleccione el tipo de transformación. Consulte Transformaciones de correlación las opciones y los ajustes pertinentes.

3. 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.

4. Seleccione Añadir transformación a la correlación para añadir las variables especificadas a la lista de variables disponibles.

nota

En el caso de las expresiones regulares de este cuadro de diálogo, Variable Name aquí mapValue se denomina a las que se hace referencia en otros documentos. 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 Variable Name campo.

Ejemplos de correlaciones

Los siguientes ejemplos muestran cómo crear correlaciones con el editor de correlaciones de Explore. Si desea seguir estos ejemplos, asegúrese de configurar una fuente de datos de prueba.

Crear una correlación entre texto y gráfico

En este ejemplo, se muestra cómo crear una correlación mediante el editor de correlaciones de Explore.

Las correlaciones permiten usar los resultados de una consulta para ejecutar una nueva consulta en cualquier fuente 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 una fuente de datos de prueba.

Para crear una correlación entre texto y gráfico

1. En Grafana, navega hasta Explorar.

2. Seleccione la fuente de datos de prueba en el menú desplegable de la parte superior izquierda de la página.

3. Selecciona + Añadir en el menú desplegable de la derecha y selecciona Añadir correlación.

4. Explore está ahora en el modo Editor de correlaciones, indicado por un borde azul.

5. Seleccione el siguiente escenario en el menú desplegable del escenario: Archivo CSV.

6. Seleccione el archivo population_by_state.csv. Cada celda es un enlace en el que puede hacer clic para empezar a crear una nueva correlación.

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

8. En la vista dividida, seleccione la misma fuente de datos que seleccionó 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.

9. En el menú Escenario, seleccione Valores métricos CSV. El String Input campo 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.

10. En el campo Alias del editor de consultas, introduzca${State}.

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

11. Elija Guardar para guardar la correlación y salir del 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 fuente 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 la misma fuente de datos. Sin embargo, puede crear correlaciones entre cualquier fuente de datos para crear flujos de exploración personalizados.

Crear una correlación entre registros y tablas

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 una fuente de datos de prueba.

Para crear una correlación entre registros y tablas

1. En Grafana, navega hasta Explorar.

2. Seleccione la fuente de datos de prueba en el menú desplegable de la parte superior izquierda de la página.

3. Selecciona + Añadir en el menú desplegable de la derecha y selecciona Añadir correlación.

4. Explore está ahora en el modo Editor de correlaciones, indicado por un borde azul.

5. En el menú Escenario, seleccione Registros.

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

7. Explore se abre en una vista dividida. Seleccione la misma fuente de datos que seleccionó 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.

8. Amplíe la sección de transformaciones y haga clic en Añadir transformación.

9. En el menú desplegable Campo, selecciona mensaje. La línea de registro se muestra como datos de ejemplo.

10. En Tipo, selecciona Logfmt. Esto rellena la lista de variables.

11. Elija Añadir transformación a la correlación.

12. Vuelva a elegir Añadir transformación y, en Campo, seleccione el nombre del servidor.

13. En Tipo, selecciona Expresión regular.

14. En Expresión, introduzca lo siguiente:-([0-9]\*). Esto selecciona cualquier número a la derecha del guión.

15. En Nombre de la variable, introduzca lo siguiente:hostNumber. Esto rellena la lista de variables.

16. Elija Añadir transformación a la correlación para añadirla a las demás variables.

17. En el editor de fuentes de datos, abra el menú desplegable Escenario y seleccione Contenido CSV.

18. 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) y el (extraído con logfmt de la status línea de registrohostname).