Filtrar un panel personalizado

En este documento, se describe cómo puedes agregar variables de filtro, filtros y agrupaciones a tus paneles personalizados. Para crear un filtro que dure solo para tu sesión actual, agrega un filtro temporal. También puedes crear filtros permanentes. Los filtros permanentes se pueden aplicar a todo el panel o, cuando especificas una variable de plantilla, solo para seleccionar widgets de panel. Por último, a fin de agregar series temporales para todos los widgets en un panel, agrega una agrupación temporal.

Cuando un panel personalizado está en modo de solo lectura, se muestran los filtros y agrupaciones a nivel del panel, junto con los menús. Puedes usar estos menús para cambiar el valor actual del filtro; sin embargo, los cambios que realices solo se aplicarán a la sesión actual.

Las instrucciones que se indican en este documento corresponden a Google Cloud Console. Para obtener información sobre cómo agregar variables de plantilla y filtros permanentes a los paneles personalizados con la API de Cloud Monitoring, consulta Filtros del panel.

Cómo funcionan los filtros del panel

Los filtros del panel de control comparan una etiqueta con un valor. Las etiquetas de la serie temporal que muestra tu panel determinan las etiquetas disponibles para el filtrado. Por ejemplo, puedes filtrar por la etiqueta instance_id cuando un panel muestra datos para una instancia de VM.

Un filtro del panel se aplica a un gráfico solo cuando el gráfico admite la etiqueta de filtro y cuando el gráfico no especifica un valor para esa etiqueta. Por ejemplo, cuando un gráfico incluye el filtro zone = us-central1-a, ese gráfico ignora un filtro de panel en función de la etiqueta zone. Del mismo modo, los gráficos sin una etiqueta zone ignoran los filtros del panel con esta etiqueta.

Cuando agregas varios filtros, los widgets solo muestran las series temporales que satisfacen todos los filtros.

Prácticas recomendadas

Para modificar de forma temporal qué datos muestra un panel, agrega filtros o agrupaciones temporales. Por ejemplo, cuando investigas un incidente y deseas que el panel solo muestre los datos de una máquina virtual (VM) específica, agrega un filtro temporal.

Si deseas definir una presentación predeterminada de los datos en un panel junto con las opciones controladas por el menú para modificar esa visualización, agrega filtros permanentes. Por ejemplo, cuando quieras ver las métricas de todas las zonas y también quieres ver las métricas de una zona específica, crea un filtro permanente basado en la etiqueta zone. Existen dos tipos de filtros permanentes:

  • Un filtro que se aplica a todos los widgets del panel es un filtro del Panel.
  • Un filtro que se aplica a algunos widgets de panel es una variable de plantilla.

Antes de comenzar

  • A fin de obtener los permisos que necesitas para agregar o modificar filtros temporales mediante Google Cloud Console, pídele a tu administrador que te otorgue la función 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.

  • A fin de obtener los permisos que necesitas para agregar o modificar filtros permanentes mediante Google Cloud Console, pídele a tu administrador que te otorgue la función de Editor de IAM (roles/monitoring.editor) 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 las funciones, consulta Controla el acceso con la administración de identidades y accesos.

Agregar un filtro temporal

Cuando investigas un incidente, es posible que desees ver los datos de formas específicas. Por ejemplo, es posible que solo quieras ver series temporales para una máquina virtual específica o recursos en una región específica. Cuando agregas un filtro temporal, todos los widgets del panel se modifican para mostrar los datos que coinciden con ese filtro. Por ejemplo, a fin de configurar todos los gráficos para que muestren solo series temporales para una instancia de VM específica, agrega un filtro basado en la etiqueta instance_id. Del mismo modo, a fin de configurar el panel para que solo muestre series temporales para una zona específica, agrega un filtro basado en la etiqueta zone.

Para agregar un filtro temporal, haz lo siguiente:

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Cerrar editor, haz clic en él.

  4. 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 un filtro con el nombre de zone.

  5. Para seleccionar un valor específico con el que establecer la coincidencia, en el filtro, haz clic en Menú y, luego, selecciona un valor del menú. Para reducir la cantidad de opciones de menú, ingresa parte del valor en el área Filtro.

