Descripción general de Cloud Trace

Cloud Trace es un sistema de seguimiento distribuido para Google Cloudque hace un seguimiento de la latencia de las solicitudes y te ayuda a solucionar los cuellos de botella de rendimiento en los servicios y las aplicaciones de IA generativa. Trace recopila datos de latencia de losGoogle Cloud servicios y las aplicaciones instrumentadas, y te ayuda 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 de nivel inferior causan demoras. Para obtener una guía sobre cómo correlacionar registros y seguimientos, consulta Usa registros y seguimientos en conjunto para el análisis de la causa raíz.

Compatibilidad con el entorno

El registro de seguimiento se ejecuta en Linux en los siguientes entornos:

Componentes

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

Seguimiento del cliente

Un cliente de seguimiento recopila datos de latencia y de intervalo 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 la 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. Puedes agregar filtros para restringir los datos que se muestran. También puedes ver y explorar intervalos y seguimientos individuales:

  • Observability Analytics: Proporciona una interfaz de consulta en SQL. Tus consultas pueden unir tus datos de registros y de seguimiento, y puedes ver los resultados de las consultas como una tabla o un gráfico. Puedes usar BigQuery para analizar tus datos de seguimiento si creas un conjunto de datos vinculado de BigQuery. Para obtener más información, consulta Cómo consultar y analizar registros.

Configuraciones con seguimiento automático

Las siguientes configuraciones capturan automáticamente los datos de seguimiento:

  • Entorno estándar de App Engine

  • Cloud Run Functions y Cloud Run

    Para 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 fallas. Existen varios frameworks de instrumentación de código abierto que recopilan datos de registros, métricas y seguimientos, y pueden enviar esos datos a cualquier proveedor, incluido Google Cloud. En el caso de tus aplicaciones basadas en agentes, algunos frameworks pueden recopilar tus instrucciones y respuestas, o bien 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 con proveedor neutro, como OpenTelemetry, en lugar de las APIs o bibliotecas cliente específicas de proveedor y producto. Para obtener información sobre estos frameworks, consulta Instrumentación y observabilidad y Elige un enfoque de instrumentación.

Las muestras de instrumentación que proporcionamos usan OpenTelemetry:

  • Para ver ejemplos que usan una exportación basada en el recopilador, consulta lo siguiente:

    Estos ejemplos envían datos de métricas y de seguimiento que siguen el formato del protocolo de OpenTelemetry (OTLP) a tu proyecto a través de la API de Telemetry. En los ejemplos, se usa un exportador de Google Cloud para los datos de registro.

  • Si deseas obtener información para usar una exportación directa de datos de seguimiento y enviar esos datos a la API de Telemetry, consulta Migra del exportador de Trace al extremo de OTLP.

  • Para ver ejemplos que te muestran cómo configurar una aplicación basada en agentes para recopilar instrucciones y respuestas, consulta Cómo instrumentar tus aplicaciones de IA generativa.

Si bien 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 formato OTLP, que define OpenTelemetry. Para obtener más información, consulta Instrumento para Trace y Bibliotecas cliente de Cloud Trace.

Cloud Trace y las aplicaciones basadas en agentes

Para comprender el comportamiento de tus aplicaciones basadas en agentes, configúralas para que recopilen instrucciones y respuestas, o bien para que generen intervalos cuando llamen a los servidores de MCP de Google Cloud remotos. Las instrucciones y las respuestas te ayudan a comprender el razonamiento que usa tu aplicación basada en 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.

Varias muestras de instrumentación te muestran 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 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 llamadas a 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. Te 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 Google Cloud propietaria.

  • Tus datos de seguimiento se almacenan en un formato que suele ser coherente con los archivos .proto definidos por OTLP. Algunos campos se pueden convertir 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 de los datos de seguimiento.

  • Para la exportación basada en recopiladores de datos de seguimiento, 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 Google Cloud almacene datos de seguimiento, inhabilita la API de Cloud Trace. Si inhabilitas la API de Cloud Trace, ocurrirá lo siguiente:

  • 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 esta API puede recibir datos de registros, métricas y seguimientos.

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

Compatibilidad con los Controles del servicio de VPC

Google Cloud servicios 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 registro 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 limitaciones, consulta Productos compatibles: API de Telemetry.

Para establecer valores predeterminados que especifiquen la Google Cloud región 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 puedes usar esta API para configurar conjuntos de datos vinculados de BigQuery, que te permiten consultar tus datos de seguimiento con los servicios de BigQuery, y para configurar alcances 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 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 Google Cloud almacene datos de seguimiento, inhabilita la API de Cloud Trace. No inhabilite la API de Telemetry, ya que esta API puede recibir datos de registros, métricas y seguimientos.

Retención de registros

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 Control de acceso con IAM.

Dado que la API de Telemetry es una API de consumidor, para enviar datos a ella, debes especificar un proyecto de cuota y otorgar permiso a la cuenta de servicio de la aplicación 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 Precios de Google Cloud Observability.

¿Qué sigue?