Descripción general de Cloud Trace

Cloud Trace, un sistema de seguimiento distribuido para Google 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.

Debido a que Cloud Trace recopila datos de latencia de App Engine, balanceadores de cargas HTTP(S) y aplicaciones instrumentadas con la API de Cloud Trace, puede ayudarte a responder las siguientes preguntas:

  • ¿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?

Para obtener más información sobre la generación de perfiles de tu aplicación, consulta Cloud Profiler.

Compatibilidad con el entorno

Cloud Trace se ejecuta en Linux en los siguientes entornos:

Cloud Trace proporciona bibliotecas cliente para instrumentar tu aplicación a fin de capturar información de seguimiento. Para obtener instrucciones de configuración por lenguaje, consulta Configura Cloud Trace.

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

Algunas configuraciones 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 Cloud Trace. Estos entornos de ejecución envían automáticamente datos de latencia a Cloud Trace para solicitudes a los URI de aplicaciones. Las solicitudes incluyen datos de latencia para llamadas RPC de ida y vuelta a servicios de App Engine. Cloud Trace funciona con todas las API de administrador de App Engine, con la excepción de Cloud SQL.

  • Cloud Functions y Cloud Run

    Para las solicitudes HTTP entrantes y salientes, los datos de latencia se recopilan de forma automática.

Idiomas admitidos

En la siguiente tabla, se resume la disponibilidad de las bibliotecas cliente de Trace, de las bibliotecas de OpenTelemetry para las que hay un exportador a Cloud Trace y de las bibliotecas de OpenCensus que incluyen un exportador de Stackdriver.

Lenguaje Biblioteca cliente
disponible
Lib/exporter
de OpenTelemetry disponible
lib/exporter disponible
de OpenCensus
(obsoleto)
C# ASP.NET Core No. No.
C# ASP.NET No. No.
Go
Java
Node.js
PHP No.
Python
Ruby No.

Las bibliotecas de OpenTelemetry son más fáciles de usar que las bibliotecas cliente de Cloud Trace, ya que ocultan parte de la complejidad de la API de Trace correspondiente. Si usas estas bibliotecas, instrumenta tu aplicación para usar el exportador de Cloud Trace. Para obtener instrucciones generales de configuración, consulta Configura Cloud Trace.

Si escribes aplicaciones que se ejecutan en Compute Engine, también puedes usar el Agente de operaciones y el receptor del protocolo OpenTelemetry (OTLP) para recopilar registros y métricas de tu aplicación. Cuando usas el Agente de operaciones, no necesitas usar un exportador de Trace para interactuar con la API de Trace. Para obtener más información, consulta Usa el Agente de operaciones y OTLP.

Componentes

Cloud 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 de Google Cloud para ver y analizar los datos que recopila el agente.

Un trace describe el tiempo que tarda una aplicación en completar una sola operación. Cada seguimiento consta de uno o más intervalos. Un intervalo describe cuánto tiempo se tarda en realizar una suboperación completa. Por ejemplo, un seguimiento puede describir cuánto tiempo lleva procesar una solicitud entrante de un usuario y mostrar una respuesta. Un intervalo puede describir cuánto tiempo requiere una llamada RPC en particular. Para obtener más información, consulta el modelo de datos de Cloud Trace.

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 recopila datos de seguimiento y los envía a tu proyecto de Google Cloud.

Interfaz de seguimiento

Una vez que el agente haya recopilado datos de seguimiento, podrás ver y analizar esos datos casi en tiempo real en la interfaz de Cloud Trace.

En la página Explorador de seguimiento, puedes examinar seguimientos individuales en detalle. De forma predeterminada, en esta vista se muestra un gráfico de la latencia de todos los seguimientos y listas, en una tabla, los seguimientos más recientes. Puedes seleccionar un seguimiento para ver información más detallada, como los intervalos del seguimiento, la información de latencia de cada intervalo y el seguimiento, y vínculos a registros y eventos. Si quieres obtener información para filtrar y ver los detalles de seguimiento, consulta Cómo buscar y explorar seguimientos.

La página Informes de análisis te permite crear informes personalizados. Estos informes pueden incluir todos los seguimientos o si se especifican los filtros, solo incluir un subconjunto de seguimientos. También puedes crear informes que comparen dos conjuntos diferentes de datos de latencia. Para obtener más información, consulta Cómo crear y ver informes.

Seguridad de los datos

Cloud Trace es un servicio compatible con los Controles del servicio de VPC. Para obtener más información, consulta la documentación de Controles del servicio de VPC.

Precios y uso

¿Qué sigue?