Rastros - Amazon Managed Grafana
Añadir un panel con visualizaciones de rastreoAñadir TraceQL con visualizaciones de tablas

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.

Rastros

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 visualizaciones de Traces le permiten seguir una solicitud a medida que recorre los servicios de su infraestructura. La visualización de trazas muestra los datos de las trazas en un diagrama que permite interpretarlos fácilmente.

Para obtener más información sobre las trazas y cómo utilizarlas, consulte la siguiente documentación:

Añadir un panel con visualizaciones de rastreo

Una vez que tenga los datos de rastreo disponibles en su pila de Grafana, puede añadir paneles de calco a sus paneles de Grafana.

El uso de una variable de panel te permite crear una consulta para mostrar trazos específicos para un ID de rastreo determinado. traceID Para obtener más información sobre las variables del panel de control, consulte la documentación sobre variables.

Requisitos previos 

Antes de comenzar, necesitará:

  • Un espacio de trabajo de Grafana gestionado por Amazon.

  • Una fuente de datos de Tempo conectada a tu espacio de trabajo.

Para ver y analizar los datos de las trazas en un panel, debe añadir la visualización de las trazas a su panel y definir una consulta mediante el editor de paneles. La consulta determina los datos que se muestran en la visualización. Para obtener más información sobre el editor de paneles, consulte la documentación del editor de paneles.

Este procedimiento utiliza variables y plantillas del panel de control para permitir introducir los identificadores de seguimiento que, a continuación, se pueden visualizar. Utilizará una variable llamada traceId y la agregará como una consulta de plantilla.

Para añadir una consulta de visualización de trazas

  1. En su espacio de trabajo, cree un panel nuevo o vaya a uno existente al que desee añadir visualizaciones de trazos.

  2. Elige Añadir visualización desde un panel nuevo o selecciona Añadir panel en un panel existente.

  3. Seleccione la fuente de datos de rastreo adecuada.

  4. En la parte superior derecha del editor del panel, elija la pestaña Visualizaciones y seleccione Rastros.

  5. En las opciones del panel, introduce un título para el panel de rastreo. Para obtener más información sobre el editor de paneles, consulteConfigurar las opciones del panel.

  6. En el editor de consultas, seleccione la pestaña de tipo de consulta de TraceQL.

  7. Introduzca el ${traceId} campo de consulta de TraceQL para crear una variable de panel. Esta variable se utiliza como consulta de plantilla.

  8. Seleccione Aplicar en el editor de paneles para añadir el panel al panel de mandos.

  9. Vaya a la configuración del panel de control y añada una nueva variable llamadatraceId, de tipo Custom, y póngale una etiqueta, si es necesario. Seleccione Aplicar para añadir la variable al panel de control.

  10. Compruebe que el panel funciona utilizando un identificador de rastreo válido para la fuente de datos utilizada en el panel de seguimiento y editando el identificador en la variable del cuadro de mando.

Añadir TraceQL con visualizaciones de tablas

Si bien puede añadir una visualización de rastreo a un panel, tener que añadir manualmente los ID de seguimiento como variable del panel resulta engorroso. En su lugar, resulta más útil poder utilizar las consultas de TraceQL para buscar tipos específicos de trazas y, a continuación, seleccionar las trazas adecuadas a partir de los resultados coincidentes.

Requisitos previos 

Este procedimiento supone que ha completado el procedimiento anterior.

Para añadir TraceQL con visualizaciones de tablas

  1. En el mismo panel en el que agregó la visualización de trazas, elija Añadir panel para añadir un nuevo panel de visualización.

  2. Seleccione la misma fuente de datos de rastreo que utilizó en la sección anterior.

  3. En la parte superior derecha del editor del panel, seleccione la pestaña Visualizaciones y, a continuación, elija Tabla.

  4. En el editor de consultas, seleccione la pestaña TraceQL.

  5. En las opciones del panel, introduzca un título para el panel de rastreo.

  6. Añada una consulta de TraceQL adecuada para buscar las trazas que desee visualizar en el panel de control. Por ejemplo, esta es una consulta simple y estática desde un servidor llamado my-server.

    { .service.name = "my-server" && .http.status_code=500 }

    Puede escribir la consulta de TraceQL como una consulta de plantilla para aprovechar otras variables del panel, si existen. Esto le permite crear consultas dinámicas basadas en estas variables.

Cuando se devuelven los resultados de una consulta, los resultados se muestran en la tabla del panel.

Los resultados de la visualización de trazos incluyen enlaces a la página de exploración que representa el rastreo. Puede añadir otros enlaces a los rastreos en la tabla que rellenen la variable del traceId panel de control al seleccionarla, de modo que el seguimiento se visualice en el mismo panel.

Para crear un conjunto de enlaces de datos en el panel, utilice el siguiente procedimiento.

Para utilizar una variable para añadir otros enlaces a las trazas

  1. En el menú de la derecha, en Vínculos de datos, selecciona Añadir enlace.

  2. Agrega un título para el enlace de datos.

  3. Busque la ruta al panel de control consultando la barra de direcciones del navegador cuando se esté renderizando el panel completo. Como se trata de un enlace a un panel de control de la misma pila de Grafana, solo se requiere la ruta del panel.

    Por ejemplo, si tu ruta es:

    https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1

    Entonces, la ruta al panel de control es:

    /d/1234abcd5/my-dashboard?orgId=1

  4. En el campo URL, haga una autorreferencia al panel que contiene ambos paneles. Esta autorreferencia utiliza el valor de la traza seleccionada en la tabla para rellenar la variable del cuadro de mando. Utilice la ruta del panel de control del paso anterior y, a continuación, introduzca el valor de traceId utilizar los resultados seleccionados de la tabla de TraceQL. El ID de seguimiento se expone mediante el campo de traceID datos de los resultados devueltos, así que utilícelo como valor para la variable del panel de control. Por ejemplo:

    /d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}

  5. Elija Guardar para guardar el enlace de datos.

  6. Seleccione Aplicar en el editor de paneles para aplicar el panel al panel de mandos.

  7. Guarde el panel de control.

Ahora debería ver una lista de trazas coincidentes en la visualización de la tabla. Si selecciona los campos TraceID o SpaniD, tendrá la opción de abrir la página Explorar para visualizar el rastreo o seguir el enlace de datos. Si selecciona cualquier otro campo (por ejemplo, oDuration)Start time, sigue automáticamente el enlace de datosName, rellena la variable del traceId panel de control y, a continuación, muestra el rastreo correspondiente en el panel de rastreo.