Agrega gráficos y tablas a un panel personalizado

En este documento, se describe cómo agregar gráficos, tablas, indicadores y cuadros de evaluación a un panel personalizado con la consola de Google Cloud . Puedes mostrar los datos de métricas durante un intervalo de tiempo agregando un gráfico de líneas, un gráfico de áreas apiladas, un gráfico de barras o un gráfico de mapa de calor. Si solo te interesan las mediciones más recientes, agrega una tabla, un gráfico circular, un indicador, un cuadro de evaluación o un mapa de árbol. Los medidores y los cuadros de evaluación cambian de color según cómo se compara el valor más reciente con los límites de advertencia y peligro.

Las visualizaciones que puedes agregar a los paneles se denominan de forma colectiva widgets. Para obtener información general sobre los diferentes tipos de widgets, consulta Descripción general de los paneles.

Los gráficos, las tablas, los medidores y los cuadros de evaluación de los paneles personalizados pueden mostrar cualquier tipo de métrica que tenga un valor numérico o de distribución, incluidas las métricas definidas por el usuario y las métricas basadas en registros. En los gráficos, no se pueden representar los datos de tipo string.

En este documento, se describe cómo agregar gráficos, tablas, indicadores y tarjetas de puntuación a un panel personalizado que muestre datos de series temporales. Para obtener información sobre cómo agregar otros tipos de widgets a tus paneles, consulta los siguientes documentos:

Para obtener información sobre la API de Cloud Monitoring, consulta Administra paneles con la API.

Esta función solo se admite para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

Antes de comenzar

Completa lo siguiente en el proyecto Google Cloud en el que deseas crear y administrar paneles:

  • Para obtener los permisos que necesitas para crear y modificar paneles personalizados con la consola de Google Cloud , pídele a tu administrador que te otorgue el rol de IAM de editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    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.

  • Puedes colocar hasta 100 widgets en un panel.

  • Para agregar un widget a un panel, puedes seleccionar la visualización y, luego, configurar el widget, o bien seleccionar el tipo de datos primero y, luego, configurar la visualización.

    Por ejemplo, para agregar una tabla que muestre el uso de CPU de tus instancias de VM a un panel, puedes hacer cualquiera de las siguientes acciones:

    • Selecciona el widget Tabla y, luego, configúralo para que muestre el uso de CPU de tus instancias de VM.
    • Selecciona el tipo de datos Métrica, configura el widget para que muestre el uso de CPU de tus instancias de VM y, luego, cambia el tipo de widget a Tabla.

    Las instrucciones de esta página suponen que primero seleccionas el tipo de datos y, luego, configuras cómo se muestran esos datos.

Cómo agregar gráficos y tablas a un panel

En esta sección, se describe cómo configurar gráficos y tablas con la consola deGoogle Cloud :

  • Los gráficos muestran datos a lo largo del tiempo y hay cuatro estilos disponibles: Líneas, Áreas apiladas, Barras apiladas y Mapa de calor. Un solo gráfico puede mostrar varios tipos de métricas. Por ejemplo, puedes configurar un gráfico para que muestre los bytes de disco leídos de tus instancias y los bytes de disco escritos en ellas.

    Después de configurar un gráfico, puedes cambiar su tipo de widget. Para obtener información sobre por qué podrías seleccionar un estilo específico, consulta Gráficos que muestran datos a lo largo del tiempo.

    Para obtener información sobre cómo usar la API de Cloud Monitoring para configurar un gráfico, consulta Panel con un widget XyChart.

  • Las tablas contienen una fila para cada combinación de valores de etiqueta. Cuando las tablas muestran datos de varios tipos de métricas, cada fila contiene un resultado de todas las consultas, cuando es posible realizar esa combinación.

    Existen dos estilos de tablas. El widget de Tabla muestra un valor numérico, como "25%". El widget de Lista principal muestra tanto el valor como un indicador visual del valor en comparación con el rango de valores posibles.

    Puedes cambiar el estilo entre tablas y gráficos, configurar los nombres de las columnas de la tabla y agregar umbrales que cambien el color de las celdas de la tabla. Para obtener más información y un ejemplo, consulta Cómo mostrar datos en formato tabular en un panel.

    Para obtener información sobre cómo usar la API de Cloud Monitoring para configurar una tabla, consulta Panel con un widget TimeSeriesTable.

