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 en todo el panel, la barra de herramientas del panel muestra un elemento de menú para esa agrupación o filtro.

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

Los grupos y filtros 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, este se comportará como un filtro temporal, excepto que siempre estará disponible. También puedes crear variables, que te permiten aplicar un filtro a widgets seleccionados. Para obtener más información, consulta Cómo crear y administrar variables y filtros fijos.

Cómo funcionan los filtros del panel

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

• En el caso de los widgets que muestran datos de series temporales, como un gráfico 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 del panel completo no cambia los datos que se muestran.

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

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

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

  • De lo contrario, el gráfico filtra los datos que muestra solo a aquellas series temporales que satisfacen el filtro del panel.

• En el caso de los widgets del panel de registros, los filtros del panel que se basan 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 en todo el panel. Estos filtros se unen con un Y lógico.

Antes de comenzar

Para obtener los permisos que necesitas para agregar o modificar filtros temporales con la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de IAM Visualizador de Monitoring (roles/monitoring.viewer) en tu proyecto. 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 mediante roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles, consulta Controla el acceso con Identity and Access Management.

Crea o modifica agrupaciones temporales

Cuando agregas agrupaciones en 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. Una alternativa es agrupar temporalmente el panel por zona y, luego, ver el gráfico de uso de la CPU.

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

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

   Dirígete a Paneles de control

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

2. Expande el menú Agrupar por de y, luego, selecciona las etiquetas para agrupar.
3. Haz clic en Aceptar.

Cuando salgas del panel, se descartarán todas las agrupaciones que hayas creado.

Crea un filtro temporal

Cuando investigues un incidente, te recomendamos que mires 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 recursos en una región específica. Cuando creas un filtro temporal, se modifican todos los widgets del panel 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 las 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, ve a la página  Paneles.

   Dirígete a Paneles de control

   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 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 tiene el mismo nombre que 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: *.

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

Nota: En el caso de las tablas que muestran datos de series temporales, algunas celdas contienen un botón Filtrar panel a este valor, que se hace visible cuando colocas el puntero en la celda. Si seleccionas este botón, se aplica un filtro nuevo o se actualiza el valor de un filtro o una variable permanente existente. Los filtros y las variables existentes se actualizan cuando la clave de etiqueta de la columna de la tabla coincide con la clave de etiqueta de un filtro o una variable.

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

Cómo modificar un filtro temporal

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

Después de hacer una selección, se actualizan 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 un filtro temporal de forma manual, haz clic en Borrar en ese filtro.

¿Qué sigue?

• Explora los datos representados
• Accede a paneles específicos de recursos
• Cómo crear y administrar variables y filtros fijados