Cómo buscar y explorar seguimientos

Para buscar y explorar seguimientos individuales en detalle, usa el Explorador de seguimiento . En esta página, se muestran los seguimientos de los que tu proyecto de Google Cloud almacena al menos un intervalo. Los datos que se muestran para cada seguimiento y intervalo mostrados incluyen información resumida, como la latencia, el tipo de comando y la información detallada. La información detallada incluye registros, eventos y otra información.

La página del Explorador de seguimiento muestra como máximo 1,000. registros.

Antes de comenzar

Si quieres obtener los permisos necesarios para ver datos de seguimiento con la consola de Google Cloud, solicita a tu administrador que te otorgue el Rol de IAM de usuario de Cloud Trace (roles/cloudtrace.user) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles, consulta Controla el acceso con Identity and Access Management.

Cómo mostrar seguimientos recientes

Para mostrar los seguimientos más recientes, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Explorador de seguimiento:

    Ve al Explorador de seguimiento

    También puedes usar la barra de búsqueda para encontrar esta página.

    Si es la primera vez que usas Trace, los seguimientos pueden tardar unos minutos en aparecer. En la siguiente captura de pantalla, se muestra un ejemplo del Explorador de seguimiento. página:

    Panel de seguimientos recientes de Cloud Trace.

    El diagrama de dispersión muestra un punto por cada solicitud en la zona Intervalo de tiempo:

    • Las coordenadas (x,y) para una solicitud corresponden a la y la latencia de la solicitud.

    • La información de error se codifica con el color de un punto. El azul indica el éxito y el rojo indica el error. En el anterior captura de pantalla, la mayoría de los comandos se completaron correctamente.

    • La información sobre la herramienta que se activa cuando mantienes el puntero sobre un punto muestra la fecha, la hora, el URI y la latencia:

      Visualiza información sobre la herramienta de seguimiento que muestra la información de latencia

  2. Opcional: Para filtrar los seguimientos y los intervalos que se muestran, sigue estos pasos: realiza cualquiera de las siguientes acciones:

    • Filtrar por hora. De forma predeterminada, la hora de datos más reciente el código fuente. Para ver un intervalo de tiempo personalizado, haz lo siguiente:

      1. Selecciona una opción predeterminada que sea más larga que la personalizada durante un intervalo de tiempo.
      2. Coloca el puntero en el trazado Selecciona un seguimiento en un extremo del tiempo. y arrastra el puntero horizontalmente hasta el otro extremo durante un intervalo de tiempo determinado.

      Para restablecer el gráfico al intervalo de tiempo predeterminado, haz clic en Restablecer.

    • Filtra por latencia. De forma predeterminada, todos los seguimientos del intervalo de tiempo seleccionado que se muestran. Para limitar la visualización a aquellos seguimientos cuya latencia sea dentro de un intervalo, coloca tu puntero en un extremo del valor de latencia y arrastra el puntero de forma vertical hasta el otro extremo.

      Para restablecer el gráfico al intervalo de tiempo predeterminado, haz clic en Restablecer.

    • Haz clic en Add trace filter, selecciona una opción de filtro y y, luego, selecciona o ingresa un valor de filtro. Si agregas varios filtros, solo se muestran los seguimientos que cumplen con todos los filtros. Por ejemplo, para mostrar todos los seguimientos que contienen un comando HTTP GET y cuya latencia sea de al menos 2 segundos, agrega los filtros Method: GET y MinLatency: 2,000.

      Las siguientes opciones de filtro siempre están disponibles:

      • RootSpan: coincide con el nombre del intervalo raíz.
      • SpanName: Coincide con el nombre del intervalo.
      • Método: Muestra los seguimientos cuyos intervalos raíz están anotados con el Etiqueta /http/method, donde el valor de la etiqueta coincide el valor del filtro.
      • Estado: Muestra los seguimientos cuyos intervalos raíz están anotados con el Etiqueta /http/status_code, donde la etiqueta de valor coincide el valor del filtro. El valor del filtro puede contener códigos de estado específicos, como 301, o rangos de valores de estado, como 3xx.
      • MinLatency: Muestra seguimientos cuya latencia es al menos tan grande como como valor del filtro. El valor del filtro debe expresarse en milisegundos.
      • HasLabel: Muestra los seguimientos en los que la etiqueta que especificó el filtro. aparezca en al menos un intervalo.

      • Servicio: Muestra seguimientos que contengan al menos un intervalo cuyo nombre de servicio coincida con el valor del filtro.

        El nombre del servicio para un intervalo se extrae de OpenTelemetry el atributo service.name, cuando ese atributo está configurado. Si ese atributo no está configurado y si el servicio se ejecuta en App Engine, el nombre del servicio de App Engine es que se muestra. De lo contrario, no se especificará el servicio.

      • Versión (Version): (solo App Engine) muestra seguimientos que contengan el siguiente valor: al menos un intervalo cuya versión de la aplicación coincida con el valor del filtro.

      Es posible que veas otras opciones de filtro, como URL o etiquetas HTTP. Si tienes una etiqueta definida por el usuario que coincide con un filtro predefinido, el la etiqueta definida por el usuario tiene el prefijo LABEL para que puedas distinguir entre ambos. Por ejemplo, si creas una etiqueta Service, consulta Servicio y LABEL:Servicio en el menú de filtro.

