Crear y ver informes

Los informes de análisis en Cloud Trace muestran una vista general de la latencia para todas las solicitudes o un subconjunto de solicitudes de tu aplicación.

Informes diarios

Trace crea automáticamente un informe diario que compara el rendimiento del día anterior con el rendimiento del mismo día de la semana anterior para los tres extremos principales.

Para obtener detalles sobre cómo ver el informe de análisis diario, consulta Cómo ver un informe.

Informes de análisis personalizados

El informe de análisis diario se crea automáticamente y no te permite elegir el contenido. Sin embargo, puedes crear un informe de análisis personalizado y seleccionar qué registros se incluyen en él.

Los informes personalizados incluyen la siguiente información:

  • Un histograma de datos de latencia.
  • Una tabla que enumera la latencia por percentiles junto con vínculos a seguimientos de muestra
  • Datos de latencia (opcional) de un período diferente que usas para la comparación
  • Un panel de cuello de botella que enumera las llamadas RPC que contribuyen de forma destacada en la latencia

Para crear un informe nuevo, ingresa los parámetros de forma manual o duplica un informe existente y edita los parámetros. Ambos enfoques se describen en las siguientes secciones.

Cómo crear un informe nuevo

Para crear un informe de análisis nuevo, realiza los siguientes pasos:

  1. En la consola de Google Cloud, ve a la página Analysis Reports:

    Ve a Informes de análisis.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Trace.

  2. Haz clic en Informe nuevo.

  3. Ingresa o selecciona los siguientes parámetros en el formulario que aparece:

    • Request filter: El URI completo, el prefijo de URI o los términos de filtro de seguimiento.

      Por ejemplo, cuando un intervalo raíz del proyecto es Recv, para incluir todas las solicitudes, ingresa el nombre del intervalo raíz, Recv, o un prefijo del nombre del intervalo raíz. Para restringir el informe a los seguimientos con un URI con prefijo Recv/cart, ingresa ese prefijo en el filtro.

      También puedes filtrar seguimientos por atributos de intervalos. Por ejemplo, cuando agregas /http/status_code:5, el informe solo incluye los seguimientos que tienen un intervalo con la clave de atributo /http/status_code y los valores de atributo con el prefijo 5.
    • HTTP method: Es el método HTTP para la solicitud. El filtro predeterminado es Todos.
    • HTTP Status: Es el estado de HTTP que muestra la solicitud. El filtro predeterminado es Todos.
    • Report Name: Es el nombre legible del informe. Cuando no se especifica un nombre para este campo opcional, Trace crea un nombre en función del filtro de solicitud especificado y la hora de creación del informe.
    • Module: Es el módulo de App Engine (Java, Python, Go o PHP) que maneja las solicitudes. El filtro predeterminado es Todos.
    • Version: Es la versión de la aplicación de App Engine que maneja la solicitud. El filtro predeterminado es Todas.
    • Time Range: Es el intervalo de tiempo cuando se realiza la solicitud. Puedes seleccionar Última hora, Últimas 24 horas, Semana anterior o Intervalo personalizado. Cuando seleccionas Personalizado, debes especificar las horas de inicio y finalización del intervalo. El filtro predeterminado es Personalizado.
  4. (Opcional) Para comparar dos conjuntos de datos de latencia, selecciona Comparar con el modelo de referencia y, luego, ingresa el intervalo de tiempo para los datos de comparación.

  5. Haz clic en Enviar.

Cómo duplicar un informe

En Trace, puedes duplicar los parámetros de filtro de un informe existente:

  1. En la consola de Google Cloud, ve a la página Analysis Reports:

    Ve a Informes de análisis.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Trace.

  2. Haz clic en el nombre del informe cuya estructura deseas duplicar.

  3. Haz clic en Crear un informe similar.

  4. En la página Nueva solicitud de informe, edita uno o más parámetros, incluido el nombre del informe.

  5. Haz clic en Enviar.

Cómo ver un informe

Para ver un informe de análisis, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Analysis Reports:

    Ve a Informes de análisis.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Trace.

  2. Para ver un informe, haz clic en su nombre.

Visualiza por distribución de densidad

De forma predeterminada, el botón Distribución de densidad está habilitado. Con este parámetro de configuración, el eje x es la latencia del registro en una escala logarítmica, mientras que el eje y es el porcentaje de solicitudes totales con esa latencia:

Informe de Cloud Trace con latencia que se muestra como un histograma

Cuando creas un informe de comparación, Trace superpone los datos de los dos conjuntos de datos para que puedas compararlos y analizar cualquier cambio:

Informe de comparación de Cloud Trace con latencia que se muestra como un histograma

En el informe de comparación, la leyenda identifica el período para los gráficos naranja y azul. Se omitieron en la captura de pantalla.

Visualiza por distribución acumulativa

Para ver la cantidad total de solicitudes cuya latencia es menor o igual al valor de latencia en el eje x, haz clic en Cumulative distribution:

Informe de Cloud Trace con latencia que se muestra como una distribución acumulativa

Información sobre el panel de latencia

El panel Latencia muestra los percentiles de latencia y, además, incluye vínculos a los seguimientos de las solicitudes de muestra representativa. Para ver los detalles de un seguimiento específico, selecciona uno de los cuatro seguimientos de muestra. Cuando seleccionas uno de los seguimientos de muestra, se abre la página Explorador de seguimientos y se muestra información detallada sobre el intervalo raíz de ese seguimiento. Para obtener más información, consulta Busca y explora seguimientos.

En la siguiente imagen, se muestra un panel de latencia para un informe de análisis. En este caso, solo hay un conjunto de datos, que se indica con la letra A:

Panel de latencia de Cloud Trace.

Cuando creas un informe de comparación, el panel de datos de latencia contiene información de ambos conjuntos de datos. La leyenda del panel identifica las entradas que pertenecen a cada uno de los conjuntos de datos.

Comprende el panel de cuellos de botella

Un Cuello de botella indica que el valor de latencia para un intervalo en un seguimiento específico está fuera del intervalo esperado de valores de latencia. Cloud Trace determina el intervalo esperado de valores de latencia mediante técnicas estadísticas que dependen del procesamiento y la comparación de distribuciones de latencia empíricas para subconjuntos de seguimientos.

El panel Cuellos de botella, cuando está presente, enumera las llamadas RPC que contribuyen de forma significativa en la latencia de las solicitudes. Este panel muestra las llamadas RPC por percentil con las solicitudes de muestra representativa. Puedes hacer clic en un número en Seguimientos de muestra para ver los detalles de un seguimiento específico.

En la siguiente imagen, se muestra un panel Bottlenecks para un informe de análisis. En este caso, solo hay un conjunto de datos, que se indica con la letra A:

Panel de cuellos de botella en las solicitudes de Cloud Trace.

En un informe de comparación, los cuellos de botella destacan las llamadas RPC que generaron cambios en la distribución de latencia entre los dos conjuntos. La leyenda de este panel identifica las entradas que pertenecen a cada uno de los conjuntos de datos.

¿Qué sigue?