Si seleccionas un seguimiento, Cloud Trace muestra los detalles de un seguimiento en la página Lista de seguimientos. 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 seguimientos:
Hay dos formas de mostrar información detallada de un seguimiento:
- Haz clic en el URI que se enumera en la tabla.
- Haz clic en el punto en el gráfico.
- En la vista Detalles de seguimiento seleccionado, 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 tus filtros ni la configuración de intervalo de tiempo.
Panel de detalles de seguimiento seleccionado
Si eliges un seguimiento que se examinará, se mostrarán los detalles del seguimiento seleccionado:
El cuadro de texto Detalles del seguimiento seleccionado muestra el identificador de ese seguimiento.
Un panel muestra una representación gráfica de los datos de latencia para la solicitud mediante un gráfico de cascada. De forma predeterminada, se destaca el intervalo raíz del seguimiento seleccionado.
Se muestra un panel en una serie de tablas con información detallada sobre el intervalo destacado en el gráfico de cascada.
Estos campos se actualizan con datos nuevos cada vez que seleccionas un seguimiento para examinar. En la siguiente captura de pantalla, se ilustran estos paneles:
Gráfico de 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 de 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 Mostrar eventos, el gráfico de cascada se vuelve a dibujar y las anotaciones del evento se incluyen como filas en el gráfico. Para obtener más información sobre anotaciones, consulta Cómo anotar 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 Copiar
.
Tablas con detalles de intervalos
Estas tablas contienen información detallada sobre la fila destacada 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 de ese intervalo incluyen su nombre de URI, 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 que se destaca. Sin embargo, siempre se muestran los datos que se muestran 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 siempre es @0 ms.Para los subintervalos, esta es la hora a la que comenzó el subintervalo en relación con el inicio de la solicitud. Es decir, en este valor se muestra el tiempo que tarda esta llamada RPC en iniciarse desde la solicitud general. |
| Nombre | La siguiente entrada es el nombre de la llamada RPC. Los nombres tienen el siguiente 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 lenguaje. |
Si un intervalo raíz está destacado y la solicitud es una solicitud HTTP, se muestra una tabla con el título Summary. 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 nombre_servicio.nombre_llamada. Se muestra en la etiqueta del intervalo. |
| RPC | Indica la cantidad de veces que se llamó al procedimiento. |
| Duración total | El tiempo total dedicado a realizar las RPC. |
En la tabla titulada Detalles, se enumeran los metadatos del intervalo. Siempre se muestran las siguientes propiedades:
| 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 omitirá esta fila. | ||||||||||
| Informe | Corresponde a un vínculo al informe de análisis más reciente que incluye este seguimiento. Si ningún informe incluye este seguimiento, se omitirá esta fila. | ||||||||||
| ID de seguimiento | Para ver este campo, haz clic en el menú keyboard_arrow_down Detalles.
Es el identificador único global del seguimiento. Este identificador es una forma numérica de 128 bits representada como una string hexadecimal de 32 bytes. Para obtener más información, consulta |
||||||||||
| ID de intervalo | Para ver este campo, haz clic en el menú keyboard_arrow_down Detalles.
El identificador del intervalo. Este identificador es un número entero de 64 bits distinto de 0. Para obtener más información, 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 corresponde a un vínculo que puedes usar para ver más información sobre el recurso. Para obtener información detallada sobre todas las etiquetas, consulta Etiquetas canónicas para GKE. |
||||||||||
| Labels | Una tabla de etiquetas y valores en la solicitud.
Las etiquetas son específicas de cada aplicación. Para obtener información detallada sobre todas las etiquetas, consulta Etiquetas de seguimiento.
En la siguiente tabla, se muestran algunas etiquetas comunes y su significado:
|
Es posible que se muestren propiedades adicionales cuando tu tipo de solicitud sea HTTP o cuando tu aplicación se ejecute en App Engine. En la siguiente tabla, se muestra una lista parcial de algunas propiedades observadas con frecuencia:
| Propiedad | Descripción |
|---|---|
| Tiempo trazado | (Solo HTTP) El tiempo total que llevó completar todas las llamadas RPC. |
| Tiempo sin seguimiento | (Solo HTTP) La hora durante la cual no se realizaron llamadas RPC. Es decir, esto mide el tiempo empleado localmente en la aplicación. Ten en cuenta que, a menudo, un tiempo sin seguimiento más prolongado de lo normal al comienzo de una solicitud se puede generar por la creación de una instancia nueva para manejar la carga. |
| Método HTTP | (Solo HTTP) El método HTTP para la solicitud. |
| Service | El servicio de App Engine que manejó la solicitud (solo para App Engine). Para obtener más información, visita App Engine. |
| Versión | La versión de la aplicación que manejó la solicitud (solo para App Engine). |
Si destacas un evento, los detalles del evento se muestran 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 Show events.
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 agregar contenido definido por el usuario a un seguimiento. La API de Cloud Trace v1 te permite agregar etiquetas, mientras que la API de Cloud Trace v2 te permite agregar eventos o atributos de tiempo.
Los eventos de tiempo son más flexibles, ya que te permiten especificar un mensaje, en forma de string, además de un conjunto de atributos.
Cada atributo se representa como un par clave-valor.
Por ejemplo, un atributo puede registrar un identificador de instancia. Para ver ejemplos de atributos, consulta la página de referencia de la API de Attributes.
Anota con etiquetas
Puedes agregar anotaciones a los intervalos si creas un objeto labels y lo adjuntas 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
Puedes anotar intervalos si creas un objeto attributes y lo adjuntas al objeto Span cuando usas 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 array de objetos TimeEvent, cada uno de los cuales contiene un evento de mensaje y una anotación.
Para ver el seguimiento de TimeEvents, ve al gráfico de cascada y haz clic en Mostrar eventos. Si seleccionas un TimeEvent, sus detalles se muestran en el panel de detalles.
Integración en Cloud Logging
El objeto LogEntry de Cloud Logging te permite anotar tus registros con tus datos de seguimiento. Para obtener más información, consulta Integra en Cloud Logging.