Para agregar un gráfico o una tabla a un panel, 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 herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

  3. Realiza una de las siguientes acciones:

    • Para crear un panel nuevo, selecciona Crear panel.
    • Para actualizar un panel existente, busca el panel en la lista de todos los paneles y selecciona su nombre.

  4. En la barra de herramientas, haz clic en  Agregar widget.

  5. En el diálogo Agregar widget, selecciona  Métrica.

  6. Especifica los datos que se mostrarán en el gráfico. Puedes usar una interfaz controlada por menús, el lenguaje de consulta de Monitoring (MQL), PromQL o ingresar un filtro de Monitoring:

    1. Selecciona los datos de series temporales que deseas ver:

      1. En el elemento Métrica, expande el menú Seleccionar una métrica.

        El menú Seleccionar una métrica contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:

        • Para encontrar un tipo de métrica específico, usa la barra de filtros . Por ejemplo, si ingresas util, restringes el menú para que muestre las entradas que incluyen util. Las entradas se muestran cuando superan una prueba de "contiene" que no distingue mayúsculas de minúsculas.

        • Para mostrar todos los tipos de métricas, incluso aquellos sin datos, haz clic en Activas. De forma predeterminada, los menús solo muestran los tipos de métricas con datos.

        Por ejemplo, puedes realizar las siguientes selecciones:

        1. En el menú Recursos activos, selecciona Instancia de VM.
        2. En el menú Categorías de métricas activas, elige uptime_check.
        3. En el menú Métricas activas, selecciona Latencia de solicitud.
        4. Haz clic en Aplicar.

      2. Opcional: Para especificar un subconjunto de datos que se mostrará, en el elemento Filtro, selecciona Agregar filtro y, luego, completa el diálogo. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información, consulta Filtra datos del gráfico.

      Para obtener más información, consulta Selecciona los datos para el gráfico.

    2. Combina y alinea series temporales:

      • Para mostrar todas las series temporales, en el elemento Agregación, establece el primer menú en Sin agregar y el segundo menú en Ninguno.

      • Para combinar series temporales, en el elemento Agregación, haz lo siguiente:

        1. Expande el primer menú y selecciona una función.

          Se actualizará el gráfico y se mostrará una sola serie temporal. Por ejemplo, si seleccionas Media, la serie temporal que se muestra es el promedio de todas las series temporales.

        2. Para combinar series temporales que tienen los mismos valores de etiqueta, expande el segundo menú y, luego, selecciona una o más etiquetas.

          El gráfico se actualiza y muestra una serie temporal para cada combinación única de valores de etiqueta. Por ejemplo, para mostrar las series temporales por zona, configura el segundo menú como zona.

          Cuando el segundo menú se establece en Ninguno, el gráfico muestra una serie temporal.

      • Opcional: Para configurar el espaciado entre los puntos de datos, haz clic en Agregar elemento de consulta, selecciona Intervalo mín. y, luego, ingresa un valor.

      Para obtener más información sobre la agrupación y la alineación, consulta Elige cómo mostrar los datos del gráfico.

    3. Opcional: Para mostrar solo las series temporales con los valores más altos o más bajos, usa el elemento Ordenar y limitar.

    MQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar el uso de CPU de las instancias de VM en tu proyecto Google Cloud , usa la siguiente consulta:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

      Para obtener más información sobre MQL, consulta los siguientes documentos:

    PromQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. Por ejemplo, para generar un gráfico del uso promedio de CPU de las instancias de VM en tu proyecto Google Cloud , usa la siguiente consulta:

      avg(compute_googleapis_com:instance_cpu_utilization)

      Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.

    Filtro de supervisión

    1. En el elemento Métrica, haz clic en Ayuda y, luego, selecciona Modo de filtro directo.

      Se borran los elementos Métrica y Filtro, y se crea un elemento Filtros que te permite ingresar texto.

      Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo Modo de filtro directo, esa configuración se mostrará en el campo del elemento Filtros.

    2. Ingresa un filtro de Monitoring en el campo del elemento Filters.

    3. Combina y alinea series temporales:

      • Para mostrar todas las series temporales, en el elemento Agregación, establece el primer menú en Sin agregar y el segundo menú en Ninguno.

      • Para combinar series temporales, en el elemento Agregación, haz lo siguiente:

        1. Expande el primer menú y selecciona una función.

          Se actualizará el gráfico y se mostrará una sola serie temporal. Por ejemplo, si seleccionas Media, la serie temporal que se muestra es el promedio de todas las series temporales.

        2. Para combinar series temporales que tienen los mismos valores de etiqueta, expande el segundo menú y, luego, selecciona una o más etiquetas.

          El gráfico se actualiza y muestra una serie temporal para cada combinación única de valores de etiqueta. Por ejemplo, para mostrar las series temporales por zona, configura el segundo menú como zona.

          Cuando el segundo menú se establece en Ninguno, el gráfico muestra una serie temporal.

      • Opcional: Para configurar el espaciado entre los puntos de datos, haz clic en Agregar elemento de consulta, selecciona Intervalo mín. y, luego, ingresa un valor.

      Para obtener más información sobre la agrupación y la alineación, consulta Elige cómo mostrar los datos del gráfico.

  7. Opcional: Configura el gráfico o la tabla para que muestren varios tipos de métricas.

    1. Selecciona Agregar consulta. Se agrega una búsqueda nueva. Por ejemplo, se podría agregar una búsqueda con la etiqueta B.

    2. Para la nueva consulta, en el elemento Métrica, selecciona un tipo de recurso y un tipo de métrica. También puedes agregar filtros, combinar series temporales, y ordenar y limitar la cantidad de series temporales que se muestran.

    En la siguiente captura de pantalla, se ilustra la pantalla del Explorador de métricas cuando se representan dos tipos de métricas:

    Ejemplo del Explorador de métricas con dos tipos de métricas.

    MQL

    No compatible.

    PromQL

    No compatible.

    Filtro de supervisión

    No compatible.

  8. Opcional: Configura el gráfico para que muestre una proporción de los tipos de métricas.

    1. Configura el gráfico para que muestre dos tipos de métricas que tengan el mismo tipo de métrica. Por ejemplo, ambas son métricas de GAUGE.
    2. Asegúrate de que el valor del campo Intervalo mín. sea el mismo para ambos tipos de métricas. Para acceder a este campo, haz clic en Agregar elemento de consulta y selecciona Intervalo mín..

    3. Actualiza los campos de agregación.

      Te recomendamos que las etiquetas del tipo de métrica del denominador coincidan con los valores establecidos para el tipo de métrica del numerador. Por ejemplo, puedes seleccionar la etiqueta zone para el numerador y el denominador.

      No es necesario que uses el mismo conjunto de etiquetas para ambos tipos de métricas. Sin embargo, solo puedes seleccionar etiquetas que sean comunes a ambos tipos de métricas.

    4. En la barra de herramientas del panel de consultas, selecciona Crear proporción y, luego, completa el diálogo.

      Después de crear la proporción, se muestran tres consultas:

      • Relación A/B identifica la consulta de relación.
      • A identifica la consulta para el numerador.
      • B identifica la consulta para el denominador.

      En el siguiente ejemplo, se ilustra una proporción que compara la suma de los bytes escritos en el disco por zona con la cantidad total de bytes escritos en el disco:

      Ejemplo de una proporción de métricas.

    5. Opcional: Para cambiar las métricas del numerador y el denominador, en el elemento Proporción, expande el menú y, luego, realiza una selección.

    MQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. MQL te permite calcular una proporción de dos métricas diferentes y filtrar una sola métrica por una etiqueta para, luego, calcular la proporción. La siguiente consulta calcula la proporción de respuestas con un valor de 500 en relación con la cantidad total de respuestas:

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

      Para obtener más información sobre MQL, consulta los siguientes documentos:

    PromQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar la proporción de la latencia promedio de tu métrica my_summary_latency_seconds, usa la siguiente consulta:

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))

      Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.

    Filtro de supervisión

    No compatible.

  9. Opcional: Para cambiar la visualización, en el panel Display, haz clic en Widget type y, luego, realiza una selección.

    En el menú Tipo de widget, se enumeran todos los tipos de widgets que pueden mostrar el mismo tipo de datos. Sin embargo, es posible que algunos widgets no estén habilitados. Por ejemplo, considera un gráfico en un panel configurado para mostrar un tipo de métrica. El gráfico de líneas muestra varias series temporales, y cada valor medido es un número de punto flotante doble:

    • Los widgets Tabla, Gráfico circular, Gráfico de líneas, Gráfico de barras apiladas y Gráfico de áreas apiladas se indican como Compatibles. Puedes seleccionar cualquiera de estos tipos.

    • Los widgets de Cuadro de evaluación y Indicador se indican como Compatibles con ajustes porque solo pueden mostrar una sola serie temporal. Para habilitar estos tipos de widgets, modifica la configuración de agrupación.

    • El widget Mapa de calor está inhabilitado porque estos widgets solo pueden mostrar datos con valores de distribución.

    • El panel de registros no aparece en la lista porque no puede mostrar datos de series temporales.

  10. Opcional: Para cambiar la forma en que un gráfico o una tabla muestran los datos seleccionados, usa las opciones del panel Visualización:

  11. Opcional: En el panel Visualización, configura la visibilidad del gráfico o la tabla. De forma predeterminada, el widget es visible. Sin embargo, puedes usar una variable para controlar si el widget se muestra o se oculta.

  12. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

  13. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Mostrar solo los datos más recientes

