Configura una alerta basada en consultas con MQL

Configura una alerta basada en consultas con MQL

En este documento, se muestra cómo usar el lenguaje de consulta de Monitoring (MQL) para explorar métricas, crear gráficos y configurar alertas basadas en consultas en la consola de Google Cloud. Si prefieres usar la API de Cloud Monitoring, consulta Crea condiciones para políticas de alertas.

En este documento, harás lo siguiente:

1. Crear una instancia de Compute Engine

2. Navega al editor de código.

3. Realiza una consulta y crea un gráfico

4. Configurar 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 la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

A continuación, configura los permisos y los canales de notificaciones.

1. Si quieres obtener los permisos que necesitas para crear políticas de alertas con una condición basada en MQL, pídele a tu administrador que te otorgue el rol de IAM Editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

   Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

   Para obtener más información sobre las funciones de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.

2. Asegúrate de estar familiarizado con los conceptos generales de las políticas de alertas, MQL y el editor de código. Para obtener más información, consulta los siguientes temas:

   • Descripción general de las alertas
   • Políticas de alertas con MQL
   • Usa el editor de código para MQL

Crear 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 la consola de Google Cloud, selecciona Compute Engine.

   

2. Selecciona Crear instancia y haz clic en Crear.

Nota: Si tienes problemas para crear una instancia, consulta la guía de inicio rápido para usar una VM de Linux.

Navega al editor de código

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

Usa el editor de código para crear, probar y ejecutar consultas de MQL.

Realiza una consulta y crea un gráfico

Crea una consulta que muestre un gráfico del uso de CPU de tu instancia:

1. Pega la siguiente consulta en el editor de código:

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

   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:

   

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, haz clic en Guardar.

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 panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

   Ir a las 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, ve a Correo electrónico y haz clic en Agregar nuevo.

   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. Haz clic en Atrás en el encabezado de la página para volver a la página Alertas.

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

   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. Proporciona información para abordar este problema.
   3. Especifica un canal de notificación para la alerta.

4. Para describir sobre qué deseas generar alertas, haz clic en Condición nueva. Esta acción abre el editor de condiciones basado en el formulario.

   1. En Modo de configuración de políticas, selecciona Editor de código (MQL o PromQL).

   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 la consulta que elige los datos que quieres supervisar en el editor de código. La siguiente consulta activa una alerta cuando el tiempo de uso de CPU de la instancia se mantiene superior a 20 segundos:

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

      La operación condition establece el umbral de rendimiento sobre el que deseas alertar. Para obtener más información sobre condition y otras operaciones de alerta, consulta Alertas en la referencia de MQL.

      Si la opción Ejecución automática está habilitada, el gráfico de MQL mostrará los datos seleccionados y una línea de umbral:

      

   4. Para configurar el activador de alertas, haz clic en Siguiente:

      1. En el menú Activador de alertas, selecciona la cantidad de series temporales que deben cumplir con la operación de alertas para que se pueda activar la política de alertas. Puedes elegir entre los siguientes criterios:

         • Una serie temporal individual.
         • Una cantidad específica de series temporales.
         • Un porcentaje de series temporales
         • Todas las series temporales.

      2. Opcional: Expande el menú Opciones avanzadas y, en el campo Activar cuando se cumpla la condición para esta cantidad de tiempo, ingresa o selecciona un valor.

         Este campo define por cuánto tiempo debe cumplirse la condición antes de que se active la política de alertas. La ventana para volver a probar no es la misma que la ventana de alineación que se usa en la consulta de MQL. Para obtener más información sobre la relación entre estos valores, consulta El período de alineación y la duración.

      3. Ingresa un nombre para la condición, como “Condición de MQL básica”.

5. Para configurar las notificaciones, la documentación y el nombre de la política de alertas, haz clic en Siguiente.

   1. Selecciona el canal de notificaciones que creaste anteriormente.

   2. Elige un nivel de gravedad.

   3. 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 “Your CPU usage has exceeded 20 seconds”.

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

6. Haz clic en Crear política para guardar tu política.

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página.

1. Ve a la página Identity and Access Management en la consola de Google Cloud:

   Ir a la configuración del proyecto

2. Haz clic en Apagar y sigue las instrucciones.

¿Qué sigue?

• Obtén más información sobre cómo usar el editor de código.
• Explora un conjunto de ejemplos de MQL.
• Obtén más información sobre las políticas de alertas basadas en MQL.
• Aprende a invocar consultas de MQL desde la API de Cloud Monitoring.
• Explora los detalles de MQL en la Referencia de MQL.
• Lee nuestros recursos sobre DevOps y explora el programa de investigación de DORA.