Acerca 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?

Si deseas obtener información para depurar y perfilar tu aplicación, consulta Cloud Debugger y 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.

Configuraciones con seguimiento automático

Algunas configuraciones generan la captura automática de los 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, se recopilan datos de latencia de forma automática.

Idiomas admitidos

En la siguiente tabla, se resume la disponibilidad de las bibliotecas cliente de Trace, la disponibilidad de las bibliotecas de OpenCensus que incluyen un exportador de Stackdriver y la disponibilidad de las bibliotecas de OpenTelemetry que incluyen un exportador en Cloud Trace:

Idioma Biblioteca cliente
disponible
Biblioteca
de OpenCensus disponible
Biblioteca de OpenTelemetry
disponible
C# ASP.NET Core No No
C# ASP.NET No No
Go
Java
Node.js
PHP No
Python
Ruby No No

Las bibliotecas de OpenCensus y OpenCensus son más fáciles de usar porque ocultan parte de la complejidad de la biblioteca cliente de Cloud Trace correspondiente. Si usas estas bibliotecas, instrumenta tu aplicación para usar el exportador de Cloud Trace.

Para obtener instrucciones de configuración generales, consulta Configura Cloud Trace.

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 Google Cloud Console para ver y analizar los datos recopilados por el agente.

Un seguimiento 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.

Realiza un seguimiento del cliente

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

Si una biblioteca de OpenCensus no existe, instrumenta tu código mediante la importación de la biblioteca del SDK de Trace y 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. La interfaz contiene tres páginas: Descripción general, Informes de análisis y Lista de seguimiento.

Para comenzar a usar Cloud Trace, en el panel de navegación de la consola, selecciona Trace o haz clic en el siguiente botón:

Ir a Trace

En la consola de Trace, no se mostrarán datos, a menos que tengas acceso a un proyecto de Google Cloud que recibe datos de Trace.

Descripción general

En la página Descripción general, se proporciona información resumida sobre la aplicación:

Página de resumen de Cloud Trace.

En el panel Estadísticas (Insights), se muestra una lista de estadísticas de rendimiento para tu aplicación, si corresponde: En este panel, se destacan los problemas comunes en las aplicaciones, como las llamadas consecutivas a una función, que si se agrupa en lotes, puede ser más eficaz.

En el panel Seguimientos recientes, se muestran los seguimientos más recientes. En cada uno, se muestran la latencia, el URI y la hora. Puedes usar este resumen para comprender la actividad actual de la aplicación.

Los URI más frecuentes y las RPC más frecuentes enumeran los URI más frecuentes (y RPC) del día anterior, junto con la latencia promedio. Si haces clic en un vínculo en cualquiera de estas tablas, abrirás la página Lista de seguimientos, que está preconfigurada para mostrar las solicitudes coincidentes. En la página Lista de seguimientos, puedes ver la latencia como una función del tiempo e investigar los detalles de cualquier seguimiento individual.

El panel Intervalos de seguimiento por cobrar muestra la cantidad de intervalos transferidos en el mes calendario actual y el total del mes anterior. Puedes usar esta información a fin de supervisar los costos para usar Cloud Trace. Para obtener más información sobre los costos, consulta la sección Precios de esta página.

El panel Informes diarios de análisis muestra los datos de latencia del día anterior y los compara con los datos de latencia de 7 días previos. Mediante estos datos, puedes ver si cambia el comportamiento de la latencia con el tiempo. No puede cambiar el formato de los informes de esta página. Sin embargo, puedes crear informes de análisis personalizados.

Para obtener más información sobre la página Descripción general de Cloud Trace, consulta Cómo ver seguimientos en la consola.

Lista de seguimientos

La página Lista de seguimientos te permite examinar los 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.

Si seleccionas un seguimiento específico para examinar, se abrirán dos paneles nuevos: un panel que muestra todos los intervalos del seguimiento y un panel de información que muestra los detalles del intervalo seleccionado. Según la configuración predeterminada, se selecciona el intervalo raíz y los detalles incluyen información resumida sobre la solicitud. A fin de encontrar seguimientos para la investigación, usa filtros.

Para obtener más información sobre cómo filtrar y ver detalles de seguimiento, consulta Busca y visualiza seguimientos y Visualiza detalles de seguimiento.

Informes de análisis

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 Crea informes de análisis.

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.

¿Qué sigue?