Monitoring te proporciona varias formas de visualizar solo las mediciones más recientes, en lugar de ver el historial de mediciones:

  • Para mostrar gráficamente el valor más reciente de cada serie temporal, en el que cada valor se muestra como una fracción de la suma de todos los valores, agrega un gráfico circular. Puedes configurar estos gráficos para que muestren el valor total.

  • Para visualizar los valores más recientes de los datos agregados como una serie de rectángulos anidados, en la que el color de un rectángulo es proporcional a su valor, agrega un widget de mapa de árbol.

  • Para mostrar el valor más reciente de cada serie temporal en formato tabular, agrega una tabla. Puedes limitar la cantidad de filas en una tabla y configurar las filas de una tabla para que muestren un valor en comparación con un rango de valores.

  • Para obtener una indicación verde, ámbar o roja del valor más reciente en comparación con un conjunto de umbrales, agrega un indicador o un cuadro de evaluación al panel.

Representa los datos más recientes con un gráfico circular

Para ver los datos más recientes como una fracción del total, agrega un gráfico circular. Al igual que las tablas, los gráficos circulares pueden mostrar cualquier tipo de métrica que tenga un valor numérico y pueden mostrar percentiles para las métricas con valor de distribución. Cada serie temporal aporta una porción al gráfico circular.

