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 dan como resultado 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 datos de latencia de forma automática a Cloud Trace para las solicitudes a los URI de la aplicación. Las solicitudes incluyen datos de latencia de las 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.OpenCensus bibliotecas que incluyen un exportador de Stackdriver y la disponibilidad deOpenTelemetry Bibliotecas que incluyen un exportador en Cloud Trace:

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

Las bibliotecas OpenTelemetry 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 que recopila 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, Lista de seguimiento e Informes de análisis.

Para comenzar a usar Cloud Trace, en el panel de navegación de Cloud Console, 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 indican los URI más frecuentes (y las RPC) del día anterior, junto con la latencia promedio. Si haces clic en un vínculo de cualquiera de estas tablas, se abrirá la página Trace list (Lista de seguimiento), que está preconfigurada para mostrar las solicitudes coincidentes. En la página Lista de seguimiento, puedes ver la latencia como una función de tiempo e investigar 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 Visualiza seguimientos en Cloud Console.

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?