Crea gráficos con el Explorador de métricas

En este documento, se describe cómo puedes explorar datos de métricas mediante la creación de un gráfico temporal con el Explorador de métricas. Por ejemplo, si quieres ver el uso de 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 deseas gráficos permanentes, puedes crear un gráfico con el Explorador de métricas y guardarlo en un panel personalizado. Una alternativa es crear un panel personalizado, que puede mostrar gráficos, registros, incidentes y otro contenido y, luego, usar la interfaz del panel para agregar gráficos a ese panel. Para obtener información sobre los paneles personalizados, consulta Crea y administra paneles personalizados.

Puedes crear gráficos, como los que grafican un solo tipo de métrica, y gráficos complejos, como los que grafican 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) que se muestra en la página Explorador de métricas:

Métrica representada con el Explorador de métricas.

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

Crea un gráfico de un solo tipo de métrica

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

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

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

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

      1. En el elemento Métrica (Metric), haz clic en Seleccionar una métrica y, luego, usa los menús para seleccionar un tipo de recurso y de métrica. 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 Solicitar latencia.
        4. Haz clic en Aplicar.

        Para limitar la cantidad de opciones en los menús, ingresa el nombre de la métrica o del recurso en la barra de filtros. Por ejemplo, para graficar la latencia de la solicitud de una instancia de VM, puedes ingresar “latencia”.

        Después de que realices tus selecciones, cambiará el título del panel. Por ejemplo, si realizaste las sugerencias anteriores, el título del panel se convierte en Latencia de la solicitud.

      2. Opcional: Para especificar un subconjunto de datos que se mostrará, en el elemento Filtro, selecciona Agregar filtro y, luego, completa el cuadro de 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 los datos del gráfico.

      Si deseas obtener más información, consulta Selecciona los datos que deseas representar en el gráfico.

    2. Combina y alinea series temporales:

      • Para mostrar cada serie temporal, en el elemento Agregación, configura el primer menú como No agregada y el segundo menú como Ninguna.

      • Para combinar series temporales, en el elemento Aggregation, 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 Mean, la serie temporal que se muestra es el promedio de todas las series temporales.

        2. Para combinar series temporales que tengan 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 que se muestren las series temporales por zona, configura el segundo menú como zone.

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

      • Opcional: Para configurar el espaciado entre 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 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 Idioma. El botón de activación del idioma está 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 de 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 Language. El botón de activación del idioma está 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 promedio 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 de modo de filtro directo, esa configuración se muestra en el campo del elemento Filtros.

    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 Agregación, configura el primer menú como No agregada y el segundo menú como Ninguna.

      • Para combinar series temporales, en el elemento Aggregation, 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 Mean, la serie temporal que se muestra es el promedio de todas las series temporales.

        2. Para combinar series temporales que tengan 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 que se muestren las series temporales por zona, configura el segundo menú como zone.

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

      • Opcional: Para configurar el espaciado entre 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 que seleccionaste:

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

      • En la barra de herramientas, establece el control de tiempo en, al menos, una semana. Por lo general, las métricas de cuota informan una muestra por día.
      • En el panel Display, expande el menú Widget type y 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 valores de distribución.

    • Para otros tipos de métricas, usa el menú Tipo de widget a fin de 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 supón que cada valor medido es un doble:

      • Los widgets de 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 de mapa de calor está inhabilitado porque estos widgets solo pueden mostrar datos con valores de distribución.

  4. Opcional: Para cambiar la forma en que el gráfico muestra los datos seleccionados, usa las opciones del panel Mostrar:

Crea gráficos de varios tipos de métricas

En algunas situaciones, es posible que desees mostrar series temporales de diferentes tipos de métricas en el mismo gráfico. Por ejemplo, si deseas comparar las cargas de lectura y escritura en una VM, configura un gráfico para mostrar la cantidad de bytes leídos y la cantidad de bytes escritos.

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

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

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

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

    1. En el elemento Métrica (Metric), selecciona el primer tipo de métrica cuyos datos desees ver. Para obtener información sobre estos pasos, consulta Gráfico de un solo tipo de métrica.

      La consulta para 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 nueva consulta. Por ejemplo, se podría agregar una consulta con la etiqueta B.

      2. Para la consulta nueva, en el elemento Métrica, selecciona un tipo de recurso y 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 muestra 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.

    3. Opcional: En el panel Pantalla, expande el menú del 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.

Gráfico de una proporción de métricas

Supervisar la cantidad de errores informados puede ser útil; sin embargo, es más probable que debas supervisar la tasa de errores. Es decir, debes saber cuántos errores se produjeron según la cantidad total de respuestas. Para cumplir con este requisito, puedes configurar un gráfico que muestre la proporción de dos métricas. Para obtener referencias a ejemplos y obtener información sobre las anomalías que pueden ocurrir cuando graficas proporciones de métricas, consulta Razones de métricas.

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

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Explorador de métricas:

    Ir al Explorador de métricas

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

    1. Configura el numerador:

      1. En el elemento Métrica, usa los menús para seleccionar un tipo de recurso y de métrica. Para obtener información sobre estos pasos, consulta Gráfico de 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 un tipo de métrica.

        Selecciona un tipo de métrica cuya categoría sea la misma que el numerador. Por ejemplo, si la métrica de numerador es GAUGE, se selecciona una métrica GAUGE para el denominador.

      2. Actualiza los campos de agregación.

        Recomendamos que las etiquetas del tipo de métrica denominador coincidan con los valores establecidos para el tipo de métrica 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étrica. Sin embargo, solo puedes seleccionar etiquetas que son comunes a ambos tipos de métricas.

      3. Haz clic en Agregar elemento de consulta, selecciona Intervalo mínimo y asegúrate de que este campo se establezca en el valor que usa el numerador.

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

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

      En el siguiente ejemplo, se muestra una proporción que compara la suma de 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.

    4. Opcional: Para cambiar las métricas del numerador y el denominador, en el elemento Ratio, expande el menú y 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  PromQL.
    2. Verifica que MQL esté seleccionado en el botón de activación Idioma. El botón de activación del idioma está 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 te permite 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 respecto de 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 Language. El botón de activación del idioma está 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 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 una métrica. Sin embargo, los gráficos que crea esta herramienta no son persistentes. Cuando sales de la página Explorador de métricas, el gráfico se descarta.

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

  • 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 cuadro de diálogo. Puedes guardar el gráfico en un panel personalizado existente o crear un panel.

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

      Si deseas obtener información detallada sobre el uso de la API para administrar tus paneles personalizados, consulta Crea y administra paneles mediante la API.

  • Para conservar una referencia a la configuración del gráfico, guarda la URL del gráfico. 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 Vínculo en la barra de herramientas del gráfico.

Guarda la configuración de un gráfico

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

  • Para generar la representación JSON de un gráfico que planeas agregar a un panel, configúralo 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.

  • A fin de 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 la métrica y los filtros, cambia al modo de filtro directo para ver el filtro de Monitoring equivalente.

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