En la siguiente captura de pantalla, se ilustra un panel que muestra el uso de CPU de las instancias de máquina virtual con dos configuraciones diferentes de un widget de gráfico circular:

Ejemplo de widgets de **PieChart**.

Para obtener información sobre cómo agregar gráficos circulares a un panel, consulta los siguientes documentos:

  • Google Cloud console: Consulta la sección titulada Agrega gráficos y tablas en este documento.

    • Después de seleccionar los datos para el gráfico, en el panel Mostrar, establece el campo Tipo de widget en Gráfico circular.
    • Para mostrar el valor total, establece el campo Tipo de gráfico en Gráfico circular.

  • API de Cloud Monitoring: Consulta Panel con un widget PieChart.

Cómo mostrar el valor más reciente como un mapa de árbol

Agrega un mapa de árbol para ver los datos más recientes como una serie anidada de rectángulos, en la que cada rectángulo corresponde a una colección única de valores de etiqueta. Supongamos que agregaste los datos que se muestran en el gráfico según la etiqueta zone. Si configuras el tipo de widget como mapa de árbol, cada rectángulo del mapa corresponderá a una zona. La saturación del color de un rectángulo es proporcional al valor que representa.

En la siguiente captura de pantalla, se muestra un widget de mapa de árbol en el que las series temporales se agregan por zone y storage_type:

