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.
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.
Creación de una correlación
Puede crear correlaciones desde la página de Explore.
Creación de una correlación
-
En el espacio de trabajo de Amazon Managed Grafana, vaya a la página de Explore.
-
Seleccione un origen de datos que desee que sirva de origen para una nueva correlación.
-
Ejecute una consulta que genere datos en una visualización compatible.
-
Elija + 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).
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.
-
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.
-
-
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, consulta Configuración de correlación.
-
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, consulta Consulta de destino.
-
Para crear una consulta de destino, utilice 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.
-
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.
-
Proporcione transformaciones (opcional; consulte los detalles a continuación).
-
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, consulte Transformación de correlaciones.
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
-
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.
-
Seleccione el tipo de transformación. Consulte Transformación de correlaciones para ver las opciones y los ajustes pertinentes.
-
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.
-
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
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.
Creación de una correlación entre texto y gráfico
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.
Creación de una correlación entre texto y gráfico
-
En Grafana, vaya a Explore.
-
Seleccione el origen de datos de prueba en el menú desplegable de la parte superior izquierda de la página.
-
Seleccione + Agregar en el menú desplegable de la derecha y seleccione Agregar correlación.
-
Explore se encuentra ahora en el modo Editor de correlaciones, indicado por un borde azul.
-
Seleccione el siguiente escenario en el menú desplegable del escenario: archivo CSV.
-
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.
-
Haga clic en cualquier celda de la columna
Statepara crear una nueva correlación que adjunte un enlace de datos a esa entrada. Por ejemplo, seleccioneCalifornia. -
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.
-
En el menú Escenario, seleccione Valores de métricas en CSV. El campo
String Inputdel 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. -
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.
-
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
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.
Creación de una correlación entre registros y tablas
-
En Grafana, vaya a Explore.
-
Seleccione el origen de datos de prueba en el menú desplegable de la parte superior izquierda de la página.
-
Seleccione + Agregar en el menú desplegable de la derecha y seleccione Agregar correlación.
-
Explore se encuentra ahora en el modo Editor de correlaciones, indicado por un borde azul.
-
En el menú Escenario, seleccione Registros.
-
Amplíe una línea de registro para ver los enlaces de correlación. Seleccione
Correlate with hostname. -
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.
-
Amplíe la sección de transformaciones y haga clic en Agregar transformación.
-
En el menú desplegable Campo, seleccione Mensaje. La línea de registro se muestra como datos de ejemplo.
-
En Tipo, seleccione Logfmt. Esto rellena la lista de variables.
-
Elija Agregar transformación a la correlación.
-
Vuelva a seleccionar Agregar transformación y, en Campo, seleccione el nombre del servidor.
-
En Tipo, seleccione Expresión regular.
-
En Expresión, ingrese lo siguiente:
-([0-9]\*). Esto selecciona cualquier número a la derecha del guion. -
En Nombre de la variable, ingrese lo siguiente:
hostNumber. Esto rellena la lista de variables. -
Elija Agregar transformación a la correlación para agregarla a las demás variables.
-
En el editor de orígenes de datos, abra el menú desplegable Escenario y seleccione Contenido CSV.
-
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 dehostname) ystatus(extraído con logfmt de la línea de registro).
