Ver detalles de seguimiento

Stackdriver Trace muestra los detalles de un seguimiento en la vista Detalles 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.

Detalles de seguimiento

Para ver los detalles de un seguimiento, realiza los siguientes pasos:

  1. Ve a la lista de seguimientos en Stackdriver > Seguimiento > Lista de seguimientos en Google Cloud Platform Console, o haz clic en el siguiente botón:

    Ir a la página de Lista de seguimientos

    Para obtener más información sobre la búsqueda de seguimientos, consulta Cómo buscar seguimientos.

  2. En la lista de seguimientos, haz clic en cualquier URI de solicitud. A continuación, se muestran los detalles de seguimiento:

    Detalles de Stackdriver Trace

Resumen de la solicitud

El panel de la derecha de la vista de detalles de seguimiento incluye un resumen y los detalles de la solicitud. En estos últimos, se muestra la siguiente información:

Propiedad Descripción
Marca de tiempo La hora en la que la aplicación recibió la solicitud entrante.
Tiempo de seguimiento El tiempo total que llevó completar todas las llamadas RPC.
Tiempo sin seguimiento El tiempo en que no se registraron llamadas RPC (es decir, el tiempo empleado localmente en la aplicación). Por lo general, los tiempos sin seguimiento más prolongados de lo normal al comienzo de una solicitud se asocian a la creación de instancias nuevas para manejar la carga.
Registro Vínculo a las entradas de registro asociadas.
Informe Vínculo a los detalles del informe de análisis asociado.
Servicio El servicio de App Engine que manejó la solicitud. Consulta la documentación de Java, Python, Go y PHP.
Versión La versión de la aplicación de App Engine que manejó la solicitud.
Método HTTP El método HTTP para la solicitud.
Código de estado El estado HTTP que mostró la solicitud.

Entradas de registro

Stackdriver Trace asocia registros con seguimientos mediante anotaciones en las entradas de registro. App Engine Standard asocia de manera automática las entradas de registro con los seguimientos, pero no todos los servicios lo hacen.

Si usas el SDK de Trace, tienes la opción de anotar una entrada de registro configurando el campo trace del objeto LogEntry en un ID de seguimiento con el siguiente formato:

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

También puedes asociar una entrada de registro con un intervalo de seguimiento específico. Para ello, configura el campo span_id de LogEntry con 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”.

Hay diferentes maneras de buscar entradas de registro desde la vista de detalles de seguimiento de GCP Console:

  • Haz clic en el botón Mostrar registros del panel Cronograma para ver las entradas de registro junto con el seguimiento. Este botón aparece cuando hay entradas de registro asociadas al seguimiento.

  • Haz clic en el vínculo Registro: Vista en el panel Resumen para abrir una ventana de Stackdriver Logging y ver las entradas de registro asociadas con el seguimiento. Si no hay entradas de registro asociadas con tu seguimiento, la ventana de Logging estará vacía.

  • Haz clic en el vínculo Registro de VM: Vista en el panel Resumen, que aparece para los seguimientos generados con el balanceador de cargas de Cloud. El vínculo abre una ventana de Stackdriver Logging y te muestra los registros de la instancia de VM que entregó la solicitud. La vista de la ventana de Logging se limita al rango de marcas de tiempo del seguimiento.

Permisos necesarios

Para ver cualquier entrada de registro, debes tener el permiso logging.logEntries.list en tu proyecto. Este permiso se obtiene mediante las funciones de IAM de Visor de registros de Logging y Lector del proyecto.

Para ver los registros de instancias de VM, debes tener el permiso compute.instances.get en tu proyecto. Este permiso se obtiene mediante las funciones de IAM de Lector de red de Compute Engine y Lector del proyecto.

Para obtener más información sobre cómo ver las entradas de registros en Stackdriver Logging, consulta Visor de registros.

Eventos de mensajes y anotaciones de intervalos (Beta)

Los eventos de mensajes y anotaciones de intervalos se pueden escribir con la API de Stackdriver Trace v2. Cuando están presentes, se muestran en el cronograma del seguimiento. Al igual que con los intervalos y las entradas de registro, puedes ver todos los detalles de una anotación o evento de mensaje seleccionado en el panel de detalles del lado derecho.

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

Cronograma

El cronograma es una representación gráfica de los datos de latencia de la solicitud. Muestra un intervalo raíz que representa el tiempo que le llevó a la aplicación procesar la solicitud de extremo a extremo, así como subintervalos que representan el tiempo que llevó completar las llamadas RPC que se realizaron durante el manejo de la solicitud.

Puedes hacer clic en cualquier intervalo del cronograma para ver los detalles del intervalo. Las relaciones principal-secundario entre los intervalos y subintervalos seleccionados se muestran en el cronograma, mientras que otros datos que se informaron 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 siguientes propiedades:

Propiedad Descripción
Nombre URL relativa para la solicitud. Se muestra en la etiqueta del intervalo.
Latencia El tiempo que tardó la aplicación en manejar la solicitud de extremo a extremo. Se muestra en la etiqueta del intervalo.
gae/request_log_id ID interno de solicitud de App Engine. Se muestra en el panel de detalles debajo del cronograma.
http/host Nombre del host en el que se ejecuta la aplicación. Se muestra en el panel de detalles debajo del cronograma.
http/response/size Cantidad de bytes en el cuerpo de respuesta HTTP. Se muestra en el panel de detalles debajo del cronograma.
http/url URL relativa para la solicitud. Se muestra en el panel de detalles debajo del cronograma.

La información que se muestra para los subintervalos puede variar según la llamada RPC. Sin embargo, Stackdriver Trace siempre muestra lo siguiente:

Propiedad Descripción
Nombre Nombre de la llamada RPC en formato nombre_servicio.nombre_llamada (por ejemplo, datastore_v3.RunQuery). Se muestra en la etiqueta del intervalo. Nota: El nombre de la llamada es un nombre interno de App Engine y posiblemente no sea exactamente igual que el nombre de la llamada en la API de servicio del lenguaje específico.
Latencia El tiempo que llevó realizar la llamada RPC completa. Se muestra en la etiqueta del intervalo.

Estadísticas

Si hubiera estadísticas sobre el rendimiento de la solicitud, se mostrarán debajo del cronograma.

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

Ver seguimientos entre distintos proyectos

Puedes configurar Stackdriver Trace para que muestre intervalos de seguimiento desde proyectos que llaman a tu proyecto de destino, así como intervalos de seguimiento de otros proyectos que entregan solicitudes para tu proyecto de destino.

Consulta Cómo ver seguimientos entre distintos proyectos para obtener más detalles.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Stackdriver Trace