Cómo buscar y explorar seguimientos

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

La página Explorador de seguimientos muestra como máximo 1,000 seguimientos.

Antes de comenzar

Para obtener los permisos que necesitas para ver los datos de seguimiento con la consola de Google Cloud, pídele 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 a proyectos, carpetas y organizaciones.

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 de la página Explorador de seguimientos:

    Panel de seguimientos recientes de Cloud Trace.

    El diagrama de dispersión muestra un punto para cada solicitud en el intervalo de tiempo seleccionado:

    • Las coordenadas (x,y) de una solicitud corresponden al tiempo y la latencia de la solicitud.

    • La información de error se codifica en el color de un punto. El azul indica que se realizó correctamente y el rojo indica que se produjo un error. En la captura de pantalla anterior, 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, haz lo siguiente:

    • Filtra por hora. De forma predeterminada, se muestra la hora más reciente de datos. Para ver un intervalo de tiempo personalizado, haz lo siguiente:

      1. Selecciona una opción predeterminada que sea más larga que el intervalo de tiempo personalizado.
      2. Coloca el cursor en el gráfico Seleccionar un seguimiento en un extremo del intervalo de tiempo y arrastra el cursor de forma horizontal hasta el otro extremo.

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

    • Filtrar por latencia De forma predeterminada, se muestran todos los seguimientos del intervalo de tiempo seleccionado. Para limitar la visualización a aquellos seguimientos cuya latencia se encuentra dentro de un intervalo, coloca el puntero en un extremo del valor de latencia y arrástralo verticalmente hasta el otro extremo.

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

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

      Las siguientes opciones de filtro siempre están disponibles:

      • RootSpan: Haz que coincida con el nombre del intervalo raíz.
      • SpanName: Haz coincidir el nombre del intervalo.
      • Método: Muestra los seguimientos cuyos intervalos raíz están anotados con la etiqueta /http/method, donde el valor de la etiqueta coincide con el valor del filtro.
      • Estado: Muestra los seguimientos cuyos intervalos raíz están anotados con la etiqueta /http/status_code, donde la etiqueta de valor coincide con 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 los seguimientos cuya latencia es al menos tan grande como el valor del filtro. El valor del filtro debe expresarse en milisegundos.
      • HasLabel: Muestra los seguimientos en los que la etiqueta especificada por el valor del filtro aparece en, al menos, un intervalo.
      • Service: Muestra seguimientos que contienen al menos un intervalo cuyo nombre de servicio coincide con el valor del filtro.

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

      • Version: (solo App Engine) Muestra seguimientos que contienen al menos un intervalo cuya versión de la aplicación coincide 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, la etiqueta definida por el usuario tiene el prefijo LABEL para que puedas distinguir entre ambas. Por ejemplo, si creas una etiqueta Service, verás Servicio y LABEL:Servicio en el menú de filtros.

Cómo buscar un seguimiento por ID

Cuando solucionas un incidente o una falla, es posible que conozcas el ID de seguimiento. Para explorar ese registro, 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 ver los datos de seguimiento.

    Debes seleccionar el proyecto de Google Cloud que almacena los datos de seguimiento, a menos que tu proyecto forme parte de una organización. Cuando un proyecto formará parte de una organización, podrás configurar el seguimiento entre proyectos, lo que te permitirá ver los datos de seguimiento de cualquier proyecto de la organización. Para obtener más información, consulta Cómo ver seguimientos en varios proyectos.

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

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

Cómo explorar un seguimiento

Para explorar un seguimiento, haz clic en un punto del gráfico 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 Trace:

  • El diagrama de dispersión se actualiza y el punto que seleccionaste se destaca con un círculo dibujado a su alrededor. Los puntos que representan todos los demás seguimientos aparecen atenuados.
  • En el panel Detalles de seguimiento, se 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 indica la hora de inicio, la duración y la cantidad de tramos.

    • Un menú Registros y eventos La selección del menú controla cómo se muestran los registros y los eventos. De forma predeterminada, cuando existe un registro o un evento, se agrega un círculo al intervalo de seguimiento. Los círculos superpuestos indican que el intervalo tiene varios registros o eventos. Para mostrar cada registro o evento como una fila en la tabla, expande Registros y eventos y selecciona Mostrar expandido.

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

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

      La columna Latencia proporciona una representación visual de la latencia, el estado y, cuando están presentes, las anotaciones de eventos. Una barra de latencia azul indica que se completó correctamente, y 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 la barra de latencia.

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

Ejemplos del panel de detalles de Cloud Trace.

Busca 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 tramos y una clave de atributo. Estos campos se destacan porque coinciden con el término de búsqueda, que era net.sock.peer.port.

Para buscar los intervalos en un seguimiento, en la barra de herramientas del panel Detalles del seguimiento, ingresa el término de búsqueda en el campo Buscar en el seguimiento y, luego, presiona Intro.

Luego, el seguimiento busca campos seleccionados de cada intervalo en el seguimiento que se muestra. Se produce una coincidencia cuando un campo de búsqueda contiene el término de búsqueda, sin tener en cuenta mayúsculas ni minúsculas. Se buscan los siguientes campos:

  • Es el nombre del intervalo.
  • Nombre del servicio.
  • Claves y valores de los atributos.

Una vez que se completa la búsqueda, se actualiza el panel Detalles del seguimiento y se destacan los campos que coinciden.

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

No puedes realizar búsquedas con una expresión regular ni buscar registros, eventos ni metadatos.

Cómo ver los detalles del intervalo

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

Si seleccionas la barra de latencia de la primera fila de la tabla, la fila con el nombre ID de seguimiento, la tabla contendrá dos pestañas: Resumen y Registros. En la pestaña Resumen, se 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 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 y Metadatos y vínculos:

  • Para encontrar las etiquetas adjuntas a un intervalo, consulta la pestaña Atributos. Para obtener información sobre las etiquetas, consulta Etiquetas de seguimiento. En la siguiente captura de pantalla, se ilustra 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 Clave: g.co, la tabla mostrará todas las etiquetas en las que la clave de la etiqueta contenga g.co.

  • Para ver información sobre las entradas de registro y los eventos relacionados, si existen, consulta la pestaña 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 ilustra esta pestaña:

    Ejemplo de la pestaña Registros de seguimiento y eventos de Cloud.

    Cuando los datos de registro estén disponibles, haz clic en Mostrar más para ver los detalles de una entrada de registro:

    Ejemplo de un registro expandido.

  • Para obtener información sobre la cantidad de seguimientos de pila disponibles y detalles sobre un seguimiento de pila capturado, usa la pestaña Stacktraces.

  • Para encontrar información general sobre el intervalo y una tabla de vínculos a otros intervalos, consulta la pestaña Metadatos y vínculos. Esta información incluye 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 en la que se enumeran los vínculos a otros tramos

      Cada fila de la tabla llamada Vínculos enumera un vínculo entre el intervalo actual y otro. En el campo Atributos, se enumeran los pares clave-valor del intervalo al que se vincula. El campo Trace vincula al registro del intervalo al que se hace referencia. Cuando este campo contiene Rastro actual, el tramo vinculado se encuentra en el mismo registro que el tramo actual. De lo contrario, el campo contiene un ID de seguimiento. Para obtener información sobre los vínculos, consulta la página de referencia de la API de Links.

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

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

¿Qué sigue?