Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Descripción general de Cloud Trace

Cloud Trace, un sistema de seguimiento distribuido paraGoogle Cloud, te ayuda a comprender cuánto tiempo le lleva a tu aplicación manejar las solicitudes entrantes de usuarios o de otras aplicaciones y cuánto tiempo lleva completar las operaciones como las llamadas RPC realizadas cuando se manejan las solicitudes. Trace también puede ayudarte cuando desarrollas un servicio, una aplicación basada en agentes o solucionas una falla. Por ejemplo, puede ayudarte a comprender cómo se procesan las solicitudes en una arquitectura de microservicios complicada y podría ayudarte a identificar qué registros examinar.

Debido a que Trace recibe datos de latencia de servicios como App Engine y de las aplicaciones que instrumentas, puede ayudarte a responder las siguientes preguntas: Google Cloud

¿Cuánto tiempo tardará mi aplicación en manejar una solicitud determinada?
¿Por qué mi aplicación tarda mucho tiempo en manejar una solicitud?
¿Por qué algunas de mis solicitudes tardan más tiempo que otras?
¿Cuál es la latencia general de las solicitudes de mi aplicación?
¿Aumentó o disminuyó la latencia de mi aplicación en el tiempo?
¿Qué puedo hacer para reducir la latencia de mi aplicación?
¿Cuáles son las dependencias de mi aplicación?

Si quieres saber cómo puedes usar Trace para administrar tus aplicaciones, lee la entrada del blog Solución de problemas de aplicaciones distribuidas: Usa seguimientos y registros en conjunto para el análisis de la causa raíz.

Si deseas obtener información para perfilar tu aplicación, consulta Cloud Profiler.

Compatibilidad con el entorno

Trace se ejecuta en Linux en los siguientes entornos:

Trace proporciona bibliotecas cliente para instrumentar tu aplicación y capturar información de seguimiento. Para obtener instrucciones de configuración por lenguaje, consulta Instrumenta para Trace.

Configuraciones con seguimiento automático

Algunos parámetros de configuración generan la captura automática de datos de seguimiento:

Entorno estándar de App Engine

Las aplicaciones de Java 8, Python 2 y PHP 5 no necesitan usar las bibliotecas cliente de Trace. Estos tiempos de ejecución envían automáticamente datos de latencia a Trace para las solicitudes a los URI de aplicaciones. Las solicitudes incluyen datos de latencia para llamadas RPC de ida y vuelta a servicios de App Engine. Trace funciona con todas las APIs de administrador de App Engine, excepto con Cloud SQL.
Cloud Run Functions y Cloud Run

Para las solicitudes HTTP entrantes y salientes, los datos de latencia se envían automáticamente a 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 el siguiente motivo:

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 el protocolo de línea de OpenTelemetry. 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 más información sobre el formato de almacenamiento, consulta Esquema de los datos de registro.
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.

Si deseas 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 registros de seguimiento.

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

Cloud Trace y las aplicaciones de agente

Para comprender el comportamiento de tus aplicaciones agente, 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 tramos que registran las 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. Estos ejemplos se basan en OpenTelemetry. Para obtener más información, consulta Cómo instrumentar tus aplicaciones de IA generativa.

Para obtener información sobre qué servidores MCP remotos de Google Cloud admiten la generación de seguimientos y cómo configurar tu aplicación para indicarles a estos servidores que creen intervalos, consulta Investiga las llamadas a MCP con Trace.

Cómo instrumentar tu aplicación

Instrumenta tu aplicación para recopilar información específica que te ayude a comprender su rendimiento y solucionar errores. 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 un recopilador, consulta lo siguiente:
- Go
- Java
- Node.js
- Python
Estos ejemplos envían datos de seguimiento a la API de Telemetry.
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 agente para recopilar instrucciones y respuestas, consulta Cómo instrumentar tus aplicaciones de IA generativa.

Para saber qué servidores remotos de Google Cloud MCP admiten la generación de seguimientos y cómo configurar tu aplicación para indicar a estos servidores que creen intervalos, consulta Investiga las llamadas al MCP con Trace.

También puedes usar las bibliotecas cliente de Cloud Trace para instrumentar tu aplicación. Sin embargo, 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 Bibliotecas cliente para Cloud Trace.

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 que recopila el agente. Para obtener información sobre el modelo de datos, consulta Registros y períodos.

Seguimiento del cliente

Si una biblioteca de OpenTelemetry está disponible para tu lenguaje de programación, puedes simplificar el proceso de creación y envío de datos de seguimiento con OpenTelemetry. Además de ser más fácil de usar, OpenTelemetry implementa lotes, lo que puede mejorar el rendimiento.

Si no existe una biblioteca de OpenTelemetry, instrumenta tu código importando la biblioteca del SDK de Trace y usando la API de Cloud Trace. La API de Cloud Trace envía datos de seguimiento a tu proyecto de Google Cloud .

Interfaz de seguimiento

Puedes ver y analizar tus datos de seguimiento casi en tiempo real en la interfaz de Trace.

Para ver y analizar tus datos de intervalo, puedes usar las páginas Trace Explorer y Observability Analytics 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. Esta página también te permite ver y explorar intervalos y seguimientos individuales:
- Para obtener información sobre cómo ver los datos de seguimiento almacenados en varios proyectos, consulta Crea y administra el alcance del registro de seguimiento.
- Para obtener información sobre cómo filtrar y ver tus datos de seguimiento, consulta Busca y explora seguimientos.
Estadísticas de observabilidad: Esta página te permite ejecutar consultas que realizan un análisis agregado de tus intervalos con SQL. Tus consultas en SQL también pueden unir tus datos de registro y de seguimiento. Puedes ver los resultados de tu búsqueda en formato tabular o con gráficos. Si creas un conjunto de datos vinculado, puedes usar BigQuery para analizar tus intervalos. Para obtener más información, consulta Cómo consultar y analizar registros.

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 seguimiento es cloudtrace.googleapis.com. Las restricciones de los Controles del servicio de VPC que crees para el servicio de Trace se aplicarán solo a ese servicio. Esas restricciones no se aplican a ningún otro servicio, incluidos aquellos como el servicio de telemetry.googleapis.com, que también puede 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 del nivel de impacto 4 (IL4), no uses la API de Cloud Trace para enviar intervalos de seguimiento.