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.

En el 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.

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 de 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 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, Informes de análisis y Lista de seguimiento.

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

Precios

Los datos de latencia se empaquetan en un seguimiento, que se compone de intervalos. El backend de Cloud Trace transfiere los intervalos, lo que hace que los datos estén disponibles para la visualización y los informes en tiempo real en Cloud Console. Cuando visualizas datos de seguimiento, los intervalos almacenados se analizan como parte del proceso de recuperación.

El precio de Cloud Trace se determina por la cantidad de intervalos de Trace que se transfieren y se analizan de forma mensual. Para obtener más información, consulta los precios de Trace.

Puedes crear una alerta que te notifique si el 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 para 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 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