Crea gráficos con el Explorador de métricas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En este documento, se describe cómo puedes explorar los datos de las métricas mediante la compilación de un gráfico temporal con el Explorador de métricas. Por ejemplo, para ver el uso de CPU de una máquina virtual (VM), puedes usar el Explorador de métricas para construir un gráfico que muestre los datos más recientes.

Puedes crear gráficos simples, 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 compartirla.

En la siguiente captura de pantalla, se muestra un solo tipo de métrica, el uso de CPU de una instancia de VM, trazado 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 tres líneas, cada una de las cuales muestra los datos de series temporales de una VM específica.

Gráfico de un solo tipo de métrica

Si deseas configurar un gráfico para que muestre una sola métrica con el Explorador de métricas, 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 Explorador de métricas .

  3. Especifica los datos que deben aparecer en el gráfico. Para usar una interfaz controlada por menús o ingresar un filtro de Monitoring, selecciona la pestaña Configuración. Para usar el lenguaje de consulta de Monitoring (MQL), selecciona la pestaña MQL.

    Pestaña Configuración

    Para configurar un gráfico, completa los siguientes pasos:

    1. Selecciona los datos de series temporales que deseas ver.
    2. (Opcional) Agrupa y alinea las series temporales.

    Selecciona los datos de series temporales que quieras ver

    Para seleccionar un recurso y una métrica, realiza una de las siguientes acciones:

    • Para graficar un tipo de métrica, como el uso de CPU de una VM, haz lo siguiente:

      1. Expande el menú Seleccionar una métrica.
      2. (Opcional) Para limitar la cantidad de opciones, 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”.
      3. Usa los menús para seleccionar un recurso y una métrica específicos. 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.
      4. Si deseas especificar un subconjunto de datos para mostrar, selecciona Agregar filtro y completa el cuadro de diálogo (opcional). 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.

    • Para trazar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

      1. Haz clic en Ayuda en el menú Seleccionar una métrica.
      2. Seleccione Modo de filtro directo.
      3. Ingresa un filtro de Monitoring en el cuadro de texto.

    Para obtener más información, consulta Selecciona métricas cuando uses el Explorador de métricas.

    (Opcional) Agrupar y alinear series temporales

    • Para mostrar todas las series temporales, deja claros los campos Agrupar por y Agregador.
    • Para agrupar series temporales por una etiqueta, usa el campo Agrupar por. Cuando se selecciona un valor para este campo, se selecciona automáticamente un valor para el campo Agregador.
    • Para especificar cómo combinar las series temporales, establece el campo Aggregator. Por ejemplo, si el campo Agrupar por está vacío y el campo Aggregator está configurado como media, el gráfico muestra el promedio de la serie temporal.
    • Para configurar cómo se procesan las series temporales individuales, selecciona Opciones avanzadas.

    Para obtener más información, consulta Cómo mostrar datos en gráficos.

    Pestaña MQL

    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
    

    En los siguientes documentos, se proporciona información sobre MQL:

    Pestaña PromQL

    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.

  4. Si trazaste un gráfico de un tipo de métrica de cuota o de métrica que tiene un tipo de valor Distribution, actualiza el parámetro de configuración del estilo del gráfico y el control de tiempo. Para otros tipos de métricas, cambiar los valores predeterminados es opcional.

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

    • Configura el control de tiempo para que sea al menos de una semana, ya que, por lo general, estas métricas informan una muestra por día.
    • En la barra de herramientas del Explorador de métricas, selecciona Gráfico de líneas y, luego, selecciona Gráfico de áreas apiladas en el menú.

    Para los tipos de métricas con valor de distribución, usa la siguiente configuración:

    • En la barra de herramientas del Explorador de métricas, selecciona Gráfico de líneas y, luego, Gráfico de mapa de calor. Para obtener más información, consulta Métricas de distribución.
  5. (Opcional) Para agregar un umbral al gráfico, ver solo los valores atípicos, comparar los datos actuales con los datos anteriores o cambiar la configuración de color, selecciona Configuración. Para obtener más información sobre tus opciones, consulta Establecer opciones de vista.

Gráfico de múltiples 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, para comparar las cargas de lectura y escritura en una VM, configura un gráfico a fin de que muestre la cantidad de bytes leídos y de bytes escritos.

Para graficar varias métricas, debes usar la pestaña Configuración. La interfaz de MQL en el Explorador de métricas no admite graficar varias métricas.

