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 12.x de Grafana, consulte. [Trabajando en Grafana versión 12](using-grafana-v12.md)
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 visualizaciones de rastros le permiten seguir una solicitud a medida que recorre los servicios de su infraestructura. La visualización de rastros muestra los datos de los rastros en un diagrama que le permite interpretarlos fácilmente.
Para obtener más información sobre los rastros y cómo usarlos, consulte la siguiente documentación:
+ [Seguimiento en Explore](v10-explore-tracing.md)
+ [Origen de datos de Tempo](tempo-data-source.md)
+ [Getting started with Tempo](https://grafana.com/docs/tempo/latest/getting-started/) en la *Documentación de Tempo de Grafana Labs*.
## Adición de un panel con visualizaciones de rastros
Cuando tenga los datos de seguimiento disponibles en su pila de Grafana, puede agregar paneles de seguimiento a sus paneles de control de Grafana.
Usar una variable de panel de control, `traceID`, le permite crear una consulta para mostrar rastros específicos de un ID de seguimiento determinado. Para obtener más información acerca de las variables de paneles de control, consulte la [documentación sobre variables](v10-dash-variables.md).
**Requisitos previos**
Antes de comenzar, necesitará:
+ Un espacio de trabajo de Amazon Managed Grafana.
+ Un [origen de datos de Tempo](tempo-data-source.md) conectado a su espacio de trabajo.
Para ver y analizar los datos de los rastros en un panel de control, debe agregar la visualización de rastros 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](v10-panels-editor-overview.md).
Este procedimiento utiliza variables y plantillas de panel de control para que pueda ingresar los ID de seguimiento que luego podrá visualizar. Usará una variable llamada `traceId` y la agregará como consulta plantilla.
**Adición de una consulta de visualización de rastros**
1. En su espacio de trabajo, cree un panel de control nuevo o vaya a uno existente al que quiera agregar las visualizaciones de rastros.
1. Seleccione **Agregar visualización** desde un panel de control nuevo o **Agregar panel** en un panel de control existente.
1. Seleccione el origen de datos de seguimiento adecuado.
1. En la parte superior derecha del editor de paneles, elija la pestaña **Visualizaciones** y seleccione **Rastros**.
1. En **Opciones del panel**, ingrese un **Título** para el panel de seguimiento. Para obtener más información sobre el editor de paneles, consulte [Configuración de opciones del panel](v10-panels-configure-panel-options.md).
1. En el editor de consultas, seleccione la pestaña de tipo de consulta **TraceQL**.
1. Ingrese el `${traceId}` en el campo de consulta TraceQL para crear una variable de panel de control. Esta variable se utiliza como consulta plantilla.
1. Elija **Aplicar** en el editor de paneles para agregar el panel al panel de control.
1. Vaya a **Configuración** del panel de control y agregue una nueva variable llamada `traceId`, de tipo **Personalizado**, y póngale una etiqueta, si es necesario. Elija **Aplicar** para agregar la variable al panel de control.
1. Para comprobar que el panel funciona, use un ID de seguimiento válido para el origen de datos que se usó en el panel de seguimiento y edite el ID en la variable del panel de control.
## Adición de TraceQL con visualizaciones de tablas
Si bien puede agregar una visualización de seguimiento a un panel de control, resulta engorroso tener que agregar manualmente los ID de seguimiento como variable del panel de control. En su lugar, es más útil poder usar las consultas TraceQL para buscar tipos específicos de rastros y luego seleccionar los rastros adecuados a partir de los resultados coincidentes.
**Requisitos previos**
En este procedimiento, se supone que ya ha completado los procedimientos anteriores.
**Adición de TraceQL con visualizaciones de tablas**
1. En el mismo panel en el que agregó la visualización de rastros, elija **Agregar panel** para agregar un nuevo panel de visualización.
1. Seleccione el mismo origen de datos de rastros que usó en la sección anterior.
1. En la parte superior derecha del editor de paneles, seleccione la pestaña **Visualizaciones** y elija **Tabla**.
1. En el editor de consultas, elija la pestaña **TraceQL**.
1. En **Opciones del panel**, ingrese un **Título** para el panel de seguimiento.
1. Agregue una consulta TraceQL adecuada para buscar los rastros que quiera 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 TraceQL como consulta plantilla para aprovechar otras variables del panel de control, 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 rastros incluyen vínculos a la página **Explore** que muestra el seguimiento. Puede agregar otros enlaces a los rastros de la tabla que rellenen la variable `traceId` del panel de control cuando se seleccionan, de modo que el seguimiento se visualice en el mismo panel de control.
Para crear un conjunto de vínculos de datos en el panel, siga este procedimiento.
**Uso de una variable para agregar otros vínculos a los rastros**
1. En el menú de la derecha, en **Vínculos de datos**, seleccione **Agregar vínculo**.
1. Agregue un **Título** para el enlace de datos.
1. Para encontrar la ruta al panel de control, mire la barra de direcciones del navegador cuando se esté renderizando el panel completo. Como se trata de un vínculo a un panel de control de la misma pila de Grafana, solo se requiere la ruta del panel.
Por ejemplo, si su 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 será:
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. En el campo **URL**, haga una autorreferencia al panel de control que contiene ambos paneles. Esta autorreferencia utiliza el valor del rastro seleccionado en la tabla para rellenar la variable del panel de control. Use la ruta del panel de control del paso anterior e ingrese el valor de `traceId` con los resultados seleccionados de la tabla TraceQL. El ID de seguimiento se expone mediante el campo de datos `traceID` 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"]}
```
1. Elija **Guardar** para guardar el vínculo de datos.
1. Elija **Aplicar** en el editor de paneles para aplicar el panel al panel de control.
1. Guarde el panel de control.
Ahora debería ver una lista de rastros coincidentes en la visualización de la tabla. Si selecciona los campos **TraceID** o **SpanID**, tendrá la opción de abrir la página **Exploración** para visualizar el seguimiento o seguir el vínculo de datos. Si selecciona cualquier otro campo (por ejemplo, `Start time`, `Name` o `Duration`), sigue automáticamente el vínculo de datos, rellena la variable del panel de control `traceId` y, a continuación, muestra el seguimiento correspondiente en el panel de rastros.