Cómo buscar y explorar seguimientos

Para buscar y explorar seguimientos individuales en detalle, usa la página Explorador de seguimiento. En esta página, se muestran los seguimientos para los que tu proyecto de Google Cloud almacena al menos un intervalo. Los datos que se muestran para cada intervalo y seguimiento mostrados incluyen información de resumen, como la latencia y el tipo de comando, además de información detallada. La información detallada incluye registros, eventos y otra información.

La página del Explorador de seguimiento muestra un máximo de 1,000 seguimientos.

Antes de comenzar

Si quieres obtener los permisos que necesitas para ver los datos de seguimiento con la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de IAM Usuario de Cloud Trace (roles/cloudtrace.user) en tu proyecto. Si quieres obtener más información para otorgar funciones, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Para obtener más información sobre las funciones, consulta Controla el acceso con Identity and Access Management.

Cómo mostrar seguimientos recientes

Para mostrar los seguimientos más recientes, haz lo siguiente:

En el panel de navegación de la consola de Google Cloud, selecciona Trace y, luego, Explorador de seguimiento:
Ve al Explorador de seguimiento

Si es la primera vez que usas Trace, es posible que los seguimientos tarden unos minutos en aparecer. En la siguiente captura de pantalla, se muestra un ejemplo de la página del Explorador de seguimiento:

El diagrama de dispersión muestra un punto para cada solicitud en el intervalo de tiempo seleccionado:
- Las coordenadas (x,y) de una solicitud corresponden a la hora y la latencia de esta.
- La información de errores está codificada con el color de un punto. El color azul indica el éxito y el rojo indica el error. En la captura de pantalla anterior, la mayoría de los comandos se completaron correctamente.
- La información sobre la herramienta que se activa cuando mantienes el puntero sobre un punto muestra la fecha, la hora, el URI y la latencia:
Opcional: Para filtrar los seguimientos y los intervalos que se muestran, realiza una de las siguientes acciones:
- Filtrar por hora. De forma predeterminada, se muestra la hora de datos más reciente. Para ver un intervalo de tiempo personalizado, haz lo siguiente:
  1. Selecciona una opción predeterminada que sea más larga que el intervalo de tiempo personalizado.
  2. Coloca el puntero en el gráfico Selecciona un seguimiento en un extremo del intervalo de tiempo y arrastra el puntero de forma horizontal hasta el otro extremo del intervalo.
  Para restablecer el gráfico al intervalo de tiempo predeterminado, haz clic en Restablecer.
- Filtra por latencia. De forma predeterminada, se muestran todos los seguimientos del intervalo de tiempo seleccionado. Para limitar la visualización a los seguimientos cuya latencia se encuentra dentro de un intervalo, coloca el puntero en un extremo del valor de latencia y arrástralo de manera vertical hasta el otro extremo.
  
  Para restablecer el gráfico al intervalo de tiempo predeterminado, haz clic en Restablecer.
