Descripción general de Cloud Trace

Cloud Trace es un sistema de seguimiento distribuido para Google Cloud que hace un seguimiento de la latencia de las solicitudes y te ayuda a solucionar problemas de cuellos de botella de rendimiento en los servicios y las aplicaciones de IA generativa. Trace recopila datos de latencia de los servicios deGoogle Cloud y las aplicaciones instrumentadas para ayudarte a comprender cómo se procesan las solicitudes en una arquitectura de microservicios y a identificar los registros pertinentes.

Con Trace, puedes medir la latencia de las solicitudes de extremo a extremo, comparar las tendencias de rendimiento a lo largo del tiempo y determinar qué dependencias descendentes causan retrasos. Para obtener una explicación sobre cómo correlacionar seguimientos y registros, consulta Usa seguimientos y registros en conjunto para el análisis de la causa raíz.

Compatibilidad con el entorno

Trace se ejecuta en Linux en los siguientes entornos:

Componentes

Trace consta de un cliente de seguimiento, que recopila seguimientos y los envía a tu proyecto de Google Cloud . Luego, puedes usar la consola deGoogle Cloud para ver y analizar los datos que recopila el cliente de seguimiento. Para obtener información sobre el modelo de datos, consulta Seguimientos y intervalos.

Seguimiento del cliente

Un cliente de seguimiento recopila datos de latencia y de intervalos de tu aplicación y los exporta a tu proyecto de Google Cloud . Según tu entorno y tus requisitos, puedes recopilar datos de seguimiento de forma automática o manual instrumentando el código de tu aplicación.

Interfaz de seguimiento

Para ver y analizar tus datos de intervalos, puedes usar las páginas Explorador de Trace y Estadísticas de observabilidad en la consola deGoogle Cloud :

  • Explorador de seguimiento: Muestra información agregada sobre tus datos de seguimiento y te permite examinar seguimientos individuales en detalle. Los datos de latencia agregados se muestran en un mapa de calor, que puedes explorar con el puntero. Para restringir los datos que se muestran, puedes agregar filtros. También puedes ver y explorar intervalos y seguimientos individuales:

  • Estadísticas de observabilidad: Proporciona una interfaz de consulta en SQL. Tus consultas pueden unir los datos de seguimiento y de registro, y puedes ver los resultados de la consulta como una tabla o un gráfico. Puedes usar BigQuery para analizar tus datos de seguimiento si creas un conjunto de datos de BigQuery vinculado. Para obtener más información, consulta Consulta y analiza seguimientos.

Parámetros de configuración con seguimiento automático

Los siguientes parámetros de configuración capturan automáticamente los datos de seguimiento:

  • Entorno estándar de App Engine

  • Cloud Run Functions y Cloud Run

    En el caso de las solicitudes HTTP entrantes y salientes, los datos de latencia se envían automáticamente a Trace.

Instrumenta tu aplicación

Instrumenta tu aplicación para recopilar información específica que te ayude a comprender su rendimiento y solucionar problemas. Varios frameworks de instrumentación de código abierto recopilan datos de registros, métricas y seguimientos, y pueden enviar esos datos a cualquier proveedor, incluido Google Cloud. Para tus aplicaciones de agentes, algunos frameworks pueden recopilar tus instrucciones y respuestas, o pasar contexto que permita hacer un seguimiento de algunas llamadas remotas a los servidores de MCP de Google Cloud.

Para instrumentar tu aplicación, te recomendamos que uses un framework de instrumentación de código abierto y neutral con respecto al proveedor, como OpenTelemetry, en lugar de las APIs o bibliotecas cliente específicas del proveedor y del producto. Para obtener información sobre estos frameworks, consulta Observabilidad para desarrolladores de aplicaciones y Elige un enfoque de instrumentación.

Las muestras de instrumentación que proporcionamos usan OpenTelemetry:

Aunque puedes usar las bibliotecas cliente de Cloud Trace para instrumentar tu aplicación, te recomendamos que uses OpenTelemetry. Las bibliotecas de OpenTelemetry son preferibles a las bibliotecas cliente de Trace porque son más simples y exportan datos de seguimiento en el formato OTLP, que define OpenTelemetry. Para obtener más información, consulta Instrumento para Trace y Bibliotecas cliente para Cloud Trace.

Cloud Trace y las aplicaciones de agentes

Para comprender el comportamiento de tus aplicaciones de agentes, configúralas para que recopilen instrucciones y respuestas, o para que generen intervalos cuando llamen a servidores de MCP de Google Cloud remotos. Las instrucciones y respuestas te ayudan a comprender el razonamiento que usa tu aplicación de agentes. Los intervalos que registran llamadas a herramientas te ayudan a confirmar la invocación de herramientas, los estados de las llamadas y las latencias de las solicitudes.

