Agrega filtros temporales a un panel personalizado

En este documento, se describe cómo cambiar los datos que se muestran en un panel personalizado (sin tener que modificar cada widget) con 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 los problemas, puedes modificar los datos que muestra un panel si agregas agrupaciones o filtros temporales. Por ejemplo, si investigas un incidente y deseas que el panel solo muestre los datos de una máquina virtual (VM) específica, agrega un filtro temporal.

Las agrupaciones y los filtros temporales se borran automáticamente 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.

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 manera en que un widget admite un filtro en todo el panel depende del tipo de datos que muestra 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 son compatibles con la etiqueta en un filtro, el filtro de 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 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 de 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 del panel incluye un filtro basado en la etiqueta instance_id, el filtro de todo el panel no cambia los datos que se muestran.

    • De lo contrario, el gráfico filtra los datos que muestra solo para 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 que se basan en una etiqueta de recurso actualizan la consulta. Por ejemplo, si agregas el filtro cluster_name: mycluster para todo el panel, la consulta se actualizará para incluir resource.labels."cluster_name"="mycluster".

Puedes agregar varios filtros para 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 al 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 mediante funciones personalizadas, o bien otras funciones predefinidas.

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

Crear o modificar agrupaciones temporales

Cuando agregas agrupaciones en todo el panel, los widgets muestran una serie temporal por 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 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 el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Paneles:

    Ir a Paneles

  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 ver los datos de maneras específicas. Por ejemplo, es posible que desees ver solo series temporales de una máquina virtual específica o de 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 a fin de que muestren solo las series temporales de una instancia de VM específica, crea un filtro basado en la etiqueta instance_id. De manera similar, si quieres configurar el panel para 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 el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Paneles:

    Ir a Paneles

  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 muestra zone: *.

  3. Para seleccionar un valor específico 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 de 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

Cuando desees 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, que coincidan con el recurso de las series temporales o que coincidan 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 de las instancias de VM de Compute Engine. En la siguiente captura de pantalla, se muestra este panel para un sistema:

Pantalla del panel Ejemplo.

Filtrar 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 y un conjunto de valores únicos 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 el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Paneles:

    Ir a Paneles

  2. Identifica el gráfico y expande la leyenda para ver más detalles haciendo clic en  Expandir leyenda.
  3. Desplázate por la leyenda hasta que encuentres la serie temporal específica que te interesa, haz clic en Acciones para esta serie temporal y, luego, selecciona Filtrar panel de 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 la 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:

Se muestra el panel Ejemplo con filtros para todas las etiquetas de una serie temporal de uso de CPU.

En la figura anterior, el gráfico en el que se 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 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 posible que varias series temporales de este gráfico se refieran a la misma instancia.

A modo de comparación, cuando los pasos anteriores se aplican 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

Se muestra el panel Ejemplo con filtros para todas las etiquetas de una serie temporal de bytes de lectura de disco.

Como se muestra en la captura de pantalla anterior, ambos gráficos ahora 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 mostrar series temporales de un recurso específico. Ahora puedes ver solo las métricas de ese recurso y quitar temporalmente de la pantalla las series temporales que no te interesan.

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

  1. En el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Paneles:

    Ir a Paneles

  2. Identifica el gráfico y expande la leyenda para ver más detalles haciendo clic en  Expandir leyenda.
  3. Desplázate por la leyenda hasta que encuentres la serie temporal específica que te interesa, haz clic en Acciones para esta serie temporal y, luego, selecciona Filtrar el 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 para el recurso, una instancia de VM:

Se muestra el panel Ejemplo con filtros para las etiquetas de recursos de una serie temporal de uso de CPU.

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 Panel de filtro para etiquetas de recursos aplica solo 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.

Filtra 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 ves las métricas de balanceo de cargas, es posible que desees ver series temporales que son solo para un protocolo específico.

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

  1. En el panel de navegación de la consola de Google Cloud, selecciona Monitoring y, luego, elige  Paneles:

    Ir a Paneles

  2. Identifica el gráfico y expande la leyenda para ver más detalles haciendo clic en  Expandir leyenda.
  3. Desplázate por la leyenda hasta que encuentres la serie temporal específica que te interesa, 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, se agrega un filtro basado en la etiqueta instance_name. En este caso, es posible que ambos gráficos muestren varias series temporales porque el valor de la etiqueta instance_name se puede configurar. Es decir, puedes tener varias VM con el mismo valor para la etiqueta instance_name.

A modo de comparación, cuando los pasos anteriores se aplican 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étricas, ves series temporales para esa métrica, sin importar el recurso en el que se escribió la serie temporal. Debido a que no restringes 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, en ese filtro, haz clic en Borrar.

¿Qué sigue?