- Haz clic en Agregar filtro de seguimiento, selecciona una opción de filtro y, luego, selecciona o ingresa un valor de filtro. Si agregas varios filtros, solo se mostrarán los seguimientos que cumplan con todos los filtros. Por ejemplo, para mostrar todos los seguimientos que contienen un comando HTTP GET y cuya latencia es de al menos 2 segundos, agrega los filtros Method: GET y MinLatency: 2000.
  
  Las siguientes opciones de filtro siempre están disponibles:
  - RootSpan: Coincide con el nombre del intervalo raíz.
  - SpanName: Coincide con el nombre del intervalo.
  - Método: Muestra seguimientos cuyos intervalos raíz están anotados con la etiqueta /http/method, en la que el valor de la etiqueta coincide con el valor del filtro.
  - Estado: Muestra seguimientos cuyos intervalos raíz están anotados con la etiqueta /http/status_code, en la que la etiqueta de valor coincide con el valor del filtro. El valor del filtro puede contener códigos de estado específicos, como 301, o rangos de valores de estado, como 3xx.
  - MinLatency: Se muestran los seguimientos de una latencia que es al menos tan grande como el valor del filtro. El valor del filtro debe expresarse en milisegundos.
  - HasLabel: Muestra seguimientos en los que la etiqueta especificada por el valor de filtro aparece en al menos un intervalo.
  - Servicio: Muestra seguimientos que contienen al menos un intervalo cuyo nombre de servicio coincide con el valor del filtro.
    
    El nombre del servicio de un intervalo se extrae del atributo service.name de OpenTelemetry, cuando se establece ese atributo. Si ese atributo no está configurado y el servicio se ejecuta en App Engine, se muestra el nombre del servicio de App Engine. De lo contrario, no se especificará el servicio.
  - Versión: (solo en App Engine) Muestra seguimientos que contienen al menos un intervalo cuya versión de la aplicación coincide con el valor del filtro.
  Es posible que veas otras opciones de filtro, como URL o etiquetas HTTP. Si tienes una etiqueta definida por el usuario que coincide con un filtro predefinido, esta etiqueta tiene el prefijo LABEL para que puedas distinguir entre ambas. Por ejemplo, si creas una etiqueta Service, verás Service y LABEL:Service en el menú de filtro.
  
  Nota: Para establecer una concordancia exacta, antepone un signo más (+) al valor del filtro. Si omites el signo más, se determina una coincidencia mediante una prueba de prefijo con el valor del filtro. Para obtener más detalles sobre las opciones de filtrado, consulta Filtros de seguimiento.

Cómo buscar un seguimiento por ID

Cuando estés solucionando un incidente o una falla, es posible que conozcas el ID de seguimiento. Para explorar ese seguimiento, haz lo siguiente:

En el panel de navegación de la consola de Google Cloud, selecciona Trace y, luego, Explorador de seguimiento:
Ve al Explorador de seguimiento
Selecciona un proyecto de Google Cloud desde el cual ver los datos de seguimiento.

Debes seleccionar el proyecto de Google Cloud que almacena los datos de seguimiento, a menos que el proyecto forme parte de una organización. Cuando un proyecto es parte de una organización, puedes configurar el seguimiento entre proyectos, que te permite ver los datos de seguimiento de cualquier proyecto de la organización. Para obtener más información, consulta Cómo ver el seguimiento en todos los proyectos.
Ingresa el ID en el campo ID de seguimiento.

Cuando ingresas un ID válido, el panel Detalles de seguimiento se propaga con información sobre el seguimiento y sus intervalos. Puedes usar las opciones de ese panel para explorar el seguimiento.

Cómo explorar un seguimiento

Para explorar un seguimiento, haz clic en un punto del diagrama de dispersión. Cuando haces clic en un punto en el diagrama de dispersión, se producen los siguientes cambios en la página del Explorador de seguimiento:

El diagrama de dispersión se actualiza y el punto que seleccionaste se destaca con un círculo dibujado a su alrededor. Los puntos que representan todos los demás seguimientos aparecen atenuados.
En el panel Detalles de seguimiento, se muestra lo siguiente:
- Es el identificador de seguimiento. Este identificador único a nivel global para el seguimiento es un número entero de 128 bits representado como una cadena hexadecimal de 32 bytes. Para obtener información detallada, consulta Resource: Trace.
- Una línea de resumen que enumera la hora de inicio, la duración y la cantidad de intervalos.
- Un menú de Registros y eventos La selección del menú controla cómo se muestran los registros y eventos. De forma predeterminada, cuando existe un registro o un evento, se agrega un círculo al intervalo de seguimiento. Los círculos superpuestos indican que el intervalo tiene varios registros o eventos. Para mostrar cada registro o evento como una fila en la tabla, expande Registros y eventos y selecciona Mostrar expandido.
- Una tabla. La primera fila de la tabla es para el seguimiento. Se agrega una fila por cada intervalo del seguimiento.
  
  En el caso de los intervalos, la tabla incluye el nombre del intervalo y el servicio asociado a ellos. El nombre del servicio se extrae del atributo service.name de OpenTelemetry, cuando se configura ese atributo. Si ese atributo no está configurado y el servicio se ejecuta en App Engine, se muestra el nombre del servicio de App Engine. De lo contrario, no se especificará el servicio.
  
  La columna Latency (Latencia) proporciona una representación visual de la latencia, el estado y, cuando está presente, las anotaciones de eventos. Una barra de latencia azul indica una finalización exitosa, una barra de latencia roja indica un error. Cada anotación de evento en el espacio se representa con un círculo en la barra de latencia.

