Ver detalles de trazas

Stackdriver Trace muestra los detalles de una traza en la vista de detalles. En esta vista se muestra un resumen de los detalles de la petición, una cronología gráfica con el intervalo raíz de la petición y los subintervalos de llamadas a procedimiento remoto (RPC), así como una vista detallada de los datos de latencia recopilados para los intervalos.

Detalles de trazas

Para ver los detalles de una traza, haz lo siguiente:

  1. Accede a la lista de trazas en Stackdriver > Traza > Lista de trazas en la consola de Google Cloud Platform o haz clic en el botón siguiente:

    Ir a la página Lista de trazas

    Para obtener más información sobre cómo buscar trazas, consulta la sección sobre cómo buscar trazas.

  2. En la lista de seguimiento, haz clic en cualquier URI de petición. Los detalles de las trazas son los siguientes:

    Detalles de Stackdriver Trace

Resumen de peticiones

En el panel de la derecha, en la vista de detalles de traza, se incluye un resumen y los detalles de esta petición. Los detalles aportan la siguiente información:

Propiedad Descripción
Marca de tiempo La hora a la que la aplicación recibió la petición entrante.
Tiempo trazado El tiempo acumulado que se tardó en completar todas las llamadas de RPC.
Tiempo no trazado Tiempo durante el que no se hicieron llamadas de RPC (es decir, el tiempo empleado de forma local en la aplicación). Cuando es más tiempo que el habitual al comienzo de una petición suele deberse a la creación de una instancia nueva para manejar la carga.
Registro Enlace a las entradas de registro asociadas.
Informe Enlace a los detalles de informe de análisis asociados.
Servicio El servicio App Engine que ha manejado la petición. Consulta la documentación sobre Java, Python, Go y PHP.
Versión La versión de la aplicación de App Engine que ha manejado la petición.
Método HTTP El método HTTP de la petición.
Código de estado El estado HTTP que la petición ha devuelto.

Entradas de registro

Stackdriver Trace asocia los registros con trazas mediante anotaciones en las entradas de registro. La aplicación estándar de App Engine asocia de forma automática sus entradas de registro con trazas, pero no lo hacen todos los servicios.

Si utilizas el SDK de Trace, tendrás la opción de insertar anotaciones en una entrada de registro mediante el establecimiento del campo trace del objeto LogEntry en un ID de traza según el formato siguiente:

projects/[PROJECT-ID]/traces/[TRACE-ID]

También puedes asociar una entrada de registro con un intervalo de traza específico. Para ello, establece el campo span_id de LogEntry en la codificación hexadecimal de 16 caracteres del ID del intervalo. Por ejemplo, un intervalo con un ID de "74" se representaría como "000000000000004a".

En la vista de detalles de traza en la consola de GCP, existen varias maneras de buscar entradas de registro:

  • Haz clic en el botón Mostrar registros en el panel Cronología para que se muestren las entradas de registro junto con la traza. Este botón está disponible cuando existen entradas de registro asociadas a la traza.

  • Haz clic en el enlace para ver el registro situado en el panel Resumen para abrir una ventana de Stackdriver Logging donde podrás ver las entradas de registro asociadas a la traza. Si no hubiera ninguna de estas entradas, la ventana se mostrará vacía.

  • Haz clic en el enlace para ver el registro de VM situado en el panel Resumen, que existe para las trazas que el balanceador de carga de Cloud ha generado. Se abrirá una ventana de Stackdriver Logging con los registros de la instancia de VM que han servido la petición. La vista de esta ventana tiene la misma duración que la marca de tiempo de la traza.

Permisos obligatorios

Para ver entradas de registro, debes tener el permiso logging.logEntries.list en el proyecto. Este permiso lo proporcionan las funciones de la gestión de identidades y accesos de visualizador de registros de Logging y visualizador de proyectos.

Para ver los registros de instancia de VM, debes tener el permiso compute.instances.get en el proyecto. Este permiso lo proporcionan las funciones de la gestión de identidades y accesos de visualizador de redes de Compute Engine y visualizador de proyectos.

Para obtener más información sobre la visualización de entradas de registros en Stackdriver Logging, consulta la sección sobre el visualizador de registros.

Anotaciones de intervalos y eventos de mensaje (beta)

Con Stackdriver Trace API v2 se pueden escribir anotaciones de intervalo y eventos de mensaje. Si está presente, se muestran en la cronología de traza. Al igual que con los intervalos y las entradas de registro, puedes seleccionar una anotación o evento de mensaje para ver todos sus detalles en el panel de detalles de la derecha.

Para obtener más información, consulta el objeto TimeEvents en la sección Stackdriver Trace API v2.

Cronología

La cronología es una representación gráfica de los datos de latencia de la petición. Muestra un intervalo raíz que representa el tiempo que tardó la aplicación en procesar por completo la petición, así como los subintervalos que representan el tiempo que se tardó en completar las llamadas de RPC realizadas durante el manejo de la petición.

Puedes hacer clic en cualquier intervalo de la cronología para ver sus detalles. Las relaciones de dependencia del intervalo seleccionado y sus subintervalos se muestran en la cronología y los datos adicionales que se notifican a Stackdriver Trace durante el tiempo de ejecución de la aplicación se muestran en el panel de la derecha.

Para el intervalo raíz, Stackdriver Trace muestra las propiedades siguientes:

Propiedad Descripción
Nombre URL relativa de la petición. Se muestra en la etiqueta del intervalo.
Latencia Tiempo que ha tardado la aplicación en manejar por completo la petición. Se muestra en la etiqueta del intervalo.
gae/request_log_id ID de petición interno de App Engine. Se muestra en el panel de detalles debajo de la cronología.
http/host Nombre del host donde se ejecuta la aplicación. Se muestra en el panel de detalles debajo de la cronología.
http/response/size Número de bytes en el cuerpo de respuesta HTTP. Se muestra en el panel de detalles debajo de la cronología.
http/url URL relativa de la petición. Se muestra en el panel de detalles debajo de la cronología.

La información que se muestra de los subintervalos varía según la llamada de RPC. Sin embargo, Stackdriver Trace siempre muestra lo siguiente:

Propiedad Descripción
Nombre Nombre de la llamada RPC en el formato service_name.call_name (por ejemplo, datastore_v3.RunQuery). Se muestra en la etiqueta del intervalo. Note: el nombre de la llamada es uno interno de App Engine y puede que no sea exactamente igual que el nombre de la llamada en la API de servicio específica del lenguaje.
Latencia El tiempo que se ha tardado en completar la llamada a procedimiento remoto (RPC) de ida y vuelta. Se muestra en la etiqueta del intervalo.

Datos

Los datos informativos sobre el rendimiento de la petición se mostrarán debajo de la cronología, si están disponibles.

Para obtener más información, consulta la sección sobre datos de rendimiento.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Stackdriver Trace