Cómo buscar un seguimiento por ID

Cuando estás solucionando un incidente o una falla, es posible que conozcas el ID de seguimiento. Para explorar ese seguimiento, haz lo siguiente:

  1. En la consola de Google Cloud, ve a la página Explorador de seguimiento:

    Ve al Explorador de seguimiento

    También puedes usar la barra de búsqueda para encontrar esta página.

  2. Selecciona un proyecto de Google Cloud desde el que quieras ver los datos de seguimiento.

    Debes seleccionar el proyecto de Google Cloud que almacena los datos de seguimiento, a menos que tu proyecto es parte de una organización. Cuando un proyecto es parte de una organización, puedes configurar el seguimiento entre proyectos y que te permite ver datos de seguimiento de cualquier proyecto de la organización. Para obtener más información, consulta Cómo ver seguimientos entre proyectos.

  3. Ingresa el ID en el campo ID de seguimiento.

    Cuando ingresas un ID válido, el panel Detalles de seguimiento se propaga con información sobre el seguimiento y sus intervalos. Puedes usar las opciones que panel para explorar en el seguimiento.

Cómo explorar un seguimiento

Para explorar un seguimiento, haz clic en un punto del diagrama de dispersión. Cuando haces clic en un punto del diagrama de dispersión, se producen los siguientes cambios en la página Explorador de seguimiento:

  • El diagrama de dispersión se actualiza y el punto que seleccionaste se destaca con un círculo dibujado alrededor del punto. Los puntos que representan todas las demás los seguimientos están atenuados.

  • El panel Detalles del seguimiento muestra lo siguiente:

    • Es el identificador de seguimiento. Este identificador único a nivel global para el seguimiento es un Número entero de 128 bits representado como una cadena hexadecimal de 32 bytes. Para obtener más información, consulta Resource: Trace.

    • Una línea de resumen que enumera la hora de inicio, la duración y el número de intervalos.

    • A Registros y eventos. La selección del menú controla cómo los registros y eventos . De forma predeterminada, cuando existe un registro o evento, se agrega un círculo a el intervalo de seguimiento. Los círculos superpuestos indican que el intervalo varios registros o eventos. Para mostrar cada registro o evento como una fila en el expandir Registros y eventos y selecciona Mostrar elementos expandidos.

    • Una tabla. La primera fila de la tabla es para el seguimiento. Se agrega una fila para cada intervalo del seguimiento.

      En el caso de los intervalos, la tabla indica su nombre y el servicio asociado con el intervalo. El nombre del servicio se extrae del El atributo service.name de OpenTelemetry, cuando se establece ese atributo Si ese atributo no está configurado y si el servicio se ejecuta en App Engine, el nombre del servicio de App Engine es que se muestra. De lo contrario, no se especificará el servicio.

      La columna Latencia proporciona una representación visual de la latencia. estado y, cuando están presentes, anotaciones de eventos. La barra de latencia azul indica se completa correctamente, una barra de latencia roja indica que se produjo un error. Cada anotación de evento en el espacio se representa con un círculo en y la barra de latencia.

A continuación, se muestra un ejemplo de panel de Detalles de seguimiento:

Ejemplos del panel de detalles de Cloud Trace.

Cómo buscar intervalos dentro de un seguimiento

Puedes buscar palabras clave en los intervalos y atributos de un seguimiento. Por ejemplo: en la captura de pantalla anterior, se destacan algunos intervalos y una clave de atributo. Estos campos están destacados porque coinciden con el término de búsqueda, que fue net.sock.peer.port.

