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 las métricas. crear gráficos y configurar una alerta basada en consultas en la consola de Google Cloud. Si prefieres usar la API de Cloud Monitoring, Luego, consulta Crea condiciones para las 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. 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

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

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

   También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

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

2. Asegúrate de familiarizarte 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

Crea 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 con una VM de Linux.

Navega al editor de código

Para comenzar a usar MQL, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de métricas:

   Dirígete al Explorador de métricas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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 grafica el 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 la consola de Google Cloud, ve a la página  Alertas.

   Ir a las Alertas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

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, luego, 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 alertar, haz clic en Condición nueva. Esta acción muestra el editor de condiciones basado en formularios.

   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 selecciona los datos que deseas supervisar en la en tu editor de código fuente. La siguiente consulta activa una alerta cuando El tiempo de uso de la CPU 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 que deseas. alertas. Para obtener más información condition y otras operaciones de alerta, consulta Alertas en la referencia de MQL.

      Si la ejecución automática está habilitada, el gráfico de MQL muestra 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 debe satisfacer la operación de alerta antes de que esta por qué se puede activar la política. 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 Activar cuando se cumple la condición para esta cantidad de tiempo ingresa o selecciona un valor.

         Este campo define por cuánto tiempo debe permanecer antes de que se active la política de alertas. El La ventana para volver a probar no es lo mismo. como 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 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 "Tu uso de CPU superó los 20 segundos".

   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 usaste 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.