Ver detalles de seguimiento

Si seleccionas un seguimiento, Cloud Trace mostrará los detalles de un seguimiento en la página Lista de seguimiento. Esta vista muestra un resumen de los detalles de la solicitud, un cronograma gráfico que presenta el intervalo raíz de la solicitud y los subintervalos de las llamadas RPC, y una vista detallada de los datos de latencia recopilados para los intervalos.

Ver detalles de seguimiento

  1. En Google Cloud Console, ve a la página Lista de seguimiento:

    Ir a la Lista de Trace

  2. Existen varias formas de mostrar información detallada sobre un seguimiento:

    • Haz clic en el URI que se enumera en la tabla.
    • Haz clic en el punto del gráfico.
    • En la vista Detalles de seguimiento seleccionados, ingresa el ID de seguimiento en formato hexadecimal. Si ingresas un ID de seguimiento, es posible que veas un mensaje Selected trace may not match current filters o Selected trace is outside the current time range. Estos mensajes informativos indican que el seguimiento que se muestra no coincide con los filtros o con la configuración del intervalo de tiempo.

Panel de detalles de seguimiento seleccionado

Si eliges un seguimiento para examinar, se mostrarán los detalles sobre el seguimiento seleccionado:

  • El cuadro de texto Detalles de seguimiento seleccionados muestra el identificador de ese seguimiento.

  • Un panel muestra una representación gráfica de los datos de latencia para la solicitud mediante un grafo en cascada. De forma predeterminada, el intervalo raíz del seguimiento seleccionado se destaca.

  • Se muestra un panel en una serie de tablas con información detallada sobre el intervalo destacado en el grafo de cascada.

Estos campos se actualizan con datos nuevos cada vez que seleccionas un seguimiento para examinarlo. En la siguiente captura de pantalla, se muestran estos subpaneles:

Panel de detalles de Cloud Trace.

Grafo de la cascada

Cada fila del gráfico de cascada corresponde a un intervalo en el seguimiento:

  • Si se muestra el símbolo , significa que Cloud Trace detectó un intervalo cuya hora de inicio es anterior a la del superior del intervalo. Cloud Trace compensa automáticamente esta inconsistencia cuando muestra el intervalo. Sin embargo, los datos del intervalo no se modifican.

    La inconsistencia de la marca de tiempo puede ocurrir cuando un servicio se basa en varias fuentes de reloj o en bibliotecas de idiomas diferentes.

  • Si se muestra el símbolo , eso indica que el intervalo contiene un error HTTP.

  • El nombre de la llamada RPC en el formato service_name.call_name. Por ejemplo, datastore_v3.RunQuery.

    Para el entorno estándar de App Engine, es posible que el nombre interno que se informa aquí no coincida con el de una API de servicio específica del idioma.

  • El tiempo que llevó realizar la llamada RPC completa.

Casilla de verificación Mostrar eventos

Si marcas Show events (Mostrar eventos), el gráfico de cascada se vuelve a dibujar y las anotaciones de evento se incluyen como filas en el grafo. Para obtener más información sobre las anotaciones, consulta Anota intervalos.

Haz clic para copiar

Puedes copiar la URL de la vista detallada para un seguimiento específico en el portapapeles. Para ello, haz clic en Copy .

Tablas con detalles del intervalo

Estas tablas contienen información detallada sobre la fila que se destaca actualmente en el gráfico de cascada. Cada fila del gráfico de cascada corresponde a un intervalo de seguimiento.

Si destacas una fila, los detalles para ese intervalo incluyen su nombre del URI, y la hora de inicio relativa y el nombre de la llamada RPC.

Los datos que se muestran en las tablas varían según el elemento destacado. Sin embargo, siempre se muestran los datos enumerados en la siguiente tabla:

Propiedad Descripción
Hora de inicio relativa La primera entrada es la hora de inicio relativa del intervalo.

Para los intervalos raíz, este valor es siempre @0 ms.

Para los subintervalos, esta es la hora en la que el intervalo comenzó en relación con el inicio de la solicitud. Es decir, este valor muestra el tiempo que lleva desde el inicio de la solicitud general para que se inicie esta llamada RPC.
Nombre La siguiente entrada es el nombre de la llamada RPC. Los nombres tienen el formato service_name.call_name. Por ejemplo:datastore_v3.RunQuery

Para el entorno estándar de App Engine, es posible que el nombre interno que se informa aquí no coincida con el de una API de servicio específica del idioma.

Si se destaca un intervalo raíz y la solicitud es una solicitud HTTP, se muestra una tabla llamada Resumen. En la tabla, hay una fila para el intervalo raíz y una fila para cada RPC:

Columna
de la tabla de resumen
Descripción
Nombre Nombre de la llamada RPC en formato service_name.call_name. Se muestra en la etiqueta del intervalo.
RPC Esta es la cantidad de veces que se llamó al procedimiento.
Duración total El tiempo total dedicado a realizar las RPC.

La tabla con el título Detalle enumera los metadatos del intervalo. Las propiedades siguientes siempre se muestran:

Propiedad
de la tabla de detalles
Descripción
Marca de tiempo La hora en la que la aplicación recibió la solicitud entrante.
Registro Vínculo a una entrada de registro si hay datos de registro disponibles. Si los datos de registro no están disponibles, se omite esta fila.
Informe Un vínculo al informe de análisis más reciente que incluye este seguimiento. Si ningún informe incluye este seguimiento, se omite esta fila.
ID de seguimiento Para ver este campo, haz clic en el menú Detalles .

