Acerca de Cloud Trace

Cloud Trace, un sistema de seguimiento distribuido para Google Cloud, te ayuda a comprender cuánto tiempo demora tu aplicación en manejar las solicitudes entrantes de los usuarios y otras aplicaciones, y cuánto tiempo lleva completar las operaciones como las llamadas RPC 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 información sobre la depuración o el perfilado de tu aplicación, consulta Administración del rendimiento de la aplicación.

Asistencia del entorno

Cloud Trace se ejecuta en Linux en los siguientes entornos:

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

En las aplicaciones del entorno estándar de App Engine, 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 URI de aplicaciones. Las solicitudes incluyen datos de latencia para llamadas de RPC de ida y vuelta a los servicios de App Engine. Cloud Trace funciona con todas las API de administrador de App Engine, excepto Cloud SQL.

Idiomas admitidos

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

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

Las bibliotecas de OpenCensus son más fáciles de usar porque ocultan parte de la complejidad de la biblioteca cliente de Cloud Trace correspondiente. Si usas OpenCensus, selecciona el exportador de Stackdriver.

Para obtener instrucciones generales sobre la configuración, 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 podría describir cuánto tiempo lleva procesar una solicitud entrante de un usuario y mostrar una respuesta. Un intervalo puede describir el tiempo que requiere una llamada RPC en particular. Para obtener más información, consulta el modelo de datos de Cloud Trace.

Cliente de seguimiento

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 el procesamiento por lotes, lo que podría mejorar el rendimiento.

Si no existe una biblioteca de OpenCensus, codifica tu código mediante la importación de la biblioteca de SDK de Trace y mediante 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

Después de que el agente haya recopilado los datos de seguimiento, puedes verlos y analizarlos casi en tiempo real en la interfaz de Cloud Trace. La interfaz contiene tres ventanas: 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 ventana Descripción general, se proporciona información resumida sobre tu aplicación:

Página de descripción general de Cloud Trace.

El panel Estadísticas muestra una lista de estadísticas de rendimiento para tu aplicación, si corresponde: Este panel destaca los problemas comunes en las aplicaciones, como las llamadas consecutivas a una función, que, si se agrupan en lotes, podrían ser más eficientes.

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

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

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

El panel Informes de análisis diario (Daily analysis reports) muestra los datos de latencia del día anterior y los compara con los datos de latencia de 7 días antes. Con estos datos, puedes ver si tu comportamiento de latencia cambia 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 ventana Descripción general de Cloud Trace, consulta Ve seguimientos en Cloud Console.

Lista de seguimientos

La ventana Lista de seguimiento te permite examinar los seguimientos individuales en detalle. De forma predeterminada, esta vista muestra un gráfico de la latencia de todos los seguimientos y listas, en una tabla, de los seguimientos más recientes.

Si seleccionas un seguimiento específico para examinar, se abren dos paneles nuevos: un panel que muestra todos los intervalos en el seguimiento y un panel de información que muestra detalles sobre el intervalo seleccionado. De manera predeterminada, el intervalo raíz se selecciona 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 ventana Informes de análisis le permite crear informes personalizados. Estos informes pueden incluir todos los seguimientos o, al especificar filtros, solo se incluye un subconjunto de seguimientos. También puede crear informes que comparen dos conjuntos diferentes de datos de latencia. Para obtener más información, consulte Cómo crear informes de análisis.

Precios

Los datos de latencia se empaquetan en un seguimiento, que se compone de intervalos. Los intervalos transfieren el backend de Cloud Trace, que luego pone a disposición los datos para la visualización en tiempo real y los informes en Cloud Console. Cuando ves los datos de seguimiento, los intervalos almacenados se analizan como parte del proceso de recuperación.

Los precios de Cloud Trace se determinan por la cantidad de intervalos de Trace transferidos y analizados mensualmente. Para obtener más información, consulta Precios de Trace.

Puedes crear una alerta para notificarte si tu recuento de intervalos transferidos supera un límite predefinido. Para obtener más información, consulta Crea políticas de alertas.

Cuota

Cloud Trace aplica una cuota de tarifa en las solicitudes a la API y una cuota de transferencia a los intervalos que enviaste a Trace. Para obtener más información, consulta Cuotas y límites.

Para ver tu uso actual, haz lo siguiente:

  1. En Google Cloud Console, selecciona API y servicios y, luego, selecciona API de Cloud Trace. También usa el siguiente botón:

    Ir a la API de Trace

  2. Haz clic en Cuotas.

Puedes crear una alerta para que te notifique si superaste tus cuotas. Para obtener más información, consulta Crea políticas de alertas.

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