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
En Google Cloud Console, ve a la página Lista de seguimiento:
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 filtersoSelected 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:
Grafo de la cascada
Cada fila del gráfico de cascada corresponde a un intervalo en el seguimiento:
Si se muestra el símbolo access_time, 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 error, 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 keyboard_arrow_down. 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 |
||||||||||||
| ID de intervalo | Para ver este campo, haz clic en el menú Detalles keyboard_arrow_down. El identificador del intervalo. Este identificador es un número entero de 64 bits distinto de 0. Para obtener detalles, consulta |
||||||||||||
| 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:
|
||||||||||||
| 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:
|
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.