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
-
Para 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 de editor de supervisión (
roles/monitoring.editor
) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.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.
Asegúrate de estar familiarizado con los conceptos generales de las políticas de alertas y de PromQL en Cloud Monitoring. Para obtener más información, consulta los siguientes temas:
Configura los canales de notificaciones que deseas usar para recibir alertas. Para fines de redundancia, te recomendamos que crees varios tipos de canales de notificaciones. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones.
Si la consulta de PromQL en tu política de alertas usa una métrica personalizada, esta ya debe existir.
Crea 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:
-
En la consola de Google Cloud, ve a la página notifications Alertas.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
En la página Alertas, haz clic en Crear política.
En Modo de configuración de políticas, selecciona Editor de código (MQL o PromQL).
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.
Ingresa la consulta de PromQL que selecciona los datos que deseas supervisar. Si la opción Ejecutar automáticamente no está habilitada, haz clic en Ejecutar consulta.
Por ejemplo, la siguiente consulta resume la tasa de datos de registro de facturación transferidos en un intervalo de 60 segundos y 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:
Haz clic en Siguiente y configura el activador de alertas.
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.
Selecciona un período para volver a realizar la prueba. Este campo define durante cuánto tiempo se debe cumplir la condición antes de que se active la política de alertas.
El valor predeterminado es 0 segundos. Con este parámetro de configuración, una sola medición puede generar una notificación. Para obtener más información y un ejemplo, consulta Configuración del período de alineación y la duración.
Para seleccionar la frecuencia con la que las alertas evalúan la consulta de PromQL, elige un valor para el Intervalo de evaluación.
Ingresa un nombre para la condición y haz clic en Siguiente.
Agrega canales de notificaciones.
Opcional: Agrega etiquetas de políticas de alertas y documentación.
Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
Haz clic en Crear política.
Para conocer los pasos completos, consulta Administrar las políticas de alertas.