Ejemplo de un widget de **mapa de árbol**.

En la captura de pantalla, se muestra la información sobre la herramienta para un rectángulo.

Para configurar un mapa de árbol, haz lo siguiente:

  1. Selecciona el widget de mapa de árbol en el panel Agregar widget.
  2. Usa el elemento Seleccionar una métrica para elegir el tipo de métrica que se mostrará.
  3. Si el elemento Agregación muestra Sin agregar, usa el menú para seleccionar una función de agregación. Por ejemplo, selecciona Media o Máximo.
  4. En el segundo campo del elemento Agregación, selecciona al menos una etiqueta.
  5. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.
  6. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Para obtener información sobre cómo usar la API para configurar un mapa de árbol, consulta Panel con un widget Treemap.

Mostrar los datos más recientes en formato de tabla

Para ver los datos más recientes en formato tabular, agrega una tabla. Las tablas pueden mostrar datos numéricos. Por ejemplo, pueden mostrar uno o más tipos de métricas o percentiles para las métricas con valor de distribución.

Cuando una tabla muestra un tipo de métrica, cada fila de la tabla corresponde a una serie temporal. Una columna de la tabla que muestra un valor numérico, que puede ser el valor más reciente o un valor agregado. Las otras columnas muestran las etiquetas de la serie temporal. Cuando una tabla muestra varios tipos de métricas, los datos de ambos tipos se muestran en la misma fila, cuando es posible. Para obtener más información, consulta Cómo las tablas combinan varios tipos de métricas.

Existen dos widgets que muestran los datos en formato tabular: el widget de Lista principal y el widget de Tabla. La principal diferencia entre estos dos widgets es que el widget de Lista de principales ordena las filas y muestra el valor junto con un indicador visual del valor en comparación con el rango de valores posibles. Dado que el widget de Lista superior proporciona una representación visual del valor, no puedes codificar por colores la celda según cómo se compara el valor con un umbral.

Para obtener información sobre la configuración de tablas, consulta las siguientes secciones:

En la siguiente captura de pantalla, se ilustran dos tablas. En la primera tabla, se muestran dos tipos de métricas: la cantidad de bytes leídos de las instancias y la cantidad de bytes escritos en las instancias. Se muestra un valor agregado junto con una barra de referencia. La segunda tabla muestra el valor más reciente de un tipo de métrica, y la columna de valores se configuró para codificar por color la celda según cómo se compara el valor con un umbral:

Ejemplo de una tabla en la que se muestran dos tipos de métricas.

Mostrar el valor más reciente o el valor agregado

De forma predeterminada, las tablas muestran el valor más reciente. Sin embargo, una tabla puede mostrar un valor que se calcula en el intervalo de tiempo seleccionado para tu panel.

Para seleccionar entre el valor más reciente y el valor agregado, usa el campo Opción de valor.

Si muestras el valor agregado, para cada serie temporal, los datos dentro del período seleccionado por tu panel se combinan con la función de alineación. La función de alineación es una de las opciones de agregación y no se muestra de forma predeterminada. Para ver la función de alineación, expande el elemento Agregación y, en el primer elemento, selecciona Configurar alineador. Después de realizar esta selección, el elemento Agregación se reemplaza por un elemento Agrupación y un menú llamado Función de alineación.

Selecciona las columnas que quieres mostrar

De forma predeterminada, una columna de la tabla muestra un valor numérico. Todas las demás columnas corresponden a una etiqueta en la serie temporal. En el caso de las columnas basadas en etiquetas, el nombre de la columna se deriva de la etiqueta.

Para configurar las columnas que muestra la tabla, expande el menú Columnas visibles y realiza tus selecciones.

