Crea políticas de alertas con una condición basada en PromQL (Console)

En esta página, se describe cómo crear una política de alertas con una condición basada en PromQL mediante la consola de Google Cloud.

Antes de comenzar

  1. Si quieres obtener los permisos que necesitas para crear políticas de alertas con una condición basada en PromQL en la consola de Google Cloud, 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 y PromQL en Cloud Monitoring. Para obtener más información, consulta los siguientes temas:

  3. Configura los canales de notificaciones que deseas usar para recibir alertas. Para fines de redundancia, te recomendamos que crees varios tipos de canales de notificación. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones.

  4. Si la consulta de PromQL en tu política de alertas usa una métrica personalizada, entonces la métrica ya debe existir.

Crear políticas de alertas de PromQL

Para crear una política de alertas con una condición basada en PromQL desde la consola de Google Cloud, haz lo siguiente:

  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 sea Monitoring.

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

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

  4. Verifica que PromQL 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.

  5. Ingresa la consulta de PromQL que elige los datos que quieres supervisar. Si la opción Ejecución automática no está habilitada, haz clic en Ejecutar consulta.

    Por ejemplo, en la siguiente consulta, se resume la tasa de datos de registro de facturación transferidos en un intervalo de 60 segundos y se determina si la tasa resumida supera los 300 bytes:

    sum(rate(logging_googleapis_com:billing_bytes_ingested{monitored_resource="global"}[60s]))>300
    

    Después de ejecutar la consulta, verás un gráfico. Para un proyecto, la consulta produjo el siguiente resultado:

    Gráfico de una condición de alerta de PromQL después de especificar la alerta.

  6. Haz clic en Siguiente y configura el activador de alertas.

    1. Selecciona un valor para el Activador de alertas. Este valor especifica cuántas series temporales que muestra la consulta deben satisfacer la operación de alerta antes de que se pueda activar la política de alertas. Puedes elegir entre los siguientes criterios:

      • Cualquier serie temporal.
      • Un porcentaje de series temporales
      • Una cantidad específica de series temporales.
      • Todas las series temporales.
    2. Selecciona una ventana para volver a probar. Este campo define por cuánto tiempo se debe cumplir la condición antes de que se active la política de alertas.

      El valor predeterminado es 0 s. Con esta configuración, una sola medición puede dar como resultado una notificación. Para obtener más información y un ejemplo, consulta Configuración del período de alineación y de duración.

    3. Para seleccionar la frecuencia con la que las alertas evalúan la consulta de PromQL, elige un valor para el Intervalo de evaluación.

    4. Ingresa un nombre para la condición y haz clic en Siguiente.

  7. Agrega canales de notificaciones.

  8. Agrega etiquetas de política de alertas y documentación (opcional).

  9. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.

  10. Haz clic en Crear política.

Para conocer los pasos completos, consulta Administra las políticas de alertas.