Usa PromQL para crear políticas de alertas

En esta página, se describe cómo puedes crear políticas de alertas basadas en PromQL en Cloud Monitoring. Puedes usar consultas de PromQL para crear condiciones complejas con funciones como proporciones, umbrales dinámicos basados en una métrica diferente y métricas combinadas. También puedes configurar políticas de alertas basadas en PromQL para que operen con datos de más de 2 años.

Si usas Prometheus en entornos externos Google Cloud, o si usas alertas en Managed Service para Prometheus, puedes migrar tus reglas de alertas de Prometheus a políticas de alertas basadas en PromQL. De esta manera, puedes administrar todas tus políticas de alertas en Cloud Monitoring.

También puedes importar paneles de Grafana a Cloud Monitoring.

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

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

Los incidentes creados por una política de alertas basada en PromQL aparecen en la Google Cloud consola con tus otros incidentes. Puedes interactuar con estos incidentes en la Google Cloud consola.

Las condiciones de tu política de alertas basada en PromQL pueden hacer referencia a cualquier métrica en Cloud Monitoring, incluidas Google Cloud las métricas del sistema, las métricas personalizadas y 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 datos de métricas de más de 2 años

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 sobre datos de métricas de hasta 2 años. 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 alertas si la hora más reciente de datos es más de 3 desviaciones estándar de ese promedio
  • Usar la función predict_linear en la última semana de datos para ver si excederás un umbral al día siguiente

Las políticas de alertas de PromQL que operan en las últimas 25 horas de datos, según se define en la suma del período de alineación y cualquier cambio de hora causado por el uso del modificador offset, pueden evaluarse con una frecuencia de hasta 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 la antigüedad de la política de alertas:

Rango de retroceso 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 Google Cloud servicios solo admiten intervalos de evaluación de 30 segundos durante un máximo de 23 horas y 30 minutos.

Asegúrate de configurar 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 pierda 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 con 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 lo hará en tu alerta.

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

Las ventanas de repetición de pruebas están inhabilitadas para las consultas de alertas de PromQL que acceden a datos de más de 25 horas.

Solo puedes generar alertas sobre las últimas 25 horas de datos para 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 una ventana de repetición de pruebas de 24 horas como máximo. Si usas una ventana de repetición de pruebas, la suma de tu ventana de repetición de pruebas, 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 si configuras 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 incidentes falsos. Para obtener más información, consulta Alertas falsas debido a anomalías en el cálculo de la proporción.

Precios

Para obtener información sobre los precios de Cloud Monitoring, consulta la página de precios de Google Cloud Observability.