Cómo configurar el formato de la columna

  • Para configurar una columna individual, en el elemento Columnas, expande el menú Anular columna, selecciona la columna que se modificará y, luego, realiza cualquiera de las siguientes acciones:

    • Para establecer el nombre de la columna, usa el campo Nombre visible.
    • Para establecer la alineación de los datos en la columna, usa los botones Alinear a la izquierda, Alinear al centro y Alinear a la derecha.
    • Para codificar por color la celda según cómo se compara el valor numérico con un umbral, establece los umbrales de advertencia y peligro.
    • Si escribes consultas de PromQL, usa el menú Unidad para establecer las unidades que se muestran con los datos. Las unidades se configuran automáticamente cuando configuras tu búsqueda con las selecciones del menú.

Mostrar el valor de referencia

Las tablas pueden mostrar solo un valor o un valor relativo al rango de valores. Cuando se selecciona la opción de rango, el valor se muestra junto con una barra de color azul, cuya longitud es proporcional al valor que se muestra.

Para configurar si se muestra un valor de referencia, usa el elemento Vista de métricas.

Cómo ordenar y filtrar tablas

Puedes cambiar el orden de las filas en la tabla y filtrar su contenido para que solo se muestren filas específicas. Estos parámetros de configuración no son persistentes. Cuando sales de la página del panel o cuando lo vuelves a cargar, se descartan las opciones de ordenamiento y filtrado que aplicaste.

Tienes las siguientes opciones de orden y filtrado:

  • Para ordenar la tabla por una columna, haz clic en el encabezado de la columna.

  • Para cambiar las columnas de la tabla, haz clic en Ver columnas, realiza las modificaciones y, luego, haz clic en Aceptar.

  • Para enumerar solo filas específicas, agrega uno o más filtros. Puedes agregar varios filtros. Cuando no especificas el operador OR entre dos filtros, un operador lógico AND une esos filtros.

    Para agregar un filtro, haz clic en Enter property name or value, selecciona una propiedad del menú y, luego, ingresa un valor o selecciona el menú. Por ejemplo, si filtras la propiedad Name y, luego, ingresas el valor demo, la tabla solo mostrará las filas en las que el campo Name incluye el valor demo.

Mostrar los datos más recientes con indicación de advertencia o error

Para ver la medición más reciente en comparación con un conjunto de umbrales codificado por colores, agrega un indicador o un cuadro de evaluación. Los medidores solo muestran la medición más reciente, mientras que los cuadros de evaluación también muestran un historial de mediciones recientes. El color de fondo de estos widgets también está codificado por color. Cuando el valor más reciente se encuentra dentro de los rangos esperados, el color del widget es blanco. Cuando el valor se encuentra en un rango de advertencia, el widget se vuelve ámbar. Del mismo modo, cuando el valor se encuentra en un rango de peligro, el widget se vuelve rojo.

Ambos widgets muestran una sola serie temporal. En la siguiente captura de pantalla, se muestra un ejemplo de un indicador cuando la medición más reciente es menor que los límites de advertencia y peligro:

Ejemplo de un indicador.

El resto de la información de esta sección es para la consola deGoogle Cloud . Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un Scorecard básico.

