Cómo buscar y explorar seguimientos

Para ver una representación agregada de tus datos de seguimiento o para encontrar y explorar seguimientos individuales o que contengan etiquetas específicas, usa la página Explorador de seguimientos.

Información acerca de la página Explorador de seguimiento

Para ayudarte a identificar tendencias y patrones en tus datos de seguimiento, los datos de latencia se agregan y se muestran en gráficos. El mapa de calor, que es la visualización predeterminada, usa color para representar la cantidad de tramos en una celda. Una celda con muchos intervalos se muestra con un color más oscuro que una celda con pocos intervalos. Puedes seleccionar una celda o activar su información sobre herramientas para obtener más información. Las otras visualizaciones te permiten ver la latencia como un percentil y la información de la tasa de intervalo. En todas las visualizaciones, puedes usar el puntero para expandir el eje X. En el caso de los gráficos de líneas, puedes expandir los ejes X e Y.

Cuando investigues un problema, te recomendamos que veas un seguimiento específico o solo intervalos con ciertas propiedades:

  • Cuando conozcas el ID de un seguimiento, en la barra de herramientas, haz clic en Buscar seguimiento y, luego, ingresa el ID de seguimiento en el diálogo. A continuación, puedes buscar palabras clave en los intervalos y atributos del seguimiento .

  • Cuando veas los datos agregados, puedes aplicar filtros para buscar períodos específicos. Por ejemplo, puedes filtrar los datos para mostrar solo esos intervalos de un servicio específico. A continuación, puedes agregar un segundo filtro que limite la visualización a intervalos de un servicio específico que informa un error.

Los datos tabulares te permiten ver los detalles de los períodos individuales y ayudarte a identificar valores atípicos. Por ejemplo, para encontrar el intervalo con el valor de latencia más alto, selecciona la pestaña Intervalos y, luego, ordena los datos por latencia. Para encontrar los servicios que generan errores, filtra los datos por estado del intervalo y, luego, selecciona la pestaña Agrupados, que muestra los datos que se agruparon por intervalo y nombre de servicio. Cada fila de la tabla contiene un vínculo a información detallada.

Los datos de seguimiento que muestra la página Explorador de seguimientos dependen de lo siguiente:

  • Los proyectos en los que se buscaron datos de seguimiento. De forma predeterminada, solo se busca el proyecto seleccionado por el selector de proyectos para obtener datos de seguimiento. Sin embargo, puedes configurar la página para que busque la lista de proyectos en un permiso de seguimiento.
  • Tus permisos de Identity and Access Management (IAM) en los proyectos buscados Si no tienes permiso para ver los datos de seguimiento de un proyecto, la consola de Google Cloud mostrará un mensaje de advertencia y no se mostrarán los datos de ese proyecto.
  • La configuración del intervalo de tiempo
  • Los filtros que aplicas

En el resto de la página, se proporciona más información para encontrar y explorar tus datos de seguimiento.

Antes de comenzar

Para obtener los permisos que necesitas para ver los datos de seguimiento con la consola de Google Cloud y seleccionar un alcance de seguimiento, 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.

Este rol predefinido contiene los permisos necesarios para ver los datos de seguimiento a través de la consola de Google Cloud y seleccionar un alcance de seguimiento. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver los datos de seguimiento con la consola de Google Cloud y seleccionar un alcance de seguimiento:

  • Para seleccionar un alcance de seguimiento, haz lo siguiente: cloudtrace.traceScopes.[get, list]
  • Para leer el ámbito de registro predeterminado, haz lo siguiente: observability.scopes.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

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

Cómo ver datos de seguimiento agregados

