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

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

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

Para obtener información sobre cómo crear filtros permanentes, consulta [Agrega filtros permanentes a los paneles personalizados][permanent-filter].

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 el widget y de su configuración:

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

  • Si las series temporales que muestra el widget no admiten la etiqueta en un filtro, el filtro de 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 cambia los datos que se muestran.

  • Si el widget especifica un valor para una etiqueta, el filtro para 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 incluye un filtro basado en la etiqueta instance_id, el filtro para todo el panel no cambiará los datos que se muestran.

  • De lo contrario, el gráfico filtrará los datos que muestra solo para las series temporales que cumplan con el filtro de todo el panel.

• Para los widgets del panel de registros, los filtros de todo el 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 actualizará para incluir resource.labels."cluster_name"="mycluster".

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

Antes de comenzar

Si quieres 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 de Visualizador de Monitoring (roles/monitoring.viewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de funciones personalizadas o, también, otras funciones predefinidas.

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

Crea o modifica agrupaciones temporales

Cuando agregas agrupaciones en todo el panel, los widgets en este muestran una serie temporal para cada conjunto de series temporales que tengan 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 el panel contiene un gráfico que muestra el uso de CPU de tus instancias de VM. Para determinar si necesitas implementar más VM en una zona en particular, puedes editar el panel y ese gráfico para cambiar sus opciones de agrupación. Una alternativa es agrupar de forma temporal 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, ve a la página  Paneles.

   Ir a Paneles

   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 y, luego, selecciona las etiquetas para agrupar.
3. Haz clic en OK.

Cuando sales del panel, se descartan las agrupaciones que creaste.

Crear un filtro temporal

Cuando investigas un incidente, es posible que desees analizar los datos de maneras específicas. Por ejemplo, es posible que desees ver solo las series temporales de una máquina virtual específica o los recursos de una región específica. Cuando creas un filtro temporal, todos los widgets del panel se modifican para mostrar datos que coincidan con ese filtro. Por ejemplo, a fin de configurar todos los gráficos para 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, si quieres configurar el panel para 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, ve a la página  Paneles.

   Ir 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 filtros del panel, haz clic en Agregar filtro y, luego, selecciona una etiqueta del menú.

   El menú enumera las etiquetas para 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. Si deseas seleccionar un valor específico para que coincida, haz clic en el filtro, por ejemplo, haz clic 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.

Cuando sales del panel, se descartan los filtros que creaste.

Agrega filtros temporales que coincidan con una serie temporal

Si deseas obtener más información sobre una serie temporal específica que se muestra en un gráfico, puedes usar la leyenda del gráfico para aplicar filtros temporales. Puedes aplicar filtros que coincidan con las etiquetas específicas de la serie temporal, con el recurso de la serie temporal o solo con las etiquetas de la métrica. En esta sección, se describen esas opciones.

Panel de ejemplo

Para ayudar a describir el comportamiento de las diferentes opciones, considera un panel que muestre las métricas CPU utilization y Disk read bytes para las instancias de VM de Compute Engine. En la siguiente captura de pantalla, se muestra este panel para un sistema:

Filtra por todas las etiquetas de una serie temporal

Cuando desees aplicar el conjunto de etiquetas más restrictivo, filtra por todas las etiquetas. Con esta opción, las etiquetas identifican un recurso único y un conjunto único de valores para las etiquetas de la métrica.

Para aplicar filtros temporales que identifiquen una serie temporal específica en un gráfico, haz lo siguiente:

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

   Ir a Paneles

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

2. Identifica el gráfico y haz clic en  Expandir leyenda para expandir la leyenda a fin de ver más detalles.
3. Desplázate por la leyenda hasta encontrar la serie temporal específica de interés, haz clic en Acciones para esta serie temporal y, luego, selecciona Filtrar panel en todas las etiquetas.

Por ejemplo, cuando estos pasos se aplican al gráfico que muestra la métrica CPU utilization para el panel de ejemplo, se agregan los siguientes filtros:

• Etiqueta de métrica: instance_name.

• Etiquetas de recursos para instancias de VM de Compute Engine:

  • project_id
  • instance_id
  • zone

En la siguiente captura de pantalla, se muestra el resultado:

En la figura anterior, el gráfico que muestra la métrica CPU utilization muestra una sola serie temporal. Este comportamiento se debe a que agregaste filtros que coinciden con las etiquetas de serie temporal. Sin embargo, el gráfico que muestra la métrica Disk read bytes muestra varias series temporales. La métrica Disk read bytes contiene tres etiquetas además de la etiqueta instance_name, por lo que es posible que varias series temporales de este gráfico hagan referencia a la misma instancia.

A modo de comparación, cuando se aplican los pasos anteriores al gráfico que muestra la métrica Disk read bytes para el panel de ejemplo, se agregan los siguientes filtros:

• Etiquetas de métrica

  • instance_name
  • device_name
  • storage_type
  • device_type

• Etiquetas de recursos para instancias de VM de Compute Engine:

  • project_id
  • instance_id
  • zone

Como se muestra en la captura de pantalla anterior, ahora ambos gráficos muestran una sola serie temporal.

Filtrar por etiquetas de recursos de una serie temporal

Cuando filtras por todas las etiquetas de recursos, restringes el panel para que muestre series temporales de un recurso específico. Ahora puedes ver las métricas solo para ese recurso y eliminar temporalmente de la pantalla aquellas series temporales que no son de interés.

Para aplicar filtros temporales que identifiquen el recurso para una serie temporal específica que muestra un gráfico, haz lo siguiente:

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

   Ir a Paneles

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

2. Identifica el gráfico y haz clic en  Expandir leyenda para expandir la leyenda a fin de ver más detalles.
3. Desplázate por la leyenda hasta que encuentres la serie temporal específica de interés, haz clic en Acciones para esta serie temporal y, luego, selecciona Filtrar panel por etiquetas de recursos.

Por ejemplo, cuando se realizan estos pasos en el gráfico que muestra la métrica CPU utilization para el panel de ejemplo, se agregan tres filtros. Estos filtros corresponden a las etiquetas del recurso, una instancia de VM:

Como se ilustra en la captura de pantalla anterior, cuando filtras por recurso, un gráfico puede mostrar varias series temporales.

Debido a que la opción Filtrar panel en las etiquetas de recursos solo aplica etiquetas de recursos a la barra de filtros temporal, el resultado es el mismo cuando seleccionas esta opción en cualquiera de los gráficos.

Filtrar por etiquetas de métrica de una serie temporal

Esta opción te permite aplicar filtros que coincidan con los valores para las etiquetas de una métrica. Por ejemplo, cuando visualizas las métricas de balanceo de cargas, es posible que desees ver las series temporales que son solo para un protocolo específico.

Para aplicar filtros temporales que identifiquen la métrica para una serie temporal específica que muestra un gráfico, haz lo siguiente:

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

   Ir a Paneles

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

2. Identifica el gráfico y haz clic en  Expandir leyenda para expandir la leyenda a fin de ver más detalles.
3. Desplázate por la leyenda hasta que encuentres la serie temporal específica de interés, haz clic en Acciones para esta serie temporal y, luego, selecciona Filtrar panel por etiquetas de métricas.

Por ejemplo, cuando se realizan estos pasos en el gráfico que muestra la métrica CPU utilization para el panel de ejemplo, se agrega un filtro basado en la etiqueta instance_name. En este caso, es posible que ambos gráficos muestren varias series temporales porque se puede configurar el valor de la etiqueta instance_name. Es decir, puedes tener varias VM con el mismo valor para la etiqueta instance_name.

A modo de comparación, cuando se aplican los pasos anteriores al gráfico que muestra la métrica Disk read bytes para el panel de ejemplo, se agregan cuatro filtros. Estos filtros corresponden a las etiquetas de la métrica Disk read bytes.

Cuando tus filtros temporales solo incluyen filtros de métrica, verás series temporales para esa métrica, sin importar el recurso en el que se escribió la serie temporal. Debido a que no estás restringiendo las series temporales a un recurso específico, es posible que veas varias series temporales en un gráfico. En la captura de pantalla anterior, se ilustra este comportamiento, ya que ambos gráficos muestran dos series temporales.

Cómo modificar o 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 del gráfico
• Accede a paneles específicos de los recursos
• Agrega filtros permanentes a los paneles personalizados