Para mostrar varias métricas 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 Explorador de métricas .
  3. Selecciona la pestaña Configuración.
  4. Para seleccionar un recurso y una métrica, realiza una de las siguientes acciones:

    • Para graficar un tipo de métrica, como el uso de CPU de una VM, haz lo siguiente:

      1. Expande el menú Seleccionar una métrica.
      2. (Opcional) Para limitar la cantidad de opciones, 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”.
      3. Usa los menús para seleccionar un recurso y una métrica específicos. 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.
      4. Si deseas especificar un subconjunto de datos para mostrar, selecciona Agregar filtro y completa el cuadro de diálogo (opcional). 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.

    • Para trazar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en las VM, ingresa un filtro de Monitoring:

      1. Haz clic en Ayuda en el menú Seleccionar una métrica.
      2. Seleccione Modo de filtro directo.
      3. Ingresa un filtro de Monitoring en el cuadro de texto.

    Para obtener más información, consulta Selecciona métricas cuando uses el Explorador de métricas.

  5. (Opcional) Agrupa y alinea series temporales:

    • Para mostrar todas las series temporales, deja claros los campos Agrupar por y Agregador.
    • Para agrupar series temporales por una etiqueta, usa el campo Agrupar por. Cuando se selecciona un valor para este campo, se selecciona automáticamente un valor para el campo Agregador.
    • Para especificar cómo combinar las series temporales, establece el campo Aggregator. Por ejemplo, si el campo Agrupar por está vacío y el campo Aggregator está configurado como media, el gráfico muestra el promedio de la serie temporal.
    • Para configurar cómo se procesan las series temporales individuales, selecciona Opciones avanzadas.

    Para obtener más información, consulta Cómo mostrar datos en gráficos.

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

    1. Seleccione Agregar otra métrica.

      La primera vez que hagas clic en Agregar otra métrica, las selecciones que realizaste antes se mostrarán en el panel expandible Series temporales A. Además, se abrirá el panel Series temporales B. Este panel contiene los campos de configuración que completas para graficar la segunda métrica.

      En la siguiente captura de pantalla, se ilustra este comportamiento:

      Ejemplo de configuración del Explorador de métricas con dos métricas.

    2. Para especificar la métrica que se agregará al gráfico, usa las opciones de configuración en el nuevo panel. Por ejemplo, para la segunda métrica, usa los campos del panel Series temporales B.

Representar gráficamente una proporción de métricas

Supervisar la cantidad de errores informados puede ser útil; sin embargo, es más probable que necesites supervisar la tasa de errores. Es decir, debes saber cuántos errores se midieron en comparación con 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 Índices de métricas.

Para mostrar una proporción de métricas 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 Explorador de métricas .

  3. Especifica los datos que deben aparecer en el gráfico. Para usar una interfaz controlada por menús o ingresar un filtro de Monitoring, selecciona la pestaña Configuración. Para usar MQL, seleccione la pestaña MQL:

    Pestaña Configuración

    1. Configura el numerador:

      1. Para seleccionar un recurso y una métrica, usa los menús.
      2. (Opcional) Agrega filtros para restringir las series temporales que se muestran.
      3. (Opcional) Actualiza los campos de agrupación y los parámetros de alineación.
    2. Seleccione Agregar otra métrica.

      Cuando haces clic en Agregar otra métrica, las selecciones que realizaste antes se muestran en el panel Series temporales A. Además, se abrirá el panel Series temporales B. Este panel contiene los campos de configuración que debes completar para graficar la segunda métrica.

      En la siguiente captura de pantalla, se ilustra este comportamiento:

      Ejemplo de configuración del Explorador de métricas con dos métricas.

    3. Configura el denominador:

      1. A fin de seleccionar un recurso y una métrica para el denominador, usa los menús del panel Series temporales-B.

        Ambas métricas deben tener el mismo tipo de métrica. Por ejemplo, si la métrica de Series temporales-A es una métrica de GAUGE, la que selecciones para Serie temporal-B debe ser de GAUGE.

      2. (Opcional) Agrega filtros para restringir las series temporales que se muestran.

      3. Asegúrate de que el valor del campo Período mínimo de alineación sea el mismo para ambas métricas.

      4. Establece los parámetros de agrupación de la segunda métrica.

        Recomendamos que los campos de agrupación para la segunda métrica coincidan con los valores de Series temporales-A. Por ejemplo, puedes agrupar ambas métricas por la etiqueta zone.

        No es necesario que uses la misma agrupación para ambas métricas. Sin embargo, solo puedes agrupar por etiquetas que sean comunes a ambas métricas.

    4. Habilite Mostrar métricas como proporción.

      Cuando realizas esta selección, la etiqueta Time Series-A pasa a llamarse Numerator y la etiqueta Time Series-B pasa a llamarse Denominator.

    5. (Opcional) Para cambiar la métrica que corresponde al numerador, haz clic en Intercambiar numerador.

    6. De manera opcional, expande Mostrar opciones de proporción para configurar las opciones de agregación secundarias.

    Pestaña MQL

    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
    

    En los siguientes documentos, se proporciona información sobre MQL:

    Pestaña PromQL

    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.

Guardar un gráfico para referencia futura

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

Para guardar un gráfico que configuraste con el Explorador de métricas como referencia futura, 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 Google Cloud Console 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. Puedes acceder a la representación JSON desde el menú Más opciones, que se encuentra en la barra de herramientas del Explorador de métricas.

      Si deseas obtener información detallada sobre cómo usar la API para administrar tus paneles personalizados, consulta Administra paneles por 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, selecciona Más opciones en la barra de herramientas del Explorador de métricas y, luego, selecciona Compartir por URL.

Cómo guardar 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 le proporciones a la API:

  • Si deseas generar la representación JSON de un gráfico que planeas agregar a un panel, configura el gráfico con el Explorador de métricas. Luego, puedes usar las opciones dentro 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.

¿Qué sigue?