Para ver la información agregada sobre tus datos de 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.

    Es posible que pasen varios minutos después de que se escriben los primeros datos de seguimiento en un proyecto de Google Cloud para que estén disponibles para su visualización. Si no ves ningún dato de seguimiento después de esperar unos minutos, es posible que tu proyecto no tenga datos para mostrar o que haya un problema de configuración. Si deseas obtener información para resolver estos problemas, consulta Soluciona problemas: No hay datos en la interfaz de seguimiento.

  2. Opcional: Configura en qué proyectos se buscarán datos de seguimiento con el elemento Alcance:

    • Para mostrar los datos de seguimiento almacenados en tu proyecto, establece el primer menú del elemento Scope en Project o en _Default. Estos dos parámetros de configuración son equivalentes.

    • Para mostrar los datos de seguimiento almacenados en varios proyectos, expande el primer menú del elemento Alcance, selecciona Alcance de seguimiento y, luego, selecciona el alcance de seguimiento que enumera esos proyectos. Después de realizar la selección, el menú Alcance muestra un ícono de alcance de seguimiento, , y el nombre del alcance de seguimiento seleccionado.

    Los datos que se muestran dependen de tus roles de IAM en los proyectos que se buscaron. Por ejemplo, si los proyectos buscados incluyen un proyecto de Google Cloud al que no tienes acceso, no se mostrarán datos de seguimiento para ese proyecto.

    Para obtener más información, consulta Crea y administra ámbitos de seguimiento.

  3. Opcional: Actualiza el intervalo de tiempo con el selector de intervalo de tiempo o con el puntero para destacar un intervalo en el eje X.

  4. Explora los gráficos, que muestran patrones y tendencias en tus datos de seguimiento:

    • Para obtener información sobre los datos de latencia del intervalo, establece el menú Chart view en Span duration (heatmap). La intensidad del color es proporcional a la cantidad de tramos. Para obtener información sobre una celda, usa el puntero. La información sobre la herramienta muestra la cantidad de períodos, la fecha y la hora, y el intervalo de tiempo de la celda.

    • Para ver las tendencias de latencia, establece el menú Vista del gráfico en Duración del intervalo (percentil). En el gráfico de duración, se muestran los percentiles 50, 90, 95 y 99.

    • Para ver el estado de la respuesta como una función del tiempo, configura el menú Vista de gráfico en Tasa de intervalo. El gráfico muestra la frecuencia de los intervalos que se envían a tu proyecto.

  5. Explora los datos tabulares que muestran intervalos individuales en la pestaña Intervalos y los intervalos agrupados por servicio y nombre en la pestaña Agrupados.

    Cada fila de las tablas muestra un intervalo o una agrupación, junto con un vínculo a información detallada y algunas métricas. Por ejemplo, en la pestaña Agrupados, las métricas incluyen la tasa de error y la cantidad de intervalos en el grupo.

    Para encontrar valores atípicos, selecciona el encabezado de una columna para ordenar la tabla.

  6. Agrega filtros para restringir los intervalos que se muestran. Por ejemplo, puedes filtrar por nombre de servicio y por estado. Cuando agregas o quitas un filtro, se actualizan los datos que muestra la página Explorador de Trace y solo se muestran los intervalos que coinciden con todos los filtros aplicados.

    Para cambiar la configuración de los filtros, haz lo siguiente:

    • Ve al panel Filtros de intervalo y selecciona los filtros que deseas aplicar.

      En el panel Filtros de intervalo, solo se muestran los filtros más comunes. Si quieres filtrar por un atributo que no aparece en la lista, usa la barra Filtro.

    • Para agregar un filtro con la barra Filtro, selecciona Agregar filtro y, luego, completa el cuadro de diálogo.

      Para filtrar por un atributo que no aparece en el menú de opciones, selecciona Agregar filtro de atributos y, luego, agrega tu clave y valor personalizados. Por ejemplo, si estableces la clave en /http/status_code y el valor en 200, el filtro es /http/status_code: 200. Para permitir que el filtro coincida con cualquier valor, selecciona Cualquier valor.

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. Ve a la barra de herramientas, haz clic en Buscar seguimiento y, luego, ingresa el ID de seguimiento.

    Cuando ingresas un ID válido, se abre el menú flotante Detalles y se muestra información sobre el seguimiento y sus intervalos. Puedes usar las opciones de ese panel para explorar el seguimiento. Por ejemplo, puedes buscar palabras clave en los intervalos.

Cómo explorar un seguimiento

Para ver un seguimiento o un intervalo, 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.

    Es posible que pasen varios minutos después de que se escriben los primeros datos de seguimiento en un proyecto de Google Cloud para que estén disponibles para su visualización. Si no ves ningún dato de seguimiento después de esperar unos minutos, es posible que tu proyecto no tenga datos para mostrar o que haya un problema de configuración. Si deseas obtener información para resolver estos problemas, consulta Soluciona problemas: No hay datos en la interfaz de seguimiento.

  2. Realiza una de las siguientes acciones:

    • Ve a la sección de la tabla de la página Explorador de seguimiento y selecciona una entrada de la tabla que muestre intervalos o información de resumen después de agrupar los datos por servicio y nombre de intervalo.

    • Ve a la barra de herramientas de la página Explorador de seguimiento, haz clic en Buscar seguimiento y, luego, ingresa el ID de seguimiento.

    Se abrirá el menú flotante Detalles y se mostrará un seguimiento y sus intervalos:

    • La columna Nombre muestra la jerarquía de llamadas, y la primera entrada incluye el ID de seguimiento.
    • La columna Service se extrae del 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, se muestra el nombre del servicio de App Engine. De lo contrario, no se especifica ningún servicio.
    • La longitud de la barra de latencia es representativa del valor de latencia.
    • El color de la barra de latencia indica el estado. Una barra de latencia azul indica una finalización correcta, mientras que una barra de latencia roja indica que se produjo un error.
    • Un círculo en una barra de latencia indica que una entrada de registro o un evento están asociados con el intervalo. Para cambiar este comportamiento, usa el menú Registros y eventos.

  3. Opcional: Busca el nombre del intervalo, el nombre del servicio y los atributos en un seguimiento con el campo Buscar en el seguimiento.

    Por ejemplo, si ingresas GET, se destacará el texto en el nombre del intervalo, el nombre del servicio o en el panel Atributos que muestre GET, sin distinguir mayúsculas de minúsculas.

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

  4. Para ver los detalles de un intervalo específico, selecciónalo y, luego, haz lo siguiente:

    1. Para ver las etiquetas adjuntas al intervalo, ve a la pestaña Atributos. Para obtener información sobre las etiquetas, consulta Etiquetas de seguimiento.

    2. Para ver los registros y eventos relacionados con el intervalo, ve a la pestaña Registros y eventos. Para obtener información sobre las anotaciones de eventos, consulta Cómo anotar tramos de seguimiento.

      Para ver una entrada de registro, haz clic en Mostrar más.

      También puedes seleccionar el botón Ver registros, que abre la página Explorador de registros con la consulta establecida para filtrar un seguimiento, un intervalo y un período específicos. Es posible que esta consulta no devuelva ninguna entrada de registro.

    3. Para ver los seguimientos de pila, usa la pestaña Stacktraces.

    4. 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 que no es 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 muestra 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.

¿Qué sigue?