Guía de inicio rápido para usar el lenguaje de consulta de Monitoring

En esta guía de inicio rápido, se muestra cómo usar el lenguaje de consulta de Monitoring (MQL) para explorar métricas, crear gráficos y configurar una alerta basada en consultas. En esta guía de inicio rápido, puedes hacer lo siguiente:

  1. Crea una instancia de Compute Engine.

  2. Navega al Editor de consultas.

  3. Realiza una consulta y crea un gráfico

  4. Configura una alerta basada en consultas

Antes de comenzar

Para usar MQL, debes crear un proyecto de Google Cloud y habilitar la facturación.

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyecto

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

Cree una instancia de Compute Engine

Para que un recurso de Google Cloud recopile métricas, completa los siguientes pasos y crea una instancia de Compute Engine:

  1. En el menú de Cloud Console, selecciona Compute Engine.

    Interfaz de usuario para seleccionar una instancia de procesamiento.

  2. Selecciona Crear instancia y haz clic en Crear.

Navega al Editor de consultas

Para comenzar a usar MQL, haz lo siguiente:

  1. En el menú de Cloud Console, selecciona Monitoring.

  2. En el menú Monitoring, selecciona Explorador de métricas.

  3. Selecciona la pestaña MQL.

    La interfaz cambia al editor de consultas de MQL:

    Interfaz de usuario para el editor de consultas.

Usa el Editor de consultas para crear, probar y ejecutar consultas MQL.

Realiza una consulta simple y crea un gráfico

Cree una consulta simple que grafique el uso de CPU de la instancia:

  1. Pega la siguiente consulta en el Editor de consultas.

    fetch gce_instance::compute.googleapis.com/instance/cpu/utilization
    | {
        top 1, max(val())
      ;
        bottom 1, min(val())
      }
    | union
    

    Interfaz de usuario para ingresar una consulta en el Editor de consultas.

    En esta consulta, se selecciona la serie temporal con el uso máximo y mínimo de CPU para el gráfico. Revisa Combina selecciones mediante union para obtener más información sobre esta consulta.

  2. Haga clic en Run Query. El gráfico muestra dos líneas, que indican el uso máximo y mínimo de la CPU de la instancia:

    En el gráfico, se muestra el uso máximo y mínimo de CPU.

  3. Para guardar el gráfico, haz clic en Save Chart. Asígnale un nombre al gráfico y agrégalo al panel existente o a uno nuevo. Luego, haga clic en Guardar.

    Interfaz de usuario para guardar un gráfico.

Para acceder al gráfico, ve a la página Descripción general de Monitoring o dirígete a la página del panel si lo guardaste en uno.

Configura una alerta basada en consultas

Puedes crear una política de alertas que supervise los resultados de una consulta. Para crear una política de alertas de este tipo, completa los siguientes pasos:

  1. En el menú de Cloud Console, selecciona Monitoring y, luego, Alertas.

  2. En la página Alertas, haz clic en Editar canales de notificaciones. En este paso, configurarás una dirección de correo electrónico para recibir notificaciones sobre alertas.

    1. En la página Canales de notificaciones, desplázate hacia abajo hasta Correo electrónico y haz clic en Agregar.

    2. Ingresa la dirección de correo electrónico a la que deseas que se envíen las notificaciones de alerta en el campo Dirección de correo electrónico.

    3. Ingresa una descripción breve de este canal, como “Alerta de guardia”, en el campo Nombre visible.

    4. Haz clic en Guardar.

    5. Para regresar a la página Alertas, haz clic en Atrás en el encabezado de la página.

  3. En la página Alertas, haz clic en Crear política.

    Interfaz para crear una política de alertas.

    En esta página, se te guiará a través de los pasos para crear una política de alertas:

    1. Describe lo que deseas alertar.
    2. Especifica un canal de notificación para la alerta.
    3. Proporciona información para abordar este problema.
  4. Para describir lo que deseas alertar, haz clic en Agregar condición. Esta acción activa el editor de convención basado en formularios.

    1. Haz clic en Editor de consultas  para cambiar la vista. Esta versión del editor de condiciones incluye el Editor de consultas y un panel de Configuración:

      Editor de condiciones para políticas de alertas basadas en MQL.

    2. Ingresa un nombre para tu condición, como “Condición de inicio rápido de MQL”.

    3. Para recibir una alerta cuando el tiempo de uso de CPU de tu instancia supere los 2 segundos, ingresa la siguiente consulta:

      fetch gce_instance::compute.googleapis.com/instance/cpu/usage_time
      | window 1m
      | condition val() > 2 's'
      

      La operación condition establece el umbral de rendimiento en el que deseas generar alertas. En el ejemplo, la política de alertas hace un seguimiento del tiempo de uso de la CPU superior a 2 segundos.

    4. Haz clic en Ejecutar consulta para ver los datos seleccionados y una línea de umbral:

      Gráfico de una consulta de condición de alerta.

    5. Para recibir una alerta cuando el uso de CPU de tu instancia supere el umbral y permanezca allí durante 5 minutos, usa el panel Condición de la siguiente manera:

      1. Cambia el valor del campo Por a 5 minutes.
      2. No cambies el valor del campo La condición se activa si.
    6. Para guardar tu condición en la política de alertas, haz clic en Agregar.

    7. Haz clic en Guardar. Esta acción te lleva de vuelta a la página Crea una política de alertas.

  5. Haz clic en Siguiente para ir al siguiente paso y configurar las notificaciones.

  6. Selecciona el canal de notificaciones que creaste antes y haz clic en Aceptar.

  7. Haz clic en Siguiente para avanzar al paso siguiente y proporcionar pasos para solucionar el problema.

    1. Ingresa un nombre para la política de alertas en el campo Nombre de alerta. Este valor te permite distinguir entre notificaciones de diferentes políticas de alertas.

    2. Ingresa el texto que se enviará con cualquier notificación de alerta en el campo Documentación. Por lo general, este texto brinda respuestas a los usuarios para ayudarlos a solucionar el problema. Para este ejercicio, ingresa “El uso de CPU superó 2 segundos”.

  8. Haz clic en Guardar para guardar la política.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

  1. Ve a la página Administración de identidades y accesos en Google Cloud Console:

    Ir a la configuración del proyecto

  2. Haz clic en Apagar y sigue las instrucciones.

¿Qué sigue?