Para buscar los intervalos en un seguimiento, en la barra de herramientas del panel Trace details, haz lo siguiente: Ingresa el término de búsqueda en el campo Find in Trace y, luego, presiona Intro.

Luego, Trace busca campos seleccionados de cada intervalo en el el seguimiento que se muestra. Una coincidencia se produce cuando un campo de búsqueda contiene el término de búsqueda, sin distinguir entre mayúsculas y minúsculas. La búsqueda se realiza en los siguientes campos:

  • Nombre del intervalo.
  • Nombre del servicio.
  • Claves y valores de atributos.

Una vez completada la búsqueda, se actualiza el panel Detalles del seguimiento y se actualiza. los campos coincidentes aparecen destacados.

Por ejemplo, si ingresas el término get, un intervalo con un atributo cuyo la clave es /http/method y cuyo valor es GET se destaca. Además, los intervalos con nombres como CurrencyService/GetSupportedCurrencies.

No se puede buscar con una expresión regular ni con registros eventos o metadatos.

Ver detalles del intervalo

Para ver información detallada sobre el seguimiento o sobre un intervalo específico, haz lo siguiente: En el panel Detalles del seguimiento, haz clic en la barra de latencia de la entrada. Cuando Si seleccionas la barra de latencia, el panel Detalles de seguimiento se volverá a dibujar y mostrará una tabla con pestañas que proporciona información adicional sobre la entrada.

Si seleccionas la barra de latencia para la primera fila de la tabla, la fila con el nombre ID de seguimiento, la tabla contiene dos pestañas: Resumen y Registros. El resumen muestra información general sobre el seguimiento. Por ejemplo, para los comandos HTTP, esta pestaña muestra el tipo de comando HTTP, el servicio y la información de la latencia para cada intervalo del seguimiento.

Si seleccionas la barra de latencia para otras filas de la tabla, es decir, una fila para un intervalo, la tabla contiene cuatro pestañas: Atributos, Registros y eventos, Stacktraces, Metadatos y Vínculos:

  • Para encontrar las etiquetas adjuntas a un intervalo, consulta la pestaña Atributos. Para información sobre las etiquetas, consulta Etiquetas de seguimiento. En la siguiente captura de pantalla, se muestra esta pestaña:

    Ejemplo de la tabla de atributos de Cloud Trace.

    Para ubicar una etiqueta específica o un grupo de etiquetas, agrega un filtro. Por ejemplo, si agregas el filtro Key: g.co, la tabla mostrará una lista todas las etiquetas en las que la clave de etiqueta contiene g.co

  • Para ver información sobre entradas de registro y eventos relacionados, cuando estos existen, consulta la página de Registros y eventos. Para obtener información sobre las anotaciones de eventos, Consulta Cómo anotar intervalos de seguimiento. En la siguiente captura de pantalla, se muestra esta pestaña:

    Ejemplo de la pestaña de eventos y registros de Cloud Trace.

    Cuando hay datos de registro disponibles, para ver los detalles sobre una entrada de registro, Haz clic en Mostrar más:

    Ejemplo de un registro expandido.

  • Para obtener información sobre la cantidad de seguimientos de pila disponibles Para obtener información detallada sobre un seguimiento de pila capturado, usa el método Stacktraces .

  • Para encontrar información general sobre el intervalo y una tabla de enlaces a otras de análisis de datos, consulta la sección Metadatos y Vínculos. Esta información incluye los lo siguiente:

    • ID de intervalo

      El ID de intervalo es un número entero de 64 bits distinto de 0. Para obtener más información, consulta TraceSpan.

    • ID principal de intervalo

    • ID del proyecto

    • Hora de inicio y finalización

    • Tabla que enumera los vínculos a otros intervalos

      Cada fila de la tabla llamada Links enumera un vínculo entre el intervalo actual. y otro intervalo. El campo Attributes enumera los pares clave-valor para el intervalo vinculado. El campo Trace vincula el seguimiento del del intervalo vinculado. Cuando este campo contiene Seguimiento actual, la vinculado esté en el mismo seguimiento que el intervalo actual. De lo contrario, el campo contiene un ID de seguimiento. Para obtener más información sobre los vínculos, consulta la Página de referencia de la API de Links

    En la siguiente captura de pantalla, se muestra esta pestaña:

    Ejemplo de la lista de metadatos y la tabla de vínculos de Cloud Trace.

¿Qué sigue?