Crea gráficos con el Explorador de métricas

En este documento, se describe cómo puedes explorar los datos de las métricas creando un gráfico temporal con el Explorador de métricas. Por ejemplo, para ver el uso de la CPU de una máquina virtual (VM), puedes usar el Explorador de métricas para crear un gráfico que muestre los datos más recientes. Si quieres una configuración gráficos, puedes crear un gráfico con el Explorador de métricas guardarlos en un panel personalizado. Una alternativa es crear un panel personalizado, que puede mostrar gráficos, registros, incidentes y otro contenido y, luego, usar el para agregar gráficos a ese panel. Para obtener información sobre los paneles personalizados, consulta Crea y administra paneles personalizados.

Puede crear gráficos, como aquellos que representan un solo tipo de métrica, y gráficos complejos, como los que representan varios tipos de métricas. Después de crear un gráfico con el Explorador de métricas, puedes descartarlo, guardarlo en un panel personalizado, guardar su configuración o compartirlo.

En la siguiente captura de pantalla, se muestra un solo tipo de métrica, el uso de CPU de una instancia de VM, representado en un gráfico en la página Explorador de métricas:

En la captura de pantalla anterior, se muestran varias líneas, cada una de las cuales muestra el uso promedio de la CPU de todas las VMs en una zona específica.

Nota: Si estás viendo un gráfico en un panel y quieres ver configuración del gráfico o copiarlo en un panel diferente y, luego, ver si Las opciones del gráfico te permiten ver el Explorador de métricas. Cuando selecciones esta opción, se abrirá el Explorador de métricas y se mostrarán los datos que estabas viendo. Luego, puedes ver o modificar la configuración o puedes guardarlo en un panel personalizado.

Gráfico de un solo tipo de métrica

Para configurar un gráfico para que muestre una sola métrica, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de métricas:

   Ir al Explorador de métricas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. 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:

   Interfaz controlada por menús

   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, restringirás el menú a mostrar entradas que incluyan util. Las entradas se muestran cuando pasan un elemento "contiene" que no distingue mayúsculas de minúsculas la prueba.

         • Para mostrar todos los tipos de métricas, incluso las que no tienen datos, haz clic en Activa. De forma predeterminada, los menús solo muestran los tipos de métricas con datos.

         Por ejemplo, puedes tomar las siguientes decisiones:

         1. En el menú Recursos activos, selecciona Instancia de VM.
         2. En el menú Categorías de métricas activas, selecciona 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 para mostrar, en el elemento Filtro, selecciona Agregar filtro y, luego, completar el diálogo. Por ejemplo, puedes ver los datos de una zona aplicar 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 que deseas graficar.

   2. Combina y alinea series temporales:

      • Para mostrar cada serie temporal, en el elemento Aggregation (Agregación) Configura 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.

           El gráfico se actualiza y muestra 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, haz lo siguiente: expandir el segundo menú y, luego, seleccionar 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 en series temporales por zona, establece el segundo menú en zone.

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

      • Opcional: Para configurar el espaciado entre los datos, haz clic en Agregar elemento de consulta, selecciona Intervalo mínimo 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 la puntuación más alta o más baja valores, usa la opción Ordenar y Limit.

   MQL

   1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o MQL.
   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 la Usa el uso de CPU de las instancias de VM en tu proyecto de Google Cloud, usa el 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:

      • Introducción a MQL
      • Cómo usar el editor de código para MQL

   PromQL

   1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o MQL.
   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 el uso promedio de la CPU de las instancias de VM en tu proyecto de 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 Direct Filter Mode, esa configuración se mostrará en el campo del elemento Filters.

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

   3. Combina y alinea series temporales:

      • Para mostrar cada serie temporal, en el elemento Aggregation (Agregación) Configura 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.

           El gráfico se actualiza y muestra 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, haz lo siguiente: expandir el segundo menú y, luego, seleccionar 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 en series temporales por zona, establece el segundo menú en zone.

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

      • Opcional: Para configurar el espaciado entre los datos, haz clic en Agregar elemento de consulta, selecciona Intervalo mínimo 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. Actualiza la configuración del gráfico según el tipo de métrica seleccionado:

   • Para los tipos de métricas de cuota, usa la siguiente configuración:

     • En la barra de herramientas, establece el control de tiempo para que sea de al menos una semana. Por lo general, las métricas de cuota informan una muestra por día.
     • En el panel Mostrar, expande el menú Tipo de widget y, luego, selecciona Gráfico de barras apiladas.

   • Para los tipos de métricas que tienen un tipo de valor Distribution, asegúrate de que el menú Tipo de widget esté configurado como Gráfico de mapa de calor. Para obtener más información, consulta Acerca de las métricas con valor de distribución.

   • Para otros tipos de métricas, usa el menú Tipo de widget para mostrar cómo se muestran los datos. En el menú Tipo de widget, se enumeran todos los tipos de widgets disponibles. Sin embargo, es posible que algunos widgets no estén habilitados. Considera un gráfico que muestra varias series temporales y supone que cada valor medido es un doble:

     • Gráfico de líneas, Gráfico de barras apiladas y Gráfico de áreas apiladas aparecen como Compatibles. Puedes seleccionar cualquiera de estos tipos.
     • El widget Mapa de calor está inhabilitado porque estos widgets solo pueden mostrar con un valor de distribución.