A continuación, se muestra un ejemplo de un panel Detalles de seguimiento:

Ejemplos del panel de detalles de Cloud Trace.

Ver los detalles del intervalo

Para ver información detallada sobre el seguimiento o un intervalo específico, en el panel Detalles de seguimiento, haz clic en la barra de latencia de la entrada. Cuando seleccionas la barra de latencia, el panel Detalles de seguimiento se vuelve a dibujar y muestra una tabla con pestañas que proporciona información adicional sobre la entrada.

Si seleccionas la barra de latencia para la primera fila de la tabla, la fila con el nombre ID de seguimiento, entonces la tabla contendrá dos pestañas: Resumen (Summary) y Registros (Logs). En la pestaña Resumen, se muestra información general sobre el seguimiento. Por ejemplo, en el caso de los comandos HTTP, esta pestaña muestra el tipo de comando HTTP, el servicio y la información de latencia para cada intervalo del seguimiento.

Si seleccionas la barra de latencia para otras filas en la tabla, es decir, una fila para un intervalo, la tabla contendrá cuatro pestañas: Attributes, Logs & events, Stacktraces, Metadata & Links:

Para encontrar las etiquetas adjuntas a un intervalo, consulta la pestaña Attributes. Para obtener información sobre las etiquetas, consulta Etiquetas de seguimiento. En la siguiente captura de pantalla, se muestra esta pestaña:

Para ubicar una etiqueta específica o un grupo de etiquetas, agrega un filtro. Por ejemplo, si agregas el filtro Key: g.co, entonces la tabla enumera todas las etiquetas en las que la clave de etiqueta contenga g.co.
Para ver información sobre las entradas de registro y los eventos relacionados, cuando existan, consulta la pestaña Registros y eventos. Para obtener información sobre las anotaciones de eventos, consulta Cómo anotar intervalos de seguimiento. En la siguiente captura de pantalla, se muestra esta pestaña:

Cuando los datos de registro estén disponibles, haz clic en Mostrar más para ver los detalles de una entrada de registro:
Para encontrar información sobre la cantidad de seguimientos de pila disponibles y los detalles sobre un seguimiento de pila capturado, usa la pestaña Seguimientos de pila.
Para encontrar información general sobre el intervalo y una tabla de vínculos a otros intervalos, consulta la pestaña Metadatos y vínculos. Esta información incluye lo siguiente:
- ID de intervalo
  
  El ID de intervalo es un número entero de 64 bits distinto de 0. Para obtener más información, consulta TraceSpan.
- ID principal de intervalo
- ID del proyecto
- Hora de inicio y finalización
- Tabla en la que se enumeran los vínculos a otros intervalos
  
  Cada fila de la tabla llamada Links enumera un vínculo entre el intervalo actual y otro. El campo Attributes enumera los pares clave-valor para el intervalo vinculado. El campo Trace se vincula al seguimiento del intervalo vinculado. Cuando este campo contiene Current trace, el intervalo vinculado está en el mismo seguimiento que el intervalo actual. De lo contrario, el campo contiene un ID de seguimiento. Para obtener información sobre los vínculos, consulta la página de referencia de la API de Links.
En la siguiente captura de pantalla, se muestra esta pestaña: