Crea políticas de alertas de valores de métricas previstos

Las políticas de alertas de valores de métricas previstas en Cloud Monitoring envían notificaciones cuando una previsión predice que una serie temporal cruzará un umbral que definas dentro de un próximo período de previsión. Puedes usar la consola deGoogle Cloud para configurar una ventana de previsión de 1 hora (3,600 segundos) a 2.5 días (216,000 segundos) para que tengas tiempo de responder antes de que se produzca un incumplimiento del umbral.

Este contenido no se aplica a las políticas de alertas basadas en registros. Para obtener información sobre las políticas de alertas basadas en registros, que te notifican cuando aparece un mensaje específico en tus registros, consulta Supervisa tus registros.

Para recibir notificaciones cuando los valores de las métricas actuales superen un umbral o cuando dejen de llegar datos, consulta Crea políticas de alertas de límite de métrica y Crea políticas de alertas de ausencia de métrica. Para crear políticas de alertas de forma programática con la API de Cloud Monitoring, consulta Crea políticas de alertas con la API. Para crear políticas de alertas que usen consultas del lenguaje de consultas de Monitoring (MQL) con umbrales estáticos o dinámicos, consulta Políticas de alertas con MQL y Crea niveles de gravedad dinámicos con MQL.

Esta función solo se admite para proyectos de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

Acerca de las condiciones de previsión

Puedes usar la previsión cuando supervisas la mayoría de las métricas. Sin embargo, cuando supervisas un recurso restringido, como la cuota, el espacio en el disco o el uso de memoria, una condición de previsión puede notificarte antes de que se infrinja el umbral. Esa capacidad te da más tiempo para responder a cómo se consume ese recurso restringido antes de que se incumpla el umbral.

Para cada serie temporal que supervisa una condición de previsión, la condición crea una instancia de un algoritmo de decisión. Después de entrenar ese algoritmo, genera una previsión cada vez que se evalúa la condición. Cada previsión es una predicción de que su serie temporal incumplirá o no el umbral dentro del período de previsión. Si una serie temporal supervisada tiene una periodicidad regular, el algoritmo de decisión para esa serie temporal incorpora el comportamiento periódico en sus previsiones.

Se cumple una condición de previsión cuando se produce una de las siguientes situaciones o ambas:

• Todos los valores de una serie temporal durante una ventana de nueva prueba específica incumplen el umbral.
• Todas las previsiones para una serie temporal específica que se realizan en un período de nueva prueba predicen que la serie temporal incumplirá el umbral dentro del período de previsión.

El tiempo de entrenamiento inicial de un algoritmo de decisión es el doble de la duración de la ventana de previsión. Por ejemplo, si el período de previsión es de una hora, se requieren dos horas de tiempo de entrenamiento. El algoritmo de decisión para cada serie temporal se entrena de forma independiente. Mientras se entrena un algoritmo de decisión, su serie temporal cumple con la condición solo cuando los valores de la serie temporal infringen el umbral de la ventana de reevaluación especificada.

Una vez que se completa el entrenamiento inicial, cada algoritmo de decisión se entrena de forma continua con datos que abarcan hasta seis veces la duración de la ventana de previsión. Por ejemplo, cuando la ventana de previsión es de una hora, se usan las seis horas de datos más recientes durante el entrenamiento continuo.

Cuando configuras una condición de previsión y, luego, los datos dejan de llegar durante más de 10 minutos, se inhabilita la previsión y la condición funciona como una condición de umbral de métrica.

Las alertas se crean cuando la previsión predice que una serie temporal incumplirá el umbral de la condición dentro del período de previsión. La supervisión cierra automáticamente la alerta cuando la previsión predice que la serie temporal no incumplirá el umbral dentro del período de previsión.

Antes de comenzar

1. Para obtener los permisos que necesitas para crear y modificar políticas de alertas con la consola de Google Cloud , pídele a tu administrador que te otorgue el rol de IAM de editor de Monitoring (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 a través de 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.

2. Asegúrate de estar familiarizado con los conceptos generales de las políticas de alertas. Para obtener información sobre estos temas, consulta Descripción general de alertas.

3. Configura los canales de notificación que deseas usar para recibir notificaciones. 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.

Crear política de alertas

Para crear una política de alertas que envíe una notificación basada en una previsión, haz lo siguiente:

1. En la consola de Google Cloud , ve a la página Alertas notifications:

   Ir a las Alertas

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.

2. En la barra de herramientas de la consola de Google Cloud , selecciona tu proyecto de Google Cloud . Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
3. Selecciona Crear política.

4. Selecciona las series temporales que deseas supervisar:

   1. Haz clic en Seleccionar una métrica, navega por los menús para seleccionar un tipo de recurso y un tipo de métrica, y, luego, haz clic en Aplicar.

      El menú Seleccionar una métrica contiene funciones que te ayudan a encontrar los tipos de métricas disponibles:

      • Para encontrar un tipo de métrica específico, usa la barra de filtros filter_list. Por ejemplo, si ingresas util, restringes el menú para que muestre las entradas que incluyen util. Las entradas se muestran cuando pasan una prueba de "contiene" que no distingue mayúsculas de minúsculas.
      • Para mostrar todos los tipos de métricas, incluso las que no tienen datos, haz clic en done Activa. De forma predeterminada, los menús solo muestran los tipos de métricas con datos. Para obtener más información, consulta La métrica no aparece en el menú.

      Puedes supervisar cualquier métrica integrada o cualquier tipo de métrica definida por el usuario que tenga un tipo de valor de doble o int64, que sea una métrica de restricción y que no sea una métrica para una instancia de VM de Amazon.

      Si seleccionas un tipo de métrica que genera la supervisión de más de 64 series temporales, Monitoring realiza previsiones para las 64 series temporales cuyos valores están más cerca del umbral o que ya lo incumplen. Para otras series temporales, sus valores se comparan con el umbral.

   2. Opcional: Para supervisar un subconjunto de las series temporales que coinciden con los tipos de métricas y recursos que seleccionaste en el paso anterior, haz clic en Agregar filtro. En el diálogo de filtro, selecciona la etiqueta por la que deseas filtrar, un comparador y, luego, el valor del filtro. Por ejemplo, el filtro zone =~ ^us.*.a$ usa una expresión regular para hacer coincidir todos los datos de series temporales cuyo nombre de zona comienza con us y termina con a. Para obtener más información, consulta Cómo filtrar la serie temporal seleccionada.

   3. Opcional: Para cambiar la forma en que se alinean los puntos en una serie temporal, en la sección Transforma los datos, configura los campos Ventana progresiva y Función de ventana progresiva.

      Si supervisas una métrica basada en registros, te recomendamos que el menú Ventana móvil esté configurado en al menos 10 minutos.

      Estos campos especifican cómo se combinan los puntos que se registran en una ventana. Por ejemplo, supongamos que la ventana es de 15 minutos y la función analítica es max. El punto alineado es el valor máximo de todos los puntos en los 15 minutos más recientes. Para obtener más información, consulta Alineación: regularización dentro de la serie.

      También puedes supervisar la velocidad a la que cambia el valor de una métrica configurando el campo Función de ventana móvil en Cambio porcentual. Para obtener más información, consulta Supervisa una tasa de cambio.

   4. Opcional: Combina series temporales cuando quieras reducir la cantidad de series temporales que supervisa una política o cuando quieras supervisar solo una colección de series temporales. Por ejemplo, en lugar de supervisar el uso de CPU de cada instancia de VM, es posible que desees calcular el promedio del uso de CPU de todas las VMs de una zona y, luego, supervisar ese promedio. De forma predeterminada, las series temporales no se combinan. Para obtener información general, consulta Reducción: combinación de series temporales.

      Para combinar todas las series temporales, haz lo siguiente:

      1. En la sección En todas las series temporales, haz clic en expand_more Expandir.
      2. Establece el campo Agregación de series temporales en un valor que no sea none. Por ejemplo, para mostrar el valor promedio de la serie temporal, selecciona mean.
      3. Asegúrate de que el campo Agrupación de series temporales esté vacío.

      Para combinar o agrupar series temporales por valores de etiquetas, haz lo siguiente:

      1. En la sección A través de series temporales, haz clic en expand_more Expandir.
      2. Establece el campo Agregación de series temporales en un valor distinto de none.
      3. En el campo Agrupar series temporales por, selecciona las etiquetas por las que se agruparán.

      Por ejemplo, si agrupas por la etiqueta zone y, luego, configuras el campo de agregación en un valor de mean, el gráfico mostrará una serie temporal para cada zona de la que haya datos. La serie temporal que se muestra para una zona específica es el promedio de todas las series temporales con esa zona.

   5. Haz clic en Siguiente.

5. Configura el activador de condición:

   1. Selecciona Previsión para el tipo de condición.

   2. Opcional: Actualiza el menú Activador de alerta, que tiene los siguientes valores:

      • Cualquier serie temporal tiene incumplimientos: Es el parámetro de configuración predeterminado. La condición se cumple si alguna serie temporal incumple el umbral o se prevé que lo incumpla durante todo el período de nueva prueba.

      • Porcentaje de incumplimientos de la serie temporal: Un porcentaje de la serie temporal debe incumplir el umbral o se debe prever que lo incumplirá durante todo el período de nueva prueba antes de que se cumpla la condición. Por ejemplo, puedes recibir una notificación cuando el 50% de las series temporales supervisadas incumplan el umbral durante toda la ventana de reevaluación.

      • Una cantidad de series temporales tiene incumplimientos: Una cantidad específica de series temporales debe incumplir el umbral o se debe prever que lo incumplirá durante todo el período de nueva prueba antes de que se cumpla la condición. Por ejemplo, puedes recibir una notificación cuando 32 de las series temporales supervisadas incumplan el umbral durante toda la ventana de nueva prueba.

      • Todas las series temporales tienen incumplimientos: Todas las series temporales deben incumplir el umbral o se debe prever que lo incumplirán durante todo el período de nueva prueba antes de que se cumpla la condición.

      Para obtener información sobre los intervalos que Monitoring usa para alinear y medir los datos de series temporales, consulta Períodos de alineación y ventanas de reevaluación.

   3. Selecciona un valor para la Ventana de previsión. El valor que selecciones será la cantidad de tiempo en el futuro para la previsión. Debes establecer este valor en al menos 1 hora (3,600 segundos) y en un máximo de 2.5 días (216,000 segundos).

   4. Ingresa cuando el valor previsto de la métrica seleccionada incumpla el umbral con los campos Posición del umbral y Valor del umbral. Por ejemplo, si estableces estos valores en Por encima del umbral y 10, cualquier valor previsto superior a 10 incumple el umbral.

   5. Opcional: Expande Opciones avanzadas y establece el valor de la Ventana de nueva prueba. El valor predeterminado de este campo es No volver a probar.

      Te recomendamos que establezcas este campo en al menos 10 minutos.

      Por ejemplo, supongamos que configuras la condición de previsión de modo que cualquier serie temporal pueda hacer que se cumpla la condición. También supón que el Período para volver a probar se establece en 15 minutos, el Período de previsión se establece en 1 hora y se produce un incumplimiento cuando el valor de la serie temporal es superior al Umbral, que se establece en 10. La condición se cumple si se produce alguna de las siguientes situaciones:

      • Todos los valores de una serie temporal superan el 10 y permanecen allí durante al menos 15 minutos.
      • En un intervalo de 15 minutos, cada previsión para una serie temporal predice que su valor aumentará por encima del umbral de 10 en algún momento dentro de la próxima hora.

   6. Opcional: Para especificar cómo Monitoring evalúa la condición cuando dejan de llegar datos, expande Opciones avanzadas y, luego, usa el menú Evaluación de datos faltantes.

      El menú Evaluación de datos faltantes se inhabilita cuando el valor de la Ventana de nueva prueba es No volver a probar.

      Cuando faltan datos durante más de 10 minutos, una condición de previsión deja de generar previsiones y, en su lugar, usa el valor del campo Evaluación de datos faltantes para determinar cómo administrar las alertas. Cuando se reinician las observaciones, también se reinicia la previsión.

      Campo "Evaluación de datos faltantes" de laGoogle Cloud consola	Resumen	Detalles
      Tratar datos faltantes como vacíos	Las alertas abiertas permanecen abiertas. No se abren Alertas de Google Noticias nuevas.	En el caso de las condiciones que se cumplen, la condición sigue cumpliéndose cuando dejan de llegar datos. Si hay una alerta abierta para esta condición, permanecerá abierta. Cuando se abre una alerta y no llegan datos, el temporizador de cierre automático comienza después de una demora de al menos 15 minutos. Si vence el temporizador, se cierra la alerta. En el caso de las condiciones que no se cumplen, la condición sigue sin cumplirse cuando dejan de llegar datos.
      Los datos faltantes se tratan como valores que incumplen la condición de la política	Las alertas abiertas permanecen abiertas. Se pueden abrir alertas nuevas.	En el caso de las condiciones que se cumplen, la condición se sigue cumpliendo cuando dejan de llegar datos. Si hay una alerta abierta para esta condición, permanecerá abierta. Cuando una alerta está abierta y no llegan datos durante el período de cierre automático más 24 horas, se cierra la alerta. En el caso de las condiciones que no se cumplen, este parámetro de configuración hace que la condición de umbral de métrica se comporte como un metric-absence condition. Si los datos no llegan en el período especificado por la ventana de nueva prueba, la condición se evalúa como cumplida. En el caso de una política de alertas con una condición, cuando se cumple esa condición, se abre una alerta.
      Los datos faltantes se tratan como valores que no infringen la condición de la política	Se cierran las alertas abiertas. No se abren Alertas de Google Noticias nuevas.	En el caso de las condiciones que se cumplen, la condición deja de cumplirse cuando dejan de llegar datos. Si hay una alerta abierta para esta condición, se cerrará. En el caso de las condiciones que no se cumplen, la condición sigue sin cumplirse cuando dejan de llegar datos.

   7. Haz clic en Siguiente.

6. Opcional: Crea una política de alertas con varias condiciones.

   La mayoría de las políticas supervisan un solo tipo de métrica. Por ejemplo, una política podría supervisar la cantidad de bytes escritos en una instancia de VM. Cuando desees supervisar varios tipos de métricas, crea una política con varias condiciones. Cada condición supervisa un tipo de métrica. Después de crear las condiciones, debes especificar cómo se combinan. Para obtener más información, consulta Políticas con varias condiciones.

   Para crear una política de alertas con varias condiciones, haz lo siguiente:

   1. Para cada condición adicional, haz clic en Agregar condición de alerta y, luego, configura esa condición.
   2. Haz clic en Siguiente y configura cómo se combinan las condiciones.
   3. Haz clic en Siguiente para avanzar a la configuración de las notificaciones y la documentación.

7. Configura la notificación y agrega etiquetas de usuario:

   1. Expande el menú Notificaciones y nombre y selecciona tus canales de notificaciones. Para fines de redundancia, te recomendamos que agregues varios tipos de canales de notificaciones a una política de alertas. Para obtener más información, consulta Administra canales de notificaciones.

   2. Opcional: Para usar un asunto personalizado en la notificación en lugar del predeterminado, actualiza el campo Asunto de la notificación.

   3. Para recibir notificaciones cuando se cierre una alerta, selecciona Notificar cuando se cierre una alerta. De forma predeterminada, cuando creas una política de alertas con la Google Cloud consola, solo se envía una notificación cuando se crea una alerta.

   4. Opcional: Para cambiar el tiempo que espera el Monitoreo antes de cerrar una alerta después de que dejan de llegar datos, selecciona una opción en el menú Duración del cierre automático de alertas. De forma predeterminada, cuando los datos dejan de llegar, Monitoring espera siete días antes de cerrar una alerta abierta.

   5. Opcional: Para asociar tu política de alertas con una aplicación de App Hub, en la sección Etiquetas de aplicación, selecciona una aplicación y un servicio o una carga de trabajo. Las alertas y notificaciones muestran estas etiquetas.

   6. Opcional: Selecciona una opción en el menú Nivel de gravedad de la política. Las alertas y notificaciones muestran el nivel de gravedad.

   7. Opcional: Para agregar etiquetas personalizadas a la política de alertas, en la sección Etiquetas de usuario de la política, haz lo siguiente:

      1. Haz clic en Agregar etiqueta y, en el campo Clave, ingresa un nombre para la etiqueta. Los nombres de las etiquetas deben comenzar con una letra minúscula y pueden contener letras minúsculas, números, guiones bajos y guiones. Por ejemplo, ingresa severity.
      2. Haz clic en Valor y, luego, ingresa un valor para la etiqueta. Los valores de etiqueta pueden contener letras en minúscula, números, guiones bajos y guiones. Por ejemplo, ingresa critical.

      Para obtener información sobre cómo puedes usar etiquetas de política para administrar tus notificaciones, consulta Anota alertas con etiquetas.

8. Opcional: En la sección Documentación, ingresa el contenido que quieras incluir en la notificación.

   Para dar formato a tu documentación, puedes usar texto sin formato, Markdown y variables. También puedes incluir vínculos para ayudar a los usuarios a depurar la alerta, como vínculos a manuales internos, Google Cloud paneles y páginas externas. Por ejemplo, la siguiente plantilla de documentación describe una alerta de uso de CPU para un recurso gce_instance y contiene varias variables para hacer referencia a los recursos de REST de la política de alertas y la condición. Luego, la plantilla de documentación dirige a los lectores a páginas externas para ayudarlos con la depuración.

   Cuando se crean las notificaciones, Monitoring reemplaza las variables de documentación por sus valores. Los valores reemplazan las variables solo en las notificaciones. El panel de vista previa y otros lugares de la consola de Google Cloud solo muestran el formato de Markdown.

   Vista previa

   ## CPU utilization exceeded
   
   ### Summary
   
   The ${metric.display_name} of the ${resource.type}
   ${resource.label.instance_id} in the project ${resource.project} has
   exceeded 90% for over 15 minutes.
   
   ### Additional resource information
   
   Condition resource name: ${condition.name}  
   Alerting policy resource name: ${policy.name}  
   
   ### Troubleshooting and Debug References
   
   Repository with debug scripts: example.com  
   Internal troubleshooting guide: example.com  
   ${resource.type} dashboard: example.com
   

   Formato en la notificación

   

   Para obtener más información, consulta Cómo anotar notificaciones con documentación definida por el usuario y Cómo usar los controles de canales.

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.

Cómo filtrar la serie temporal seleccionada

Los filtros garantizan que solo se supervisen las series temporales que cumplen con un conjunto de criterios. Cuando aplicas filtros, puedes reducir la cantidad de líneas en el gráfico, lo que puede mejorar el rendimiento del gráfico. También puedes reducir la cantidad de datos que se supervisan aplicando la agregación. Los filtros garantizan que solo se usen series temporales que cumplan con un conjunto de criterios. Cuando aplicas filtros, hay menos series temporales para evaluar, lo que puede mejorar el rendimiento de la alerta.

Un filtro se compone de una etiqueta, un comparador y un valor. Por ejemplo, para hacer coincidir todas las series temporales cuya etiqueta zone comience con "us-central1", puedes usar el filtro zone=~"us-central1.*", que usa una expresión regular para realizar la comparación.

Cuando filtras por el ID del proyecto o el contenedor de recursos, debes usar el operador igual, (=). Cuando filtras por otras etiquetas, puedes usar cualquier comparador admitido. Por lo general, puedes filtrar las etiquetas de métricas y recursos, y por grupo de recursos.

Cuando proporcionas varios criterios de filtrado, solo se supervisan las series temporales que cumplen todos los criterios.

Para agregar un filtro, haz clic en Agregar filtro, completa el cuadro de diálogo y, luego, haz clic en Listo. En el diálogo, usa el campo Filtro para seleccionar el criterio de filtrado, el operador de comparación y, luego, selecciona o ingresa el valor. En el menú desplegable, solo se enumeran los valores que aparecen en la última semana, pero puedes ingresar cualquier valor. Cada fila de la siguiente tabla enumera un operador de comparación, su significado y un ejemplo:

Operador	Significado	Ejemplo
=	Igualdad	resource.labels.zone = "us-central1-a"
!=	Desigualdad	resource.labels.zone != "us-central1-a"
=~	Igualdad de expresión regular 2	monitoring.regex.full_match("^us.*")
!=~	Desigualdad de expresión regular 2	monitoring.regex.full_match("^us.*")
starts_with	El valor comienza con	resource.labels.zone = starts_with("us")
ends_with	El valor termina con	resource.labels.zone = ends_with("b")
has_substring	El valor contiene	resource.labels.zone = has_substring("east")
one_of	Uno de	resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with	El valor no comienza con	resource.labels.zone != starts_with("us")
!ends_with	El valor no termina con	resource.labels.zone != ends_with("b")
!has_substring	El valor no contiene	resource.labels.zone != has_substring("east")
!one_of	El valor no es uno de	resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

Solucionar problemas

En esta sección, se proporcionan sugerencias para solucionar problemas.

La métrica no aparece en el menú de métricas disponibles

Para supervisar una métrica que no aparece en el menú Seleccionar una métrica, haz una de las siguientes acciones:

• Para crear una política de alertas que supervise una métrica de Google Cloud , expande el menú Seleccionar una métrica y, luego, haz clic en done Activa. Cuando se inhabilita, el menú enumera todas las métricas de los servicios deGoogle Cloud y todas las métricas con datos.

• Para configurar una condición para un tipo de métrica personalizada antes de que este genere datos, debes especificar el tipo de métrica con un filtro de supervisión:

  1. Selecciona ? en el encabezado de la sección Seleccionar métrica y, luego, selecciona Modo de filtro directo en la información sobre herramientas.

  2. Ingresa un filtro de supervisión o un selector de series temporales. Para obtener información sobre la sintaxis, consulta los siguientes documentos:

     • Filtros de supervisión
     • Recuperar datos de SLO
     • Filtros de estado del proceso

Supervisa una tasa de cambio

Para supervisar la tasa de cambio de un valor de métrica, configura el campo Función de ventana móvil como cambio porcentual. Cuando se evalúa la condición, Monitoring calcula la tasa de cambio de la métrica como un porcentaje y, luego, compara ese porcentaje con el umbral de la condición. Este proceso de comparación consta de dos pasos:

1. Si la serie temporal tiene un tipo de métrica DELTA o CUMULATIVE, se convierte en una que tiene un tipo de métrica GAUGE. Para obtener información sobre la conversión, consulta Categorías, tipos y conversiones.
2. Monitoring calcula el porcentaje de cambio comparando el valor promedio en la ventana deslizante de 10 minutos más reciente con el valor promedio de la ventana deslizante de 10 minutos antes del comienzo del período de alineación.

No puedes cambiar el período móvil de 10 minutos que se usa para las comparaciones en una política de alertas de tasa de cambio. Sin embargo, sí debes especificar el período de alineación cuando creas la condición.

Restricciones

• Puedes configurar la condición con la interfaz controlada por menús de la consola deGoogle Cloud o con los filtros de Monitoring. No puedes configurar la condición con el lenguaje de consultas de Monitoring ni con PromQL.
• Se admiten todas las métricas que tienen un tipo de valor de doble o int64, excepto las de las instancias de VM de Amazon.

¿Qué sigue?

• Para crear una política que compare el valor de una serie temporal con un umbral dinámico, debes usar MQL. Para obtener más información, consulta Crea niveles de gravedad dinámicos con MQL.