Crea gráficos con el Explorador de métricas

En este documento, se describe cómo compilar datos gráficos para crear 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 a fin de crear un gráfico que muestre los datos más recientes.

Puedes crear gráficos simples, como los que representan un solo tipo de métrica, y gráficos complejos, como los que representan varios tipos de métrica. 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, en la página Explorador de métricas:

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

La captura de pantalla anterior muestra tres líneas, cada una de las cuales muestra los datos de series temporales para una VM específica.

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

Si deseas configurar un gráfico para mostrar una sola métrica con el Explorador de métricas, haz lo siguiente:

  1. En 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. En la barra de herramientas, selecciona la pestaña Explorador.

  4. Especifica los datos que deben aparecer en el gráfico. Para usar una interfaz controlada por menú 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 Configuration

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

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

    Selecciona los datos de las series temporales que deseas ver

    Selecciona un recurso y una métrica mediante una de las siguientes opciones:

    • Para trazar 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. Para limitar la cantidad de opciones, ingresa el nombre de la métrica o el recurso en la barra de filtros (opcional). Por ejemplo, para graficar la latencia de la solicitud de una instancia de VM, puedes ingresar “latencia”.
      3. Usa los menús para seleccionar una métrica y un recurso 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. Haga clic en Aplicar.
      4. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, selecciona Add filter (Agregar filtro) y 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.

    • Para trazar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en 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 las métricas cuando uses el Explorador de métricas.

    (Opcional) Agrupa y alinea series temporales

    • Para mostrar todas las series temporales, deja vacíos los campos Group By y Aggregator.
    • 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 Agregador. Por ejemplo, si el campo Agrupar por está vacío y el campo Agregador está configurado en media, el gráfico muestra el promedio de las series temporales.
    • Para configurar cómo se procesan las series temporales individuales, selecciona Opciones avanzadas.

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

    Pestaña MQL

    Ingresa tu consulta en el editor de consultas. Por ejemplo, para graficar la utilización 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
    

    Los siguientes documentos proporcionan información sobre MQL:

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

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

    • Establece que el control de tiempo sea al menos una semana porque estas métricas suelen informar 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.
  6. Para agregar un umbral al gráfico, ver solo los valores atípicos, comparar los datos actuales con los anteriores o cambiar la configuración de color, selecciona Settings (opcional). Para obtener más información sobre tus opciones, consulta Cómo configurar opciones de vista.

Crear gráficos de varios tipos de métricas

En algunas situaciones, es posible que desees mostrar series temporales de diferentes tipos 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 mostrar la cantidad de bytes leídos y de bytes escritos.

Para graficar varias métricas, debes usar la pestaña Configuration. La interfaz de MQL en el Explorador de métricas no admite el gráfico de varias métricas.

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

  1. En 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. En la barra de herramientas, selecciona la pestaña Explorador.
  4. Selecciona la pestaña Configuración.
  5. Selecciona un recurso y una métrica mediante una de las siguientes opciones:

    • Para trazar 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. Para limitar la cantidad de opciones, ingresa el nombre de la métrica o el recurso en la barra de filtros (opcional). Por ejemplo, para graficar la latencia de la solicitud de una instancia de VM, puedes ingresar “latencia”.
      3. Usa los menús para seleccionar una métrica y un recurso 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. Haga clic en Aplicar.
      4. (Opcional) Si quieres especificar un subconjunto de datos para mostrar, selecciona Add filter (Agregar filtro) y 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.

    • Para trazar un objetivo de nivel de servicio o el recuento de procesos que se ejecutan en 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 las métricas cuando uses el Explorador de métricas.

  6. (Opcional) Agrupa y alinea series temporales:

    • Para mostrar todas las series temporales, deja vacíos los campos Group By y Aggregator.
    • 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 Agregador. Por ejemplo, si el campo Agrupar por está vacío y el campo Agregador está configurado en media, el gráfico muestra el promedio de las series temporales.
    • Para configurar cómo se procesan las series temporales individuales, selecciona Opciones avanzadas.

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

  7. 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 hayas realizado antes se mostrarán en el panel Series temporales A expandible. 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 la configuración del Explorador de métricas con dos métricas.

    2. Para especificar la métrica que quieres 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.

Representa 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 la cantidad total de respuestas. Para cumplir con este requisito, puedes configurar un gráfico a fin de 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 las proporciones de las métricas, consulta Proporción de métricas.

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

  1. En 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. En la barra de herramientas, selecciona la pestaña Explorador.

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

    Pestaña Configuration

    1. Configura el numerador:

      1. Para seleccionar un recurso y una métrica, usa los menús.
      2. (Opcional) Para restringir las series temporales que se muestran, agregue filtros.
      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 completas para graficar la segunda métrica.

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

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

    3. Configura el denominador:

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

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

      2. (Opcional) Para restringir las series temporales que se muestran, agregue filtros.

      3. Asegúrate de que el valor del campo Período de alineación mínimo 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 Serie temporal-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 son comunes a ambas métricas.

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

      Cuando realizas esta selección, la etiqueta Time-Series-A cambia de nombre a Numerator y la etiqueta Time Series-B, Denominator.

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

    6. (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 la utilización 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
    

    Los siguientes documentos proporcionan información sobre MQL:

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, se descarta el gráfico.

Si deseas guardar un gráfico que configuraste con el Explorador de métricas para 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 los 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 panel personalizado existente o puedes 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 quieres 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.

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 proporciones a la API:

  • Para 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 controlada por 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 equivalente de Monitoring.

¿Qué sigue?