4. Opcional: Para cambiar la forma en que un gráfico o una tabla muestran los datos seleccionados, usa el en el panel Display:

   • Opciones de gráfico:

     • Menú Modo análisis: Selecciona entre gráficos de líneas, rayos X y estáticos.
     • Menú Comparar con pasados: Superponer los datos actuales con los anteriores
     • Menú Threshold Line: agregar un umbral de referencia.
     • Menú Alias de leyenda: Configura el nombre de una columna de leyenda.
     • Menús de asignación del eje Y, etiquetas del eje Y y escala del eje Y: Configura la asignación, las etiquetas o la escala del eje Y.

   • Opciones de la tabla:

     • Menú Opción de valor: Selecciona entre el valor más reciente y un valor agregado.
     • Menú Columnas visibles: Selecciona las columnas que se mostrarán.
     • Menú Formato de columnas: Configurar nombres de columnas, alineación de datos en una columna, unidades y si las celdas tienen códigos de color.
     • Menú Vista de métricas: Selecciona si el valor se muestra solo o en relación con un rango de valores.
     • Menú Alias de la leyenda: configurar el nombre de una columna de la leyenda.

Crea gráficos de varios tipos de métricas

En algunos casos, tal vez quieras mostrar series temporales de diferentes tipos de métricas en el mismo gráfico. Por ejemplo, para comparar los registros de lectura cargas en una VM, configura un gráfico para mostrar la cantidad de bytes de lectura y la cantidad de bytes escritos.

Para crear gráficos con varias métricas, debes usar la interfaz basada en menús. Las otras interfaces no admiten gráficos de varias métricas.

Para mostrar varias métricas en un gráfico, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de métricas:

   Ir al Explorador de métricas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. Especifica los datos que se mostrarán en el gráfico.

   Interfaz controlada por menús

   1. En el elemento Métrica, selecciona el primer tipo de métrica cuyos datos deseas ver. Para obtener información sobre estos pasos, consulta Cómo graficar un solo tipo de métrica.

      La consulta de esta selección tiene el identificador A.

   2. Para cada tipo de métrica adicional, haz lo siguiente:

      1. Selecciona Agregar consulta. Se agrega una consulta nueva. Por ejemplo, una consulta con el podría agregarse la etiqueta B.

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

      En la siguiente captura de pantalla, se muestra la pantalla del Explorador de métricas cuando hay dos tipos de métricas representadas en un gráfico:

      

   3. Opcional: En el panel Visualización, expande el menú Eje Y y configura qué eje Y se usa para cada tipo de métrica.

   MQL

   No compatible.

   PromQL

   No compatible.

   Filtro de supervisión

   No compatible.

Crea un gráfico de una proporción de métricas

Supervisar la cantidad de errores informados puede ser útil. Sin embargo, es más probabilidades de que debas supervisar la tasa de errores. Es decir, quiere saber cuántos errores ocurrieron cuando se mide con el total el número de respuestas. Para cumplir con este requisito, puedes configurar un gráfico para que muestre la proporción de dos métricas. Para referencias a ejemplos y para información sobre anomalías que pueden ocurrir cuando grafica las proporciones de las métricas, consulta Razones de métricas.