En varios ejemplos de instrumentación, se muestra cómo configurar una aplicación para recopilar instrucciones y respuestas. Estas muestras se basan en OpenTelemetry. Para obtener más información, consulta Cómo puedes instrumentar tus aplicaciones de IA generativa.

Los servidores de MCP de Google Cloud pueden generar intervalos de seguimiento. Para obtener más información, consulta Investiga las llamadas de MCP con Trace.

APIs que transfieren datos de seguimiento

Puedes enviar datos de seguimiento a tu proyecto con la API de Telemetry o la API de Cloud Trace. Recomendamos la API de Telemetry por los siguientes motivos:

  • La API proporciona compatibilidad con el ecosistema de código abierto de OpenTelemetry, y sus límites suelen ser más generosos que los de la API de Cloud Trace, que es una API de Google Cloud propietaria.

  • Tus datos de seguimiento se almacenan en un formato que, por lo general, es coherente con los archivos proto definidos por OTLP. Es posible que algunos campos se conviertan de un tipo de datos específico de OpenTelemetry a un tipo de datos JSON antes del almacenamiento. Para obtener información sobre el formato de almacenamiento, consulta Esquema para los datos de seguimiento.

  • Para la exportación de datos de seguimiento basada en recopiladores, tu instrumentación no depende de un exportador específico de Google Cloud.

  • Algunas funciones, como la supervisión de aplicaciones, dependen de la información que solo está disponible cuando envías datos de seguimiento a la API de Telemetry.

Para evitar que tu proyecto de Google Cloud almacene datos de seguimiento, inhabilita la API de Cloud Trace. Inhabilitar la API de Cloud Trace tiene los siguientes efectos:

  • Los servicios deGoogle Cloud no envían datos de seguimiento a tu proyecto.
  • Google Cloud responde a las solicitudes enviadas a un extremo de API de Cloud Trace con un código de error.
  • Google Cloud Observability descarta los datos de seguimiento enviados al extremo de API de Telemetry específico del seguimiento. No inhabilites la API de Telemetry, ya que puede recibir datos de registros, métricas y seguimientos.

Si administras una organización y quieres evitar el uso de Cloud Trace, crea una restricción de la política de la organización.

Compatibilidad con los Controles del servicio de VPC

Los servicios deGoogle Cloud y tus aplicaciones pueden enviar datos de seguimiento a tu proyecto con la API de Cloud Trace o la API de Telemetry. Los servicios de visualización que proporciona Cloud Trace usan la API de Cloud Trace para recuperar los datos de seguimiento que muestran:

  • Cloud Trace es un servicio compatible con los Controles del servicio de VPC. El nombre del servicio de Trace es cloudtrace.googleapis.com. Para obtener detalles y limitaciones, consulta Productos compatibles: Cloud Trace.

  • La API de Telemetry es un servicio compatible con los Controles del servicio de VPC. El nombre del servicio es telemetry.googleapis.com. Para obtener detalles y conocer las limitaciones, consulta Productos compatibles: API de Telemetry.

Para establecer valores predeterminados que especifiquen la región de Google Cloud en la que se almacenan tus datos de seguimiento y si una clave administrada por el cliente encripta los datos, usa la API de Observability. También usas esta API para configurar conjuntos de datos de BigQuery vinculados, que te permiten consultar tus datos de seguimiento con los servicios de BigQuery, y para configurar permisos de seguimiento, que te permiten agregar datos de seguimiento almacenados en varios proyectos.

  • La API de Observability es un servicio compatible con los Controles del servicio de VPC. El nombre del servicio es observability.googleapis.com. Para obtener detalles y conocer las limitaciones, consulta Productos compatibles: API de Observability.

Para obtener más información, consulta lo siguiente:

Cloud Trace y residencia de datos

Si usas Assured Workloads porque tienes requisitos de residencia de datos o de nivel de impacto 4 (IL4), no uses la API de Cloud Trace para enviar intervalos de seguimiento.

Para evitar que tu proyecto de Google Cloud almacene datos de seguimiento, inhabilita la API de Cloud Trace. No inhabilites la API de Telemetry, ya que puede recibir datos de registros, métricas y seguimientos.

Retención de seguimientos

Categoría Período de retención
Intervalos almacenados en el bucket _Trace 30 días

Roles de IAM

Cloud Trace usa Identity and Access Management (IAM) para controlar el acceso a los recursos. Para obtener una lista de los roles de la API de Cloud Trace y la API de Telemetry, consulta Controla el acceso con la IAM.

Debido a que la API de Telemetry es una API de consumidor, para enviar datos a la API de Telemetry, debes especificar un proyecto de cuota y otorgar a la cuenta de servicio de la aplicación permiso para usar esa cuota. Para obtener más información, consulta API de Telemetry: Autenticación.

Precios

Para obtener información sobre los precios de Cloud Trace, consulta la página de precios de Google Cloud Observability.

¿Qué sigue?