Cuando abres el editor del panel o sales del panel, se descartan todos los filtros que agregaste.

Agrega filtros temporales que coincidan con una serie temporal

Cuando desees 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 las series temporales, que coincidan con los recursos de las series temporales 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 usar un panel en el que se muestren 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 de ejemplo.

Filtrar 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 recurso único y un conjunto único de valores para las etiquetas de la métrica.

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

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Cerrar editor, haz clic en él.
  4. Identifica el gráfico y haz clic en Expandir leyenda para expandir la leyenda y ver más detalles.

  5. Agrega los filtros temporales:

    1. Desplázate por la leyenda hasta que encuentres la serie temporal específica de interés.
    2. Haga clic en Acciones para esta serie temporal.
    3. Selecciona Filtrar el panel para ver 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 ilustra el resultado:

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

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 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 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

Se muestra el panel de 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 las series temporales de un recurso específico. Ahora puedes ver las métricas de ese recurso y borrar de forma temporal de la pantalla las series temporales que no te interesan.

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

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Cerrar editor, haz clic en él.
  4. Identifica el gráfico y haz clic en Expandir leyenda para expandir la leyenda y ver más detalles.

  5. Agrega los filtros temporales:

    1. Desplázate por la leyenda hasta que encuentres la serie temporal específica de interés.
    2. Haz clic en Más opciones.
    3. Selecciona Filtrar panel para ver las etiquetas de los recursos.

    Cuando agrupas series temporales, es posible que esta opción no esté disponible.

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 de 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 Filtrar panel a etiquetas de recursos solo aplica etiquetas de recursos a la barra de filtros temporales, 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 coinciden con los valores de las etiquetas de una métrica. Por ejemplo, cuando visualizas métricas de balanceo de cargas, es posible que desees ver series temporales que son solo para un protocolo específico.

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

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Cerrar editor, haz clic en él.
  4. Identifica el gráfico y haz clic en Expandir leyenda para expandir la leyenda y ver más detalles.

  5. Agrega los filtros temporales:

    1. Desplázate por la leyenda hasta que encuentres la serie temporal específica de interés.
    2. Haz clic en Más opciones.
    3. Selecciona Filtrar panel para etiquetas de métrica.

    Cuando agrupas series temporales, es posible que esta opción no esté disponible.

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.

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 para la métrica Disk read bytes.

Cuando tus filtros temporales solo incluyen filtros de métricas, verás series temporales para esa métrica, sin importar el recurso en el que se escribieron las series temporales. 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 de forma automática cuando abres el editor de panel o sales del panel.

Para modificar o quitar un filtro temporal mientras estás en un panel y se muestra el botón Editar panel, haz lo siguiente:

  1. Haz clic en Menú en el filtro que deseas modificar o quitar.
  2. Selecciona una opción del menú. Para quitar el filtro, desplázate hasta el final de la lista y haz clic en Quitar filtro.

Crear un filtro permanente

Cuando diseñas un panel, puedes identificar varias formas de ver los datos que se muestran. Por ejemplo, cuando un panel muestra métricas de instancias de VM, es posible que desees ver las métricas de todas las VM y las métricas de las VM de una zona específica. Puedes crear un filtro permanente para todo el panel para la etiqueta zone con el conjunto predeterminado en todas las zonas, *. Cuando veas el panel, puedes usar el menú del filtro zone para seleccionar una zona específica.

Para restringir un filtro permanente a widgets específicos, crea una variable de plantilla. Imagina una situación en la que deseas una vista en paralelo de las métricas para las VM en dos zonas diferentes. Construyes dos colecciones de gráficos y creas una variable de plantilla para cada colección. Tu configuración predeterminada satisface tu objetivo original. Sin embargo, cuando ves el panel, la barra de herramientas enumera tus variables, además de menús que te permiten seleccionar diferentes valores. Puedes usar estos menús para ver los datos de diferentes zonas.