El identificador único global para el seguimiento. Este identificador es una forma numérica de 128 bits representada como una string hexadecimal de 32 bytes. Para obtener detalles, consulta Resource: Trace.

ID de intervalo Para ver este campo, haz clic en el menú Detalles .

El identificador del intervalo. Este identificador es un número entero de 64 bits distinto de 0. Para obtener detalles, consulta TraceSpan.

Contenedor de GKE

Cuando se muestra esta tabla, el intervalo contiene etiquetas canónicas para un contenedor de GKE. Cada fila de la tabla corresponde a una etiqueta específica y el valor es un vínculo que puedes usar para ver información sobre el recurso con más detalle. Para obtener información detallada sobre todas las etiquetas, consulta Etiquetas de seguimiento.

Las etiquetas y su significado se enumeran en la siguiente tabla:

Etiqueta Valor
Project ID El proyecto de Google Cloud que aloja el clúster de GKE. Haz clic en el nombre del proyecto para ir al panel de GKE en Google Cloud Console.
Cluster Name Identifica el clúster de GKE. Para ir a la página de configuración de Clústeres, haz clic en este valor.
Namespace Identifica el espacio de nombres. Para ir a la página de Cargas de trabajo de GKE, haz clic en este valor.
Pod Name Identifica el pod de GKE. Para ir al panel Detalles de los pods, haz clic en este valor.
Container Name Identifica el contenedor de GKE. Para ir a la página de detalles del contenedor, haz clic en este valor.
Etiquetas Una tabla de etiquetas y valores en la solicitud. Las etiquetas son específicas de la aplicación. Para obtener información detallada sobre todas las etiquetas, consulta Etiquetas de seguimiento.

En la siguiente tabla, se enumeran algunas etiquetas comunes y su significado:

Etiqueta Valor
http/host Nombre del host en el que se ejecuta la aplicación.
http/response/size Cantidad de bytes en el cuerpo de respuesta HTTP.
http/url URL relativa de la solicitud.
gae/request_log_id ID de la solicitud interna de App Engine.

Pueden aparecer propiedades adicionales cuando tu tipo de solicitud es HTTP o cuando tu aplicación se ejecuta en App Engine. En la siguiente tabla, se muestra una lista parcial de algunas propiedades que se suelen observar:

Propiedad Descripción
Tiempo trazado (Solo HTTP) El tiempo total que llevó completar todas las llamadas RPC.
Tiempo sin seguimiento (Solo HTTP) El momento en que no se realizó ninguna llamada RPC. Es decir, esto mide el tiempo empleado localmente en la aplicación. Ten en cuenta que un tiempo sin seguimiento más largo de lo normal al principio de una solicitud a menudo puede causar la creación de una nueva instancia para manejar la carga.
Método HTTP El método HTTP para la solicitud (solo HTTP).
Servicio (Solo App Engine) El servicio de App Engine que manejó la solicitud. Para obtener más información, ve a App Engine.
Versión La versión de la aplicación que controló la solicitud (solo para App Engine).

Si destacas un evento, se mostrarán los detalles del evento en el panel de detalles. De forma predeterminada, los eventos no se muestran en el gráfico de cascada. Para incluirlas en el gráfico de cascada, haz clic en Mostrar eventos.

Insights

Las estadísticas sobre el rendimiento de la solicitud se muestran debajo del cronograma, cuando están disponibles.

Para obtener más información, consulta Estadísticas.

Anota intervalos

Puedes anotar un seguimiento mediante la API de Cloud Trace v1 o la API de Cloud Trace v2. En esta sección, se describen las distintas opciones disponibles para ti.

Para asociar un seguimiento a un objeto LogEntry de Cloud Logging, debes usar anotaciones. Para obtener más información sobre la integración entre Cloud Trace y Cloud Logging, consulta Integración con Cloud Logging.

Anota con etiquetas

Puedes agregar anotaciones a los intervalos si creas un objeto labels y lo conectas al objeto TraceSpan cuando usas la API de Cloud Trace v1 patchTraces.

Estas anotaciones se muestran como etiquetas cuando ves los detalles de un seguimiento. Para obtener más información sobre las etiquetas, consulta Etiquetas de seguimiento.

Anota con atributos

Para anotar los intervalos, crea un objeto attributes y adjúntalo al objeto Span cuando uses la API de Cloud Trace v2 batchWrite.

Estas anotaciones se muestran como etiquetas cuando ves los detalles de un seguimiento. Para obtener más detalles, visita Ve los detalles de seguimiento en esta página.

Anota con eventos de tiempo

Puedes agregar anotaciones y eventos de mensaje a los intervalos si creas un objeto TimeEvents y lo adjuntas al objeto Intervalo cuando usas la API de Cloud Trace v2 batchWrite.

El objeto TimeEvents es un arreglo de objetos TimeEvent, y cada uno contiene un evento de mensaje y una anotación.

Para ver el TimeEvents de un seguimiento, ve al gráfico de cascada de los seguimientos y haz clic en Show events (Mostrar eventos). Si seleccionas un TimeEvent, se muestran sus detalles en el panel de detalles.

Qué sigue