Para agregar un indicador o un cuadro de evaluación a un panel, 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 herramientas de la consola de Google Cloud , selecciona tu proyecto Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.

  3. Realiza una de las siguientes acciones:

    • Para crear un panel nuevo, selecciona Crear panel.
    • Para actualizar un panel existente, busca el panel en la lista de todos los paneles y selecciona su nombre.

  4. En la barra de herramientas, haz clic en  Agregar widget.

  5. En el diálogo Agregar widget, selecciona  Métrica.

  6. Especifica los datos que se mostrarán en el gráfico. Puedes usar una interfaz controlada por menús, el lenguaje de consulta de Monitoring (MQL), PromQL o ingresar un filtro de Monitoring:

    1. Selecciona los datos de series temporales que deseas ver:

      1. En el elemento Métrica, expande el menú Seleccionar una métrica.

        El menú Seleccionar una métrica contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:

        • Para encontrar un tipo de métrica específico, usa la barra de filtros . Por ejemplo, si ingresas util, restringes el menú para que muestre las entradas que incluyen util. Las entradas se muestran cuando superan una prueba de "contiene" que no distingue mayúsculas de minúsculas.

        • Para mostrar todos los tipos de métricas, incluso aquellos sin datos, haz clic en Activas. De forma predeterminada, los menús solo muestran los tipos de métricas con datos.

        Por ejemplo, puedes realizar las siguientes selecciones:

        1. En el menú Recursos activos, selecciona Instancia de VM.
        2. En el menú Categorías de métricas activas, elige uptime_check.
        3. En el menú Métricas activas, selecciona Latencia de solicitud.
        4. Haz clic en Aplicar.

      2. Opcional: Para especificar un subconjunto de datos que se mostrará, en el elemento Filtro, selecciona Agregar filtro y, luego, completa el diálogo. Por ejemplo, puedes ver los datos de una zona si aplicas un filtro. Puedes agregar varios filtros. Para obtener más información, consulta Filtra datos del gráfico.

      Para obtener más información, consulta Selecciona los datos para el gráfico.

    2. Combina las series temporales con los campos de Agregación:

      • Expande el primer menú y selecciona la función que combina las series temporales.
      • Expande el segundo menú y asegúrate de que no haya etiquetas seleccionadas.

    MQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que MQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. Debes asegurarte de que los campos de agregación estén configurados para combinar todas las series temporales. Por ejemplo, para generar un gráfico del uso de CPU de las instancias de VM en tu proyecto Google Cloud , usa la siguiente consulta:

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)]

      Para obtener más información sobre MQL, consulta los siguientes documentos:

    PromQL

    1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o PromQL.
    2. Verifica que PromQL esté seleccionado en el botón de activación Lenguaje. El botón de activación de lenguaje se encuentra en la misma barra de herramientas que te permite dar formato a tu consulta.

    3. Ingresa tu consulta en el editor de consultas. Por ejemplo, para generar un gráfico del uso promedio de CPU de las instancias de VM en tu proyecto Google Cloud , usa la siguiente consulta:

      avg(compute_googleapis_com:instance_cpu_utilization)

      Para obtener más información sobre el uso de PromQL, consulta PromQL en Cloud Monitoring.

    Filtro de supervisión

    1. En el elemento Métrica, haz clic en Ayuda y, luego, selecciona Modo de filtro directo.

      Se borran los elementos Métrica y Filtro, y se crea un elemento Filtros que te permite ingresar texto.

      Si seleccionaste un tipo de recurso, una métrica o filtros antes de cambiar al modo Modo de filtro directo, esa configuración se mostrará en el campo del elemento Filtros.

    2. Ingresa un filtro de Monitoring.

    3. Combina las series temporales con los campos de Agregación:

      • Expande el primer menú y selecciona la función que combina las series temporales.
      • Expande el segundo menú y asegúrate de que no haya etiquetas seleccionadas.

  7. En el panel Mostrar, configura el indicador o el cuadro de evaluación:

    1. Haz clic en Tipo de widget y selecciona Medidor o Cuadro de evaluación.

    2. Para los widgets de indicador, haz clic en Rango del indicador y, luego, establece los valores mínimo y máximo. Cuando un indicador muestre un porcentaje, configura estos valores en 0 y 1 respectivamente.

    3. Haz clic en Límite del medidor y, luego, establece los límites de advertencia y peligro. No se usan los campos de umbral que están vacíos.

      En el indicador que se mostró anteriormente, se establecieron dos umbrales. Los valores superiores a 0.9 se encuentran en el rango de peligro. Los valores superiores a 0.7, pero que no se encuentran en el rango de peligro, están en el rango de advertencia.

    4. Para los cuadros de evaluación, haz clic en Vista del gráfico de Spark, expande el menú de opciones y, luego, selecciona el estilo de visualización.

  8. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

  9. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Cómo las tablas combinan datos para varios tipos de métricas

Si una tabla consulta varios tipos de métricas, la consola de Google Cloud realiza una operación de combinación examinando las etiquetas adjuntas a los datos agregados para ambos tipos de métricas. Cuando las etiquetas que son comunes a ambas búsquedas permiten que el Monitoreo determine un identificador de fila único, una sola fila de la tabla muestra el valor más reciente para cada búsqueda. De lo contrario, hay una fila para cada serie temporal.

Por ejemplo, supongamos que una tabla consulta dos tipos de métricas diferentes. Llamemos a estas consultas A y B. A continuación, se describe cómo se combinan los resultados de la búsqueda:

  • Si el resultado de ambas búsquedas tiene el mismo conjunto de etiquetas, la combinación siempre se realizará correctamente. Cada fila contiene el valor más reciente de cada búsqueda. Si una consulta no devuelve un valor para una combinación específica de etiquetas, la celda de la tabla estará vacía.

    Por ejemplo, supongamos que ambas búsquedas contienen una etiqueta zone. La tabla contiene una fila para cada zona informada por la consulta A y la consulta B. Sin embargo, si la consulta A devuelve una serie temporal cuya zona es us-central1-a, pero la consulta B no devuelve una serie temporal con este valor, el valor más reciente de la consulta B se muestra como una celda vacía.

  • Si las etiquetas de los resultados de una consulta son un subconjunto de las etiquetas de los resultados de la otra consulta, se combinan los resultados.

    Por ejemplo, supongamos que los resultados de ambas búsquedas incluyen etiquetas para location y cluster_name, pero que los resultados de la búsqueda A también incluyen una etiqueta para memory_type. En esta situación, cada fila corresponde a una serie temporal con valores únicos para las tres etiquetas.

    En cualquier fila, el valor que se muestra para la consulta B es el valor de la serie temporal que coincide con las dos etiquetas comunes, location y cluster_name, y se ignora la tercera etiqueta.

  • Si los resultados de las dos consultas no comparten ninguna etiqueta o si comparten algunas, pero no las suficientes para formar un identificador de fila único, no se podrán combinar los resultados. La tabla enumera una fila para cada serie temporal que devuelven las consultas A o B, y algunas celdas de la tabla están vacías.

    Por ejemplo, supongamos que las etiquetas de la búsqueda A son location y memory_type, y que las etiquetas de la búsqueda B son location y cluster_name. Si bien la etiqueta location es común, no es suficiente para crear un identificador de fila único.

    Como se describe en la siguiente sección, es posible que puedas resolver un error de combinación.

Cómo resolver errores de combinación

Cuando generas gráficos con varias métricas, es posible que se produzca un error de combinación porque las métricas usan nombres de etiquetas diferentes para el mismo campo. Una forma de resolver este error es convertir una consulta a PromQL y, luego, usar la función label_replace() para convertir los nombres de las etiquetas que usa un tipo de métrica de modo que coincidan con los del otro tipo de métrica.

Por ejemplo, considera una tabla configurada con dos consultas:

  • A: Consulta el tipo de métrica Prometheus/kube_pod_container_status_ready/gauge. Las opciones de agregación se configuran para sumar las series temporales después de agrupar los datos por la etiqueta cluster.

  • B: Consulta el tipo de métrica kubernetes.io/container/memory/request_bytes. Las opciones de agregación se configuran para sumar las series temporales después de agrupar los datos por la etiqueta cluster_name.

La tabla no puede combinar los resultados porque los resultados de la consulta A y la consulta B tienen etiquetas diferentes.

Para resolver la falla, convierte la consulta A a PromQL y reemplaza cluster por cluster_name. En el siguiente ejemplo, se ilustra la consulta modificada:

sum by (cluster_name)(
    label_replace(
        avg_over_time(kube_pod_container_status_ready[${__interval}]),
        "cluster_name", "$1", "cluster", "(.*)"
    )
)

Con los cambios, ambas consultas producen el mismo conjunto de etiquetas. Por lo tanto, cada fila de la tabla muestra un nombre de clúster, el valor de la búsqueda A y el valor de la búsqueda B.

Para obtener información sobre cómo usar PromQL, consulta PromQL en Cloud Monitoring.

¿Qué sigue?

También puedes agregar los siguientes widgets a tus paneles personalizados:

Para obtener información sobre cómo explorar los datos representados en gráficos y filtrar tus paneles, consulta los siguientes documentos: