Usa PromQL para crear políticas de alertas

Las consultas de lenguaje de consulta de Prometheus (PromQL) en Cloud Monitoring te permiten crear políticas de alertas con condiciones complejas, como proporciones de métricas, umbrales dinámicos basados en otra métrica y métricas combinadas. Estas políticas pueden evaluar hasta 2 años de datos de métricas.

Si usas Prometheus en entornos fuera de Google Cloud o usas alertas en Google Cloud Managed Service para Prometheus, puedes migrar tus reglas de alertas de Prometheus a políticas de alertas basadas en PromQL. La migración de tus reglas te permite administrar todas tus políticas de alertas en Monitoring. También puedes importar paneles de Grafana a Cloud Monitoring. Para obtener información general sobre cómo usar PromQL y cómo las políticas de alertas evalúan los datos, consulta PromQL en Cloud Monitoring y Comportamiento de las políticas de alertas basadas en métricas.

Usa PromQL en las políticas de alertas de Cloud Monitoring

Puedes crear políticas de alertas basadas en PromQL de las siguientes maneras:

Las alertas creadas por una política de alertas basada en PromQL aparecen en la consola de Google Cloud junto con tus otras alertas. Puedes interactuar con estas alertas en la consola de Google Cloud .

Las condiciones de tu política de alertas basada en PromQL pueden hacer referencia a cualquier métrica de Cloud Monitoring, incluidas las métricas del sistema Google Cloud , las métricas personalizadas y las métricas basadas en registros, y las métricas de Prometheus. Debes traducir los nombres de las métricas que no son de Prometheus a la sintaxis de métricas de PromQL. Para obtener más información, consulta Asigna métricas de Monitoring a PromQL.

Consulta más de 2 años de datos de métricas

A diferencia de otros tipos de políticas de alertas que solo admiten consultas de más de 25 horas de datos de métricas, puedes usar PromQL para generar alertas de hasta 2 años de datos de métricas. Esto admite casos de uso como los siguientes:

  • Detectar anomalías comparando los últimos 5 minutos con el mismo período de 5 minutos de hace 1 semana
  • Ejecutar una política de alertas de consumo lento de 7 días
  • Obtener el valor promedio del último mes y generar una alerta si la hora de datos más reciente se desvía más de 3 desviaciones estándar de ese promedio.
  • Usa la función predict_linear en la última semana de datos para ver si superarás un umbral al día siguiente.

Las políticas de alertas de PromQL que operan en las 25 horas de datos más recientes, según lo define la suma del período de alineación y cualquier cambio de tiempo causado por el uso del modificador offset, pueden evaluarse con una frecuencia de 30 segundos. Las políticas que operan con datos más antiguos se evalúan con menos frecuencia, y el período mínimo se determina según el tiempo que abarca la política de alertas:

Período de visualización de la consulta Intervalo de evaluación mínimo (predeterminado)
Hasta 25 horas1 30 segundos
De 25 horas a 8 días 5 minutos
De 8 a 16 días 1 hora
De 16 a 32 días 2 horas
De 32 a 93 días 6 horas
De 93 días a 2 años 12 horas

1 Algunas métricas de los servicios de Google Cloud solo admiten intervalos de evaluación de 30 segundos durante un máximo de 23 horas y 30 minutos.

Asegúrate de establecer las duraciones de rate para que sean al menos tan largas como tu intervalo de evaluación, de modo que tu política de alertas no omita ningún dato. Por ejemplo, si tu intervalo de evaluación es de 1 hora, tu consulta debería verse como rate(metric[1h]).

Las condiciones que operan en más de 25 horas de datos tienen un plazo de consulta de 2 minutos, que coincide con el plazo en el Explorador de métricas. Si tu consulta de PromQL no agota el tiempo de espera en el Explorador de métricas, no se agotará el tiempo de espera en tu alerta.

Las políticas de alertas de PromQL son mucho más confiables cuando se ejecutan en las últimas 25 horas de datos. Para obtener la máxima confiabilidad, asegúrate de que la suma de tu ventana de nueva prueba, el período de alineación y cualquier cambio de hora causado por el uso del modificador offset sean de 25 horas como máximo.

Las ventanas de reevaluación están inhabilitadas para las consultas de alertas de PromQL que acceden a datos con más de 25 horas de antigüedad.

Solo puedes recibir alertas sobre las 25 horas de datos más recientes de las métricas personalizadas (el prefijo custom.googleapis.com) y las métricas basadas en registros definidas por el usuario (el prefijo logging.googleapis.com/user/).

Restricciones

No agregues filtros que usen etiquetas de metadatos del sistema a tus políticas de alertas basadas en PromQL.

Una política de alertas basada en PromQL puede tener un período de nueva prueba de 24 horas como máximo. Si usas una ventana de reevaluación, la suma de esta ventana, el período de alineación y cualquier cambio de hora causado por el uso del modificador offset debe ser de 25 horas como máximo.

Si tu regla de alertas de Prometheus hace referencia a una métrica, primero debes tener un descriptor de métrica equivalente en Cloud Monitoring antes de crear tu política de alertas basada en PromQL. Sin embargo, puedes anular esta validación configurando tu política de alertas basada en PromQL con la API de Cloud Monitoring. Para obtener más información, consulta Inhabilita la verificación de la existencia de métricas.

Si tu política de alertas supervisa una proporción de métricas, establece la duración en al menos el doble de su intervalo de evaluación. Las duraciones más cortas pueden generar alertas falsas. Para obtener más información, consulta Alertas falsas debido a anomalías en el cálculo de la proporción.