Cómo agregar 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. Para ello, agrega 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 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 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 manera en que un widget admite un filtro en todo el panel depende del tipo de datos que muestra y de su configuración:

  • En el caso de los widgets que muestran datos de series temporales, como los 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 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 a aquellas 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 de todo el panel cluster_name: mycluster, entonces 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 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 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 los roles personalizados o de otros roles predefinidos.

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

Cómo 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 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. Haga clic en Aceptar.

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

Crea un filtro temporal

Cuando investigas un incidente, es posible que desees consultar 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 de los recursos de una región específica. Cuando creas un filtro temporal, todos los widgets del panel se modifican para mostrar datos que coinciden con ese filtro. Por ejemplo, si deseas 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ú muestra 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, en zone: * y, luego, selecciona un valor del menú. Para reducir la cantidad de opciones de menú, ingresa parte del valor en el área Filtrar.

Cuando sales del panel, se descartan todos 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 para las instancias de VM de Compute Engine. En la siguiente captura de pantalla, se muestra el panel de un sistema:

Se muestra el panel Example.

Filtra por todas las etiquetas de una serie temporal

Cuando desees aplicar el conjunto de etiquetas más restrictivo, fíltralo 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 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 para 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 series temporales de uso de CPU.

En la figura anterior, en el gráfico en el que se muestra la métrica CPU utilization, se 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 hagan referencia a la misma instancia.

Como 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 series temporales de bytes de lectura de un disco.

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

Filtra 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 las métricas solo para 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 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 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 estos pasos se realizan 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:

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 por etiquetas de recursos solo aplica etiquetas de recursos a la barra de filtro temporal, el resultado es el mismo cuando seleccionas esta opción de 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 de las etiquetas de una métrica. Por ejemplo, cuando ves las métricas de balanceo de cargas, es posible que desees ver las 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 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 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 estos pasos se realizan 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.

Como 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 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, en ese filtro, haz clic en Borrar.

¿Qué sigue?