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 más de 2 años de datos.
Si usas Prometheus en entornos fuera de 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.
- Para obtener información general sobre el uso de PromQL en Monitoring, consulta PromQL en Cloud Monitoring.
- Para obtener información general sobre las políticas de alertas, consulta 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:
Para crear una política de alertas en la consola de Google Cloud y definir una consulta de PromQL en el editor de código, consulta Crea políticas de alertas basadas en PromQL (consola).
Para crear una política de alertas basada en PromQL con gcloud CLI o el constructor
AlertPolicyen la API de Monitoring, consulta Crea políticas de alertas basadas en PromQL (API).Para migrar tus reglas de alertas y canales de notificación de Prometheus a Cloud Monitoring con Google Cloud CLI, consulta Migra reglas de alertas y receptores de Prometheus.
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 Google Cloud métricas del sistema, 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 Cómo asignar métricas de Monitoring a PromQL.
Consultar 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 hasta 2 años de datos de métricas. Esto admite casos de uso como los siguientes:
- Detecta anomalías comparando los últimos 5 minutos con el mismo período de 5 minutos de hace 1 semana.
- Se ejecuta 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 en más de 3 desviaciones estándar de ese promedio
- Usar la función
predict_linearen los datos de la última semana 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 se define por la suma del período de alineación y cualquier cambio de tiempo causado por el uso del modificador offset, se pueden evaluar con una frecuencia de hasta cada 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 qué tan atrás en el tiempo se remonta tu política de alertas:
| Período de retrovisió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 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 pase por alto ningún dato. Por ejemplo, si tu intervalo de evaluación es de 1 hora, tu consulta debería verse así: 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 del Explorador de métricas. Si tu consulta de PromQL no agota el tiempo de espera en el Explorador de métricas, tampoco lo hará en tu alerta.
Las políticas de alertas de PromQL son mucho más confiables cuando operan con los datos de las últimas 25 horas. Para obtener la máxima confiabilidad, asegúrate de que la suma del período de nueva prueba, 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 nueva prueba están inhabilitadas para las consultas de alertas de PromQL que acceden a datos de más de 25 horas de antigüedad.
Solo puedes generar alertas sobre los datos de las últimas 25 horas para las métricas personalizadas (prefijo custom.googleapis.com) y las métricas basadas en registros definidas por el usuario (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 hasta 24 horas. Si usas un período de nueva prueba, la suma de este, 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.
Precios
Para obtener información sobre los precios de Cloud Monitoring, consulta la página Precios de Google Cloud Observability.