Para crear un filtro permanente, haz lo siguiente:

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Si no aparece una lista de filtros en la parte superior del panel, haz clic en Editar filtros del panel en la barra de herramientas del panel.

  5. Realice una de las siguientes acciones:

    • Para agregar un filtro que se aplique a todos los widgets del panel, haz lo siguiente:

      1. Junto al texto Filtros del panel, haz clic en Agregar.
      2. Selecciona una etiqueta del menú Etiqueta.
      3. Selecciona un valor del menú Valor predeterminado (Default value). Para hacer coincidir todos los valores, elige *.

    • Para agregar un filtro que se aplique a algunos widgets en el panel, haz lo siguiente:

      1. Junto al texto Variables de plantilla, haz clic en Agregar.

      2. Ingresa un nombre para la variable en el cuadro de texto Variable de plantilla.

        El nombre que ingreses se mostrará en el panel cuando se cierre el editor. También se muestra en el campo Template variable del panel de configuración de un widget.

      3. Selecciona una etiqueta del menú Etiqueta.

      4. Selecciona un valor del menú Valor predeterminado (Default value). Para hacer coincidir todos los valores, elige *.

      5. Expande el menú Aplicar a los gráficos y selecciona los gráficos a los que se aplicará el filtro.

  6. Opcional: Para ocultar la lista de filtros del panel, haz clic en Editar filtros del panel.

  7. Haz clic en Cerrar editor.

    La barra de herramientas del panel muestra el nuevo filtro permanente. Para los filtros de todo el panel, el nombre del filtro coincide con el nombre de la etiqueta. Para las variables de plantilla, el nombre del filtro coincide con el nombre de la variable.

  8. Opcional: Para cambiar temporalmente el valor del filtro, realiza una selección en el menú.

Cómo modificar un filtro permanente

Cuando un panel no se puede editar, se muestran filtros permanentes en la barra de herramientas del panel. Para cambiar el valor de un filtro de manera temporal, usa su menú.

Para cambiar la configuración de un filtro permanente, haz lo siguiente:

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Si no aparece una lista de filtros en la parte superior del panel, haz clic en Editar filtros del panel en la barra de herramientas del panel.
  5. Busca el filtro que deseas modificar y, luego, usa los menús para realizar las modificaciones.
  6. Opcional: Para ocultar la lista de filtros del panel, haz clic en Editar filtros del panel.
  7. Haz clic en Cerrar editor.

Borrar un filtro permanente

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Editar panel, haz clic en él.
  4. Si no aparece una lista de filtros en la parte superior del panel, haz clic en Editar filtros del panel en la barra de herramientas del panel.
  5. Busca el filtro que deseas quitar y, luego, haz clic en Borrar.
  6. Opcional: Para ocultar la lista de filtros del panel, haz clic en Editar filtros del panel.
  7. Haz clic en Cerrar editor.

Cómo aplicar una variable de plantilla a un widget

Para aplicar una variable de plantilla a un widget que se configura con el lenguaje de consulta de Monitoring o PromQL, haz lo siguiente:

  1. Selecciona el widget para activar el panel de configuración.
  2. Modifica la string de consulta del widget para incluir la variable de plantilla. Para obtener información sobre la sintaxis, consulta Crea y administra paneles por API: Filtros del panel.

Para aplicar una variable de plantilla a un widget que se configura mediante las pestañas Básico o Avanzado, realiza una de las siguientes acciones:

Para ver ejemplos de cómo agregar variables de plantilla a un widget cuando usas la API de Cloud Monitoring, consulta Crea y administra paneles mediante la API: Filtros del panel.

Agregar o modificar un grupo temporal

Cuando agregas agrupaciones de todo el panel, los widgets en el 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 VM en una zona en particular, puedes editar el panel y ese gráfico a fin de cambiar sus opciones de agrupación. Una alternativa es agrupar el panel por zona de forma temporal y, luego, ver el gráfico de uso de CPU.

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

  1. En Google Cloud Console, selecciona Monitoring o haz clic en el siguiente botón:
    Ir a Monitoring
  2. En el panel de navegación, selecciona Paneles y, luego, selecciona el panel que deseas ver o editar.
  3. Si se muestra el botón Cerrar editor, haz clic en él.
  4. Expande el menú Agrupar por y, luego, selecciona las etiquetas para agrupar.
  5. Haz clic en OK.

Cuando abres el editor del panel o sales del panel, se descartan todas las agrupaciones que agregaste.

¿Qué sigue?