Agrega filtros temporales a un panel personalizado

En este documento, se describe cómo cambiar los datos que se muestran en una aplicación panel de control, sin tener que modificar cada widget, agregando agrupaciones temporales y filtros temporales. Después de agregar una agrupación o un filtro para 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 agregando agrupaciones o filtros temporales. Por ejemplo, si estás investigando y quieres que el panel solo muestre los datos máquina virtual (VM) y, luego, agrega un filtro temporal.

Las agrupaciones y los filtros temporales se se borran cuando vuelves a cargar la página; pero también puedes borrarlos manualmente.

Para obtener información sobre cómo crear filtros permanentes, consulta Agrega filtros permanentes a los paneles personalizados.

Cómo funcionan los filtros del panel

Un filtro de panel especifica una etiqueta y un valor. Las series temporales a las que las pantallas del 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 se muestra el widget y su configuración:

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

  • Si la serie temporal que muestra el widget no admite la etiqueta en una filtro, 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 no muestra datos con una etiqueta instance_id; entonces, el filtro no cambia los datos que se muestran.

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

    Por ejemplo, si agregas un filtro en la etiqueta instance_id, pero un gráfico incluye un filtro basado en la etiqueta instance_id y, luego, el filtro para todo el panel no cambia los datos que se muestran.

  • De lo contrario, el gráfico filtrará los datos que se mostrarán solo para aquellos que satisfacen el filtro de todo el panel.

• Para los widgets del panel de registros, los filtros de todo el panel que se basan en un la etiqueta de recurso actualiza la consulta. Por ejemplo, si agregas el filtro para todo el panel cluster_name: mycluster, entonces la consulta será para incluir resource.labels."cluster_name"="mycluster".

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

Antes de comenzar

A fin de obtener los permisos que necesitas para agregar o modificar filtros temporales con la consola de Google Cloud, solicita 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.

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 para todo el panel, los widgets en el panel una serie temporal para cada conjunto de series temporales que tengan los mismos valores para la 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 y, luego, se usa esa función.

Por ejemplo, supongamos que tu panel contiene un gráfico en el que se 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 la panel y ese gráfico para cambiar sus opciones de agrupación. Una alternativa es agrupar temporalmente el panel por zona y, luego, ver 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.

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

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

Crear un filtro temporal

Cuando estés investigando un incidente, es posible que desees ver los datos de maneras específicas. Por ejemplo, es posible que quieras ver solo las series temporales para una máquina virtual específica o para recursos en una región específica. Cuándo creas un filtro temporal, todos los widgets del panel se modifican datos que coincidan con ese filtro. Por ejemplo, si deseas configurar todos los gráficos para que muestren solo las series temporales de un Instancia de VM, crea un filtro basado en la etiqueta instance_id. Del mismo modo, configurar el panel para que solo muestre series temporales para una zona específica, crear una 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 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 está establecido. como *, que coincide con todos los valores. Por ejemplo, si seleccionas zone, entonces la barra de herramientas muestra zone: *.

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

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

Agrega filtros temporales que coincidan con una serie temporal

Si quieres obtener más información sobre una serie temporal específica 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 y que coincidan el recurso de la serie temporal o que coinciden 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 los objetos CPU utilization y Disk read bytes métricas para 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 quieras aplicar el conjunto de etiquetas más restrictivo, filtra por todas las etiquetas. Con esta opción, las etiquetas identifican un 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.

   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. Identifica el gráfico y haz clic en el ícono para expandir la leyenda a fin de ver más detalles  Expandir leyenda.
3. Desplázate por la leyenda hasta que encontrar la serie temporal específica de interés haz clic en Acciones para esta serie temporal. Luego, selecciona Filtrar el 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, el se agregaron 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, en el gráfico de la métrica CPU utilization, se puede observar lo siguiente: una sola serie temporal. Este comportamiento se debe a que agregaste filtros que coinciden las etiquetas de series temporales. 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 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, el se agregaron 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 un solo series temporales.

Filtrar por etiquetas de recursos de una serie temporal

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

Para aplicar filtros temporales que identifiquen el recurso para un evento específico series temporales que muestra un gráfico, 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. Identifica el gráfico y haz clic en el ícono para expandir la leyenda a fin de ver más detalles  Expandir leyenda.
3. Desplázate por la leyenda hasta que encontrar la serie temporal específica de interés haz clic en Acciones para esta serie temporal. 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 y, luego, 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, se muestra un gráfico puede mostrar varias series temporales.

Debido a que la opción Filtrar panel según etiquetas de recursos solo aplica recursos etiquetas 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 de las etiquetas de una métrica. Por ejemplo, cuando observas métricas de balanceo de cargas, es posible que desees ver que son solo para un protocolo específico.

Para aplicar filtros temporales que identifiquen la métrica para un series temporales que muestra un gráfico, 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. Identifica el gráfico y haz clic en el ícono para expandir la leyenda a fin de ver más detalles  Expandir leyenda.
3. Desplázate por la leyenda hasta que encontrar la serie temporal específica de interés haz clic en Acciones para esta serie temporal. y, luego, selecciona Filtrar el 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 y, luego, filtro basado en la etiqueta que se agregó instance_name. En este caso, es posible que ambos gráficos muestren varias series temporales porque el valor de la etiqueta instance_name. Es decir, puedes Tener varias VMs 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 la Panel de ejemplo, se agregan cuatro filtros. Estos filtros corresponden a las etiquetas de la métrica Disk read bytes.

Cuando los filtros temporales solo incluyen filtros de métricas, ver las series temporales para esa métrica, independientemente del recurso en el que se escribió la serie temporal. Porque 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 se muestran ambos gráficos dos series temporales.

Cómo modificar o borrar un filtro temporal

Los filtros temporales se eliminan automáticamente cuando sales de la o un panel dinámico más robusto. Para quitar manualmente un filtro temporal, en ese filtro, Haz clic en Borrar.

¿Qué sigue?

• Explora los datos del gráfico
• Accede a paneles específicos de los recursos
• Agrega filtros permanentes a los paneles personalizados