Agrega filtros temporales a un panel personalizado

En este documento, se describe cómo puedes cambiar los datos que se muestran en un panel personalizado sin tener que modificar cada widget agregando agrupaciones temporales y filtros temporales. Después de agregar un filtro o una agrupación para todo el panel, la barra de herramientas del panel mostrará un elemento de menú para ese filtro o agrupación.

Cuando solucionas problemas, puedes modificar los datos que muestra un panel agregando agrupamientos o filtros temporales. Por ejemplo, si estás investigando un incidente y quieres que el panel solo muestre datos de una máquina virtual (VM) específica, agrega un filtro temporal.

Los filtros y las agrupaciones temporales se borran automáticamente cuando vuelves a cargar la página. Sin embargo, también puedes borrarlos de forma manual.

También puedes crear filtros permanentes. Por ejemplo, si fijas un filtro, se comportará como un filtro temporal, pero siempre estará disponible. También puedes crear variables, que te permiten aplicar un filtro para seleccionar widgets. Para obtener más información, consulta Crea y administra variables y filtros fijados.

Esta función solo se admite para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para la app.

Cómo funcionan los filtros del panel

Un filtro del panel especifica una etiqueta y un valor. Las series temporales que muestra el panel determinan las etiquetas disponibles para el filtrado. La forma en que un widget admite un filtro para todo el panel depende del tipo de datos que muestra el widget y de su configuración:

  • Para los widgets que muestran datos de series temporales, como los gráficos de líneas, se aplican las siguientes reglas:

    • Si la serie temporal que muestra el widget no admite la etiqueta en un filtro, el filtro aplicado a todo el panel no cambiará los datos que se muestran.

      Por ejemplo, si agregas un filtro en la etiqueta instance_id, pero un gráfico en el panel no muestra datos con una etiqueta instance_id, el filtro no cambiará los datos que se muestran.

    • Si el widget especifica un valor para una etiqueta, el filtro a nivel del panel no cambia los datos que se muestran.

      Por ejemplo, si agregas un filtro en la etiqueta instance_id, pero un gráfico del panel incluye un filtro basado en la etiqueta instance_id, el filtro de todo el panel no cambiará los datos que se muestran.

    • De lo contrario, el gráfico filtra los datos que muestra para incluir solo las series temporales que satisfacen el filtro de todo el panel.

  • En el caso de los widgets del panel de registros, los filtros de todo el panel basados en una etiqueta de recurso actualizan la consulta. Por ejemplo, si agregas el filtro para todo el panel cluster_name: mycluster, la consulta se actualiza para incluir resource.labels."cluster_name"="mycluster".

Puedes agregar varios filtros para todo el panel. Estos filtros se unen con un AND lógico.

Antes de comenzar

Completa lo siguiente en el proyecto Google Cloud en el que deseas ver tus paneles:

Cómo crear o modificar agrupaciones temporales

Cuando agregas agrupaciones para todo el panel, los widgets del panel muestran una serie temporal para cada conjunto de series temporales que tienen los mismos valores para las etiquetas de agrupación. De forma predeterminada, se muestra el promedio de cada conjunto. Sin embargo, cuando el widget define una función de agrupación, se usa esa función.

Por ejemplo, supongamos que tu panel contiene un gráfico que muestra el uso de CPU de tus instancias de VM. Para determinar si necesitas implementar más VMs en una zona en particular, puedes editar el panel y ese gráfico para cambiar sus opciones de agrupación. Otra opción es agrupar temporalmente el panel por zona y, luego, ver el gráfico de uso de CPU.

Para crear o modificar las agrupaciones temporales, haz lo siguiente:

  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 proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para la app.
  3. Expande el menú Agrupar por y, luego, selecciona las etiquetas para agrupar.
  4. Haz clic en Aceptar.

Cuando sales del panel, se descartan todos los agrupamientos que hayas creado.

Cómo crear un filtro temporal

Cuando investigues un incidente, es posible que desees observar los datos de formas específicas. Por ejemplo, es posible que desees ver solo las series temporales de una máquina virtual específica o de los recursos en una región específica. Cuando creas un filtro temporal, todos los widgets del panel se modifican para mostrar los datos que coinciden con ese filtro. Por ejemplo, para configurar todos los gráficos de modo que muestren solo las series temporales de una instancia de VM específica, crea un filtro basado en la etiqueta instance_id. Del mismo modo, para configurar el panel de modo que solo muestre series temporales de una zona específica, crea un filtro basado en la etiqueta zone.

Para crear un filtro temporal, haz lo siguiente:

  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 proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para la app.

  3. En la barra de filtros del panel, haz clic en Agregar filtro y, luego, selecciona una etiqueta del menú.

    En el menú, se enumeran las etiquetas de cada serie temporal que se muestra en el panel.

    Después de seleccionar una etiqueta, se agrega un filtro a la barra de herramientas del panel. El nombre del filtro es el mismo que el de tu selección, y su valor se establece en *, que coincide con todos los valores. Por ejemplo, si seleccionas zone, la barra de herramientas mostrará zone: *.

  4. Para seleccionar un valor específico que coincida, haz clic en el filtro (por ejemplo, zone: *) y, luego, selecciona un valor del menú. Para reducir la cantidad de opciones del menú, ingresa parte del valor en el área Filtro .

Cuando salgas del panel, se descartarán todos los filtros que hayas creado.

Cómo modificar un filtro temporal

Para modificar el valor de un filtro temporal, haz clic en Menú en ese filtro y, luego, realiza una selección.

Después de que realices una selección, se actualizarán los gráficos y las tablas.

Cómo borrar un filtro temporal

Los filtros temporales se borran automáticamente cuando sales del panel. Para quitar manualmente un filtro temporal, haz clic en Borrar en ese filtro.

¿Qué sigue?