Para mostrar una proporción de métricas en un gráfico, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de métricas:

   Ir al Explorador de métricas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. Especifica los datos que aparecerán en el gráfico:

   Interfaz controlada por menús

   1. Configura el numerador:

      1. En el elemento Métrica, usa los menús para seleccionar una el tipo de recurso y el tipo de métrica. Para obtener información sobre estos pasos, consulta Cómo graficar un solo tipo de métrica.
      2. Actualiza los campos de agregación. De forma predeterminada, promedia todas las series temporales.
      3. Opcional: Actualiza la duración fija de los puntos dentro de una serie temporal para que se combinen. Para modificar este campo, haz clic en Agregar elemento de consulta, selecciona Intervalo mínimo y completa el cuadro de diálogo.

   2. Selecciona Agregar consulta y, luego, configura el denominador:

      1. Para la consulta nueva, en el elemento Métrica, selecciona un tipo de recurso y uno de métrica.

         Selecciona un tipo de métrica cuyo tipo sea el mismo que el numerador. Por ejemplo, si la métrica del numerador es una métrica GAUGE, entonces debes seleccionar una métrica GAUGE para el denominador.

      2. Actualiza los campos de agregación.

         Recomendamos que las etiquetas para el tipo de métrica de 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 para ambos tipos de métricas.

      3. Haz clic en Agregar elemento de consulta. selecciona Mín Intervalo y asegúrate este campo se establece en el valor que usa el numerador.

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

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

      • Proporción A/B identifica la consulta de proporción.
      • A identifica la consulta del numerador.
      • B identifica la consulta del denominador.

      El siguiente ejemplo ilustra una proporción que compara la suma de la cantidad de bytes escritos en el disco por zona, a la cantidad total de bytes en el disco:

      

   4. Opcional: Para cambiar las métricas de numerador y denominador, en el elemento Ratio, expande el menú y, luego, selecciona una opción.

   MQL

   1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o MQL.
   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 y, 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:

      • Introducción a MQL
      • Con el editor de código
      • Proporciones de procesamiento

   PromQL

   1. En la barra de herramientas del panel del compilador de consultas, selecciona el botón cuyo nombre sea MQL o MQL.
   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.

Guarda un gráfico para consultarlo en el futuro

El Explorador de métricas te permite crear un gráfico que puedes usar para explorar un métrica Sin embargo, los gráficos que crea esta herramienta no son persistentes. Cuando salgas de la página Explorador de métricas, el gráfico se descartará.

Si deseas guardar un gráfico que configuraste con el Explorador de métricas para el futuro referencia, agrega el gráfico a un panel personalizado o guarda la URL del gráfico:

• Para agregar el gráfico a un panel personalizado, realiza una de las siguientes acciones:

  • Si usas la consola de Google Cloud para administrar tus paneles personalizados, selecciona Guardar gráfico en la barra de herramientas del Explorador de métricas y completa el diálogo. Puedes guardar el gráfico en un bucket un panel personalizado o crear uno.

  • Si usas la API de Cloud Monitoring para administrar tus paneles personalizados, luego actualiza el archivo JSON que define el panel y sus contenidos. Para acceder a la representación JSON, Haz clic en  Editor de JSON en la barra de herramientas del gráfico.

    Para obtener información detallada sobre cómo usar la API para administrar tus paneles personalizados, consulta Crea y administra paneles por API.

• Para mantener una referencia a la configuración del gráfico, guarda su URL. Debido a que la URL del gráfico codifica la configuración del gráfico, cuando pegas esta URL en un navegador, se muestra el gráfico que configuraste.

  Para obtener la URL del gráfico, haz clic en Vincular en el gráfico. barra de herramientas.

Guardar la configuración de un gráfico

Cuando administras paneles personalizados con la API de Cloud Monitoring, puedes usar el Explorador de métricas para ayudarte a crear los datos que proporcionas a la API:

• Para generar la representación JSON de un gráfico que planeas para agregarlo a un panel, configura el gráfico con el Explorador de métricas. Luego, puedes usar las opciones del Explorador de métricas para ver y copiar la representación JSON del gráfico.

• Para identificar la sintaxis de un filtro de Monitoring, que se usa con la API de Cloud Monitoring, usa la interfaz basada en menús del Explorador de métricas para configurar el gráfico. Después de seleccionar métricas y filtros, cambiar al modo de filtro directo para ver el filtro de Monitoring equivalente.

Guardar los datos que muestra el gráfico

Para guardar los datos que muestra el gráfico en tu sistema local, haz clic en Descargar CSV.

¿Qué sigue?

• Explora los datos del gráfico
• Selecciona métricas con el Explorador de métricas
• Visualiza y administra el uso de métricas
• Configura las opciones de visualización del gráfico