Descripción general de Cloud Trace

Cloud Trace es un sistema de seguimiento distribuido para Google Cloud que rastrea 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. Al recopilar datos de latencia de los Google Cloud servicios y las aplicaciones instrumentadas, Trace te ayuda a comprender cómo se procesan las solicitudes en una arquitectura de microservicios y a identificar los registros pertinentes.

Trace te ayuda a responder preguntas como las siguientes:

  • ¿Cuánto tiempo tarda tu aplicación en controlar una solicitud determinada?
  • ¿Por qué una solicitud tarda mucho en completarse?
  • ¿Por qué algunas solicitudes tardan más que otras?
  • ¿Cuál es la latencia general de las solicitudes de tu aplicación?
  • ¿Aumentó o disminuyó la latencia de la aplicación con el tiempo?
  • ¿Cómo puedes reducir la latencia de la aplicación?
  • ¿Cuáles son las dependencias de tu aplicación?

Para obtener información sobre cómo usar seguimientos y registros en conjunto para el análisis de la causa raíz, consulta la entrada de blog Solución de problemas de aplicaciones distribuidas: usa seguimientos y registros en conjunto para el análisis de la causa raíz.

Para obtener información sobre cómo crear perfiles de tu aplicación, consulta Cloud Profiler.

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 Google Cloud proyecto. Luego, puedes usar la Google Cloud consola para ver y analizar los datos que recopila el cliente de seguimiento. Para obtener información sobre el modelo de datos, consulta Seguimientos e intervalos.

Seguimiento del cliente

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

Interfaz de seguimiento

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

  • 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 tus 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.

Configuraciones con seguimiento automático

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

  • Entorno estándar de App Engine

  • Cloud Run y Cloud Run Functions

    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 problemas. Varios frameworks de instrumentación de código abierto recopilan datos de registros, métricas y seguimientos datos, 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 el seguimiento de algunas llamadas remotas a servidores MCP de Google Cloud.

Para instrumentar tu aplicación, te recomendamos que uses un framework de instrumentación con proveedor neutro y que sea de código abierto, como OpenTelemetry, en lugar de las APIs específicas de proveedor y producto. o bibliotecas cliente. Para obtener información sobre estos frameworks, consulta Instrumentación y observabilidad y Elige un enfoque de instrumentación.

En las muestras de instrumentación que proporcionamos, se usa OpenTelemetry:

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

    Estas muestras envían datos de métricas y seguimientos que siguen el formato del protocolo OpenTelemetry (OTLP) a tu proyecto mediante la API de Telemetry. Las muestras usan un Google Cloud exportador para los datos de registro.

  • Para obtener información sobre cómo 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 obtener muestras que te muestran cómo configurar una aplicación de agentes para recopilar instrucciones y respuestas, consulta Cómo instrumentar tus aplicaciones de IA generativa.

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

Cloud Trace y aplicaciones de agentes

Para comprender el comportamiento de tus aplicaciones de agentes, configúralas para recopilar instrucciones y respuestas o para generar intervalos cuando llamen a servidores MCP de Google Cloud remotos Google Cloud. Las instrucciones y las 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.

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 MCP de Google Cloud pueden generar intervalos de seguimiento. Para obtener más información, consulta Investiga las 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 OpenTelemetry de código abierto, 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 para datos de seguimiento.

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

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

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

  • Google Cloud Los servicios 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 inhabilite la API de Telemetry, ya que esa API puede recibir datos de registros, métricas y seguimientos.

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

Compatibilidad con los Controles del servicio de VPC

Trace es un servicio compatible con los Controles del servicio de VPC. El nombre del servicio de Trace es cloudtrace.googleapis.com. Las restricciones de los Controles del servicio de VPC que crees para el servicio de Trace solo se aplican a ese servicio. Esas restricciones no se aplican a ningún otro servicio, incluidos los servicios como el telemetry.googleapis.com servicio, que también pueden transferir datos de seguimiento.

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 nivel de impacto 4 (IL4), no uses la API de Cloud Trace para enviar intervalos de seguimiento.

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

Retención de Trace

Categoría Período de retención
Intervalos almacenados en el _Trace bucket 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 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 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?