Cómo mostrar registros en un panel personalizado

En este documento, se describe cómo mostrar datos de seguimiento en paneles personalizados. Si agregas widgets de seguimiento a tus paneles, puedes crear una vista unificada de solución de problemas que correlacione las latencias de los intervalos con las métricas del sistema y los registros de la aplicación.

Para mostrar los datos de seguimiento en un panel, puedes agregar un widget específico de seguimiento, usar una opción de guardar en la página del Explorador de Trace o usar la API de Cloud Monitoring.

Visualiza datos de seguimiento

La página Explorador de seguimiento proporciona un conjunto preconfigurado de visualizaciones para solucionar problemas. De forma predeterminada, muestra un mapa de calor de las latencias de los intervalos y listas de intervalos individuales o agrupados. Para obtener más información, consulta Busca y explora seguimientos.

Dado que los paneles personalizados son modulares, puedes crear una versión persistente de esta vista integral combinando widgets de seguimiento individuales. Por ejemplo, puedes agregar un widget de mapa de calor junto con tablas separadas para los períodos agrupados y los individuales. Recrear este diseño en un panel te permite supervisar todos los aspectos de tus datos de registro en una sola vista compartida con tu otra telemetría:

Panel que muestra datos de seguimiento.

De forma predeterminada, los widgets de seguimiento muestran datos de los recursos en tu alcance de seguimiento predeterminado. Sin embargo, puedes modificar el alcance de los widgets individuales para buscar diferentes proyectos o enfocarte en grupos de recursos específicos.

Cuando editas un widget de seguimiento, se abre una versión integrada del Explorador de registros. Este editor te permite agregar filtros y modificar las opciones de configuración, tal como lo harías cuando realizas investigaciones, antes de aplicar los cambios persistentes a los mosaicos del panel.

Antes de comenzar

Para obtener los permisos que necesitas para mostrar datos de seguimiento en un panel personalizado, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Puedes colocar hasta 100 widgets en un panel.

Usa la opción de guardar en la página Explorador de seguimiento.

El Explorador de registros ofrece varias visualizaciones de tus datos de registro. Puedes agregar estas visualizaciones a un panel para crear una vista similar.

Para guardar datos del Explorador de Cloud Trace en un panel personalizado, haz lo siguiente:

  1. En la consola de Google Cloud , ve a la página Explorador de seguimiento:

    Ve al Explorador de seguimiento

    También puedes usar la barra de búsqueda para encontrar esta página.

  2. En la barra de herramientas, selecciona Guardar en el panel.

  3. Selecciona el estilo de visualización. Tienes las siguientes opciones:

    • Visualizador: Agrega un mapa de calor a tu panel.
    • Tabla de tramos: Agrega una tabla de tramos individuales a tu panel.
    • Tabla de intervalos agrupados: Agrega una tabla de intervalos agrupados a tu panel.

  4. Selecciona o crea un panel.

  5. Haz clic en Guardar en el panel.

Agrega un widget de seguimiento a un panel personalizado

En esta sección, se describe cómo mostrar datos de seguimiento en un panel personalizado. Estas instrucciones son para la consola de Google Cloud y suponen que estás editando un panel. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel que muestra datos de seguimiento.

Para mostrar los datos de seguimiento en un panel personalizado, haz lo siguiente:

  1. Abre un panel personalizado:

    1. En la consola de Google Cloud , accede a la página Paneles :

      Acceder a Paneles

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

    2. En la barra de herramientas de la consola de Google Cloud , selecciona tu Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

    3. Selecciona un panel o haz clic en Crear panel.

      Si creas un panel, usa el menú Alcance para configurar qué recursos se buscan para obtener datos de seguimiento. De forma predeterminada, el sistema busca los recursos en el permiso de seguimiento predeterminado para obtener datos de seguimiento.

  2. En la barra de herramientas, haz clic en  Agregar widget.

  3. En el diálogo Agregar widget, ve a la sección Datos y selecciona Rastreo.

  4. Configura el widget Registro. Puedes cambiar la vista predeterminada, el título y agregar filtros.

    • Para cambiar la vista, en la barra de herramientas, expande el menú Vista del gráfico y selecciona una vista:

      • Para agregar un mapa de calor (opción predeterminada), selecciona Duración de intervalo (mapa de calor).
      • Para mostrar la tasa de intervalos, selecciona Frecuencia de intervalo (gráfico de líneas).
      • Para mostrar los datos de latencia, selecciona Duración del intervalo (percentil).
      • Para mostrar los intervalos en formato tabular, selecciona Tasa de intervalos (gráfico de líneas) o Duración del intervalo (percentil) y usa el menú Tipo de widget para mostrar una tabla. Los selectores te permiten mostrar datos agrupados o desagrupados.

    • Para restringir los registros que se muestran, agrega filtros.

    • Para actualizar el título, ingresa el título nuevo en el campo Título del widget.

  5. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

  6. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Cómo modificar o editar un widget que muestra datos de seguimiento

Para modificar un widget, mantén el puntero sobre él para activar la barra de herramientas y, luego, haz clic en  Editar widget.

Se abrirá un editor de Trace Explorer. Desde esta vista, puedes agregar o quitar filtros, y modificar cualquier opción de configuración. Luego, puedes aplicar los cambios al panel o descartarlos.

Limitaciones

  • Los filtros a nivel del panel no se aplican a los widgets de seguimiento.
  • No puedes aplicar una variable a la consulta de un widget de seguimiento.

¿Qué sigue?