Administra las políticas de alertas basadas en métricas

En este documento, se ilustra cómo usar Google Cloud Console para crear y administrar una política de alertas basada en métricas. 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 en particular en tus registros, consulta Supervisar tus registros.

Una política de alertas describe el conjunto de condiciones que deseas supervisar. Estas condiciones pueden relacionarse con el estado de una aplicación, el valor de una métrica del sistema o con el consumo de recursos. Por ejemplo, puede ser conveniente tener una política que supervise una verificación de tiempo de actividad o una que supervise el uso de la API de Cloud Monitoring. Una política de alertas también te permite especificar cómo deseas que se te notifique cuando se cumplan las condiciones de la política y qué documentación incluir en esa notificación.

También puedes usar la API de Cloud Monitoring para crear y administrar políticas de alertas. Para obtener más información sobre este enfoque, consulta Administra las políticas de alertas según la API. Para ver las políticas representadas en JSON, consulta Políticas de muestra.

Antes de comenzar

Antes de crear políticas de alertas, debes familiarizarte con sus conceptos generales y su terminología. Para obtener información sobre los componentes de una política, el concepto de incidente y los precios y limitaciones, consulta Introducción a las alertas.

Cree una política de alertas

Cloud Monitoring está actualizando la interfaz que usas para crear una política de alertas. En este documento, se proporciona información sobre la interfaz heredada y la interfaz de vista previa. Si eliges probar la interfaz de vista previa y, luego, usar la interfaz heredada, haz clic en Volver a la IU heredada.

Interfaz heredada

Para crear una política de alertas, sigue estos pasos:

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

  2. Selecciona Alertas.

  3. Haz clic en Crear política para ver la página Crear política de alertas:

    Se muestra un cuadro de diálogo para crear la política de alertas.

    1. Haz clic en Agregar condición y completa el cuadro de diálogo. Para obtener información sobre los campos de una condición, consulta Especificación de condiciones.

      Una condición describe un recurso supervisado, una métrica para ese recurso y cuándo se cumple la condición. Una política de alertas debe tener al menos 1 condición, pero las políticas de alertas pueden contener hasta 6 condiciones. Si una política de alertas tiene exactamente 1 condición y, si se cumple la condición, se crea un incidente. Si una política de alertas tiene varias condiciones, debes especificar cómo se combinan estas condiciones. Para obtener más información, consulta Políticas con varias condiciones.

    2. Haz clic en Siguiente para pasar a la sección de notificaciones.

    3. Para recibir una notificación cuando se crea un incidente, agrega un canal de notificación a tu política de alertas. Puedes agregar varios canales de notificación. Para obtener información sobre las opciones de canales de notificación, consulta Opciones de notificación.

      Para agregar un canal de notificaciones, haz clic en Canales de notificaciones. En el cuadro de diálogo, selecciona uno o más canales de notificaciones en el menú y haz clic en Aceptar.

      Cuadro de diálogo de notificaciones en el que se muestran los botones para actualizar y administrar canales.

      Si el canal de notificaciones que deseas agregar no aparece en la lista, haz clic en Administrar canales de notificaciones. Se te dirigirá a la página de Canales de notificaciones en una pestaña nueva del navegador. En esta página, puedes actualizar los canales de notificaciones configurados. Cuando hayas completado las actualizaciones, regresa a la pestaña original, haz clic en Actualizar  y selecciona los canales de notificaciones que deseas agregar a la política de alertas. Para obtener más información, consulta Crear un canal a pedido.

    4. Si deseas recibir una notificación cuando se abre y se cierra un incidente, selecciona Notificar cuando se cierra un incidente (opcional). De forma predeterminada, las notificaciones se envían solo cuando se abre un incidente.

      Se muestra la notificación en el botón para cerrar un incidente.

    5. (Opcional) Si se muestra el campo Duración del cierre automático de incidentes, configura el valor de este campo como el tiempo que Monitoring debe esperar antes de cerrar los incidentes cuando las observaciones dejen de llegar. , El valor predeterminado de este campo es de siete días.

      Por ejemplo, supongamos que tienes una alerta con una condición de límite de métrica que supervisa una máquina virtual (VM). Si apagas la VM mientras un incidente está abierto, según la configuración predeterminada, Monitoring espera siete días antes de cerrar el incidente.

    6. Haz clic en Siguiente para pasar a la sección de notificaciones.

    7. Haz clic en Nombre y, luego, ingresa el nombre de política. Este nombre se incluye en las notificaciones y se muestra en la página Políticas.

    8. (Opcional) Especifica la documentación que se incluirá en las notificaciones. Para darle formato a la documentación, puedes usar Markdown. A fin de extraer información de la política para adaptar el contenido de tu documentación, puedes usar variables. Para obtener más información sobre cómo puedes dar formato y adaptar el contenido de este campo, consulta Usa Markdown y variables en plantillas de documentación.

      Por ejemplo, la documentación puede incluir un título como Addressing High CPU Usage y detalles que identifiquen el proyecto:

      ## Addressing High CPU Usage
      
      This note contains information about high CPU Usage.
      
      You can include variables in the documentation. For example:
      
      This alert originated from the project ${project}, using
      the variable $${project}.
      

      El valor reemplaza la variable únicamente en las notificaciones. El panel Vista previa de Markdown y los demás lugares de Cloud Console que muestran la documentación reflejan solo el formato de Markdown:

      Ejemplo de escritura de una nota de documentación con Markdown.

      También puedes incluir etiquetas de canal específicas para controlar las notificaciones. Para obtener más información, consulta Usa controles de canal.

  4. Haz clic en Guardar.

Interfaz de vista previa

Para crear una política de alertas, sigue estos pasos:

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

  2. En el panel de navegación de Cloud Monitoring, selecciona Alertas y, luego, haz clic en Crear política.

  3. En el paso Condición nueva de la página Crea una política de alertas, configura la condición de la política de alertas.

  4. (Opcional) Para crear una política de alertas de condiciones múltiples, haz lo siguiente:

    1. Para cada condición adicional, haz clic en Agregar condición y, luego, configura esa condición.
    2. Después de agregar todas las condiciones, selecciona cómo se combinan en el paso Activador de varias condiciones. Para obtener información, consulta Políticas con varias condiciones.
  5. Para recibir una notificación cuando se cumpla la condición de una política de alertas, asegúrate de que la opción Usar canal de notificaciones esté habilitada en el paso Notificaciones y nombre (opcional). Luego, haz lo siguiente:

    1. Haga clic en el texto Canales de notificaciones para activar un menú. Selecciona uno o más canales de notificaciones en este menú.

      Si el canal de notificaciones que deseas agregar no aparece en la lista, consulta Crea un canal a pedido.

      Para obtener información sobre las opciones de canales de notificación, consulta Opciones de notificación.

    2. Si quieres recibir una notificación cuando se resuelva un incidente, selecciona Notificar sobre el cierre de incidentes.

      De forma predeterminada, si creas una política de alertas con Google Cloud Console, se envía una notificación solo cuando se crea un incidente.

    Si deseas cambiar los canales de notificaciones para una política de alertas, edita esa política.

  6. (Opcional) Si se muestra el campo Duración del cierre automático de incidentes, configura el valor de este campo como el tiempo que Monitoring debe esperar antes de cerrar los incidentes cuando las observaciones dejen de llegar. , El valor predeterminado de este campo es de siete días.

    Por ejemplo, si tienes una alerta con una condición de límite de métrica que supervisa una máquina virtual (VM). Si desactivas la VM mientras un incidente está abierto, según la configuración predeterminada, Monitoring espera siete días antes de cerrar el incidente.

  7. Para incluir documentación personalizada con una notificación, agrega ese contenido a la sección Documentación del paso Notificaciones y nombre (opcional).

    Para dar formato a la documentación, puedes usar Markdown. A fin de extraer información de la política para adaptar el contenido de tu documentación, puedes usar variables. Por ejemplo, la documentación puede incluir un título como Addressing High CPU Usage y detalles que identifiquen el proyecto:

    ## Addressing High CPU Usage
    
    This note contains information about high CPU Usage.
    
    You can include variables in the documentation. For example:
    
    This alert originated from the project ${project}, using
    the variable $${project}.
    

    Cuando se crean notificaciones, Monitoring reemplaza las variables con sus valores. Los valores reemplazan las variables únicamente en las notificaciones. En el panel de vista previa y en otros lugares de Cloud Console, solo se muestra el formato de Markdown:

    Ejemplo de escritura de una nota de documentación con Markdown.

    Para obtener información sobre Markdown y variables, consulta Usa Markdown y variables en plantillas de documentación.

    Si quieres obtener información sobre cómo incluir el etiquetado específico del canal para controlar las notificaciones, consulta Usa los controles de canal.

    Si quieres cambiar la documentación de una política de alertas, edita esa política.

  8. Para cambiar el nombre de la política de alertas de Nueva alerta a algo más significativo, ve al paso Notificaciones y nombre y actualiza la política. (Opcional)

  9. Haga clic en Crear.

Cómo configurar una condición

En esta sección, se describe cómo configurar una condición mediante la interfaz de vista previa. Si usas la interfaz heredada, consulta Especifica las condiciones.

Para configurar una condición, haz lo siguiente:

  1. Selecciona cómo deseas especificar las series temporales que se supervisarán:

    • Modo básico

      Usa el modo básico cuando quieras configurar una condición que supervise una métrica para un recurso específico y no desees usar MQL.

      Si seleccionas el modo básico, puedes convertir tus selecciones en MQL o usar el modo de filtro directo.

    • Modo MQL

      Usa el modo MQL cuando desees usar MQL para describir la condición o si deseas supervisar una proporción de métricas.

      Si usas el modo MQL, tu consulta no se puede convertir en el modo básico ni en el modo de filtro directo.

    • Modo de filtro directo

      Usa el modo de filtro directo cuando te interese supervisar alguno de los siguientes elementos:

      • Un objetivo de nivel de servicio (SLO).
      • El recuento de procesos que se ejecutan en máquinas virtuales (VM).
      • Una métrica personalizada para la que todavía no tienes datos.

      Si usas el modo de filtro directo, tu consulta no se puede convertir en el modo básico ni en una consulta de MQL.

  2. Si usas el modo básico o el modo de filtro directo, especifica cómo se procesan y combinan las series temporales seleccionadas mediante los campos Transform datos (opcional).

  3. Configura el activador de condición.

Modo básico

Para seleccionar las series temporales que se supervisarán mediante el modo básico, haz lo siguiente:

  1. Haz clic en Seleccionar una métrica en la página Crear política de alertas, desplázate hasta el recurso y navega por los menús. Después de seleccionar una métrica, haz clic en Aplicar.

    Para limitar el menú a las métricas que contienen una string específica, ingresa esa string en la barra de filtros. Por ejemplo, si ingresas CPU, solo se mostrarán las métricas cuyo nombre contenga CPU. Se realiza una prueba que no distingue entre mayúsculas y minúsculas para determinar si una métrica aparece en el menú.

    Para cambiar la métrica o recurso seleccionado, expande el menú Seleccionar una métrica y, luego, haz clic en Restablecer o navega por los menús para hacer una selección diferente.

  2. (Opcional) Para supervisar solo algunas de las series temporales que se muestran en el gráfico, agrega un filtro. En el cuadro de diálogo de filtro, debes usar el campo Filtro para seleccionar la etiqueta que deseas filtrar. Por ejemplo, puedes filtrar por grupo de recursos, por nombre, por etiqueta de recurso, por zona y por etiqueta de métrica.

    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 Filtra los datos seleccionados.

Si haces clic en MQL en la barra de herramientas después de realizar las selecciones, se abrirá el Editor de consultas, que mostrará una consulta que incluye tus selecciones. Si modificas la consulta existente y, luego, vuelves al modo básico, tus modificaciones se descartan.

Modo MQL

Para configurar una condición mediante MQL, haz lo siguiente:

  1. Haz clic en MQL en la barra de herramientas de la página Crear alerta personalizada y, luego, ingresa la consulta para la condición.

    La consulta debe terminar con una de las siguientes operaciones:

    • operación de condition para las alertas de umbral.
    • operación de absent_for para las alertas de ausencia.

    Para obtener más información, consulta Políticas de alertas con MQL.

  2. Haz clic en Siguiente y Configura el activador de condición.

Para volver al modo básico, haz clic en Consulta básica en la barra de herramientas de la página Crear alerta personalizada.

Si creas una consulta o modificas la consulta existente y, luego, vuelves al modo básico, tus modificaciones se descartan.

Modo de filtro directo

Para seleccionar las series temporales que se supervisarán mediante el modo de filtro directo, haz lo siguiente:

  1. Haz clic en ? en el encabezado de la sección Seleccionar métrica y, luego, elige Modo de filtro directo en la información sobre la herramienta.

  2. Ingresa un filtro de Monitoring.

    Por ejemplo, para contar la cantidad de procesos que se ejecutan en instancias de VM de Compute Engine cuyo nombre incluye nginx, ingresa lo siguiente:

    select_process_count("monitoring.regex.full_match(\".*nginx.*\")")
    resource.type="gce_instance"
    

    Para obtener más información, consulta los siguientes recursos:

Para volver al modo básico, haz clic en ? en el encabezado de la sección Seleccionar métrica y, luego, Modo básico.

Si seleccionas el modo básico y, luego, ingresas al modo de filtro directo, podrás ver el filtro de supervisión. Puedes volver al modo básico cuando no modifiques el filtro de supervisión. Si regresas al modo básico después de crear o modificar un filtro de supervisión, es posible que tus cambios no se conserven.

Si usas el modo de filtro directo para seleccionar la serie temporal que se supervisará y, luego, cambias al modo MQL, no se conservarán los cambios.

Transforma los datos

Esta sección se aplica solo al modo básico y al modo de filtro directo. No se aplica al modo MQL.

Para configurar cómo se alinean cada serie temporal y cómo se combinan, haz lo siguiente:

  1. (Opcional) Para cambiar la forma en que los puntos de una serie temporal están alineados a intervalos de tiempo fijos, configura la ventana móvil y la función de ventana móvil en la sección Transforma datos.

    Estos campos especifican cómo se combinan los puntos que se registran en una ventana. Por ejemplo, si la ventana es de 15 minutos y la función de ventana es max, el punto alineado es el valor máximo de todas las muestras registradas en los 15 minutos más recientes.

    Para obtener más información, consulta Alinea series temporales.

  2. Opcional: Para combinar series temporales, en la sección En series temporales, haz clic en Mostrar más y, luego, completa el diálogo. De forma predeterminada, las series temporales no se combinan.

    Para crear una sola serie temporal, haz lo siguiente:

    1. Configura el campo Agregación de serie temporal con un valor distinto de none. Por ejemplo, si seleccionas mean, cada punto de la serie temporal que se muestra es el promedio de puntos de las series temporales individuales.

    2. Asegúrate de que el campo Series temporales agrupadas por esté vacío.

    Para agrupar series temporales, haz lo siguiente:

    1. Configura el campo Agregación de serie temporal con un valor distinto de none.

      Por ejemplo, si agrupas la serie temporal por zone y, luego, estableces el campo de agregación en mean, hay una serie temporal para cada zona.

    2. En el campo Series temporales agrupadas por, selecciona una o más etiquetas según las que quieras agrupar.

    Si tienes varias series temporales que se muestran después de completar los pasos anteriores, para combinar estas series temporales en una sola, usa los campos Transformación de datos secundarios.

    Para obtener más información, consulta Combina series temporales.

Activador de condición

Para configurar cuándo se cumple una condición, ve a la página Configura el activador de alerta y, luego, haz lo siguiente:

  1. Si se muestra el campo Tipo de condición, selecciona el tipo de condición.

    • Para recibir una notificación cuando los datos de las métricas dejen de llegar, selecciona Ausencia de métricas.

    • Para recibir notificaciones en función del valor de una métrica, selecciona el Límite.

  2. Para especificar cómo contribuyen las series temporales individuales cuando se cumple una condición, selecciona un valor del menú Activador de alertas. Este menú te permite especificar el subconjunto de series temporales que deben cumplir con el activador para que se cumpla la condición.

  3. Completa el campo específico de la condición:

    • Condición de ausencia de métricas

      Ingresa cuánto tiempo espera la política de alertas para notificarte que no se reciben los datos de métrica mediante el campo Activador cuando faltan datos durante este período.

    • Condición Threshold

      Ingresa cómo el valor de la métrica cumple con los criterios de condición mediante los campos Posición del umbral, Valor del umbral y Tiempo por encima del umbral. Por ejemplo, si estableces estos valores en Sobre el límite, 0.3 y 5 minutes, una serie temporal cumplirá la condición si cada muestra de una el intervalo de 5 minutos es mayor que 0.3.

      Ingresa por cuánto tiempo deben cumplir las condiciones para que las alertas generen un incidente mediante la ventana Retest. Si seleccionas el valor más reciente, una sola medición puede generar una notificación. Para obtener información conceptual y un ejemplo, consulta El período de alineación y la duración.

JSON para una política de alertas

Para ver o descargar la representación JSON de una política de alertas, haz lo siguiente:

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

  2. Selecciona Alertas, busca la política que deseas ver y, luego, abre la página Detalles de la política.

  3. Realice una de las acciones siguientes:

    • Para descargar el JSON en el sistema local, haz clic en JSON.

    • Para ver el JSON, asegúrate de usar la interfaz de vista previa, haz clic en Editar y, luego, en Ver código.

      Si Ver código no se muestra, significa que estás usando la interfaz heredada o la opción está oculta en Más opciones ,

Agregar una política de alertas a un panel

Cuando una política de alertas contiene una condición, puedes mostrar un resumen de esa política en un panel personalizado. El resumen incluye la serie temporal que supervisa la política de alertas, el límite y la cantidad de incidentes abiertos.

Para mostrar un resumen de una política de alertas en un panel personalizado, haz lo siguiente:

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

  2. Selecciona Paneles y abre el panel personalizado que deseas modificar.

  3. Si la Edición no se muestra, haga clic en Visualización y selecciona Cambiar al modo de edición.

  4. Selecciona Alert chart (Gráfico de alertas) en la biblioteca de widgets, o haz clic en Add chart (Agregar gráfico) y, luego, selecciona Alert chart en el menú.

  5. En el panel de configuración del Gráfico de alertas, usa el menú Política de alertas para seleccionar una política de alertas. Solo se pueden seleccionar políticas de alertas de condición única en el menú Política de alertas.

En la siguiente captura de pantalla, se muestra un gráfico de alertas:

Ejemplo de un gráfico de alertas

En este ejemplo, la política de alertas supervisa el uso de CPU de dos máquinas virtuales diferentes. En la línea roja punteada, se muestra el límite de la condición que se estableció en 50%. El chip verde con la etiqueta No incidents indica que no hay incidentes abiertos para la política de alertas. Si colocas el puntero sobre el chip que muestra la cantidad de incidentes abiertos, se abrirá un cuadro de diálogo que se vincula a la política de alertas subyacente.

Para obtener más información, consulta Usa los paneles y gráficos.

Administración de políticas

Para enumerar todas las políticas de alertas, haz lo siguiente:

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

  2. Selecciona Alertas.

  3. En el panel Políticas (Policies), se muestra una lista parcial de las políticas. Para ver todas las políticas y habilitar el filtrado, haz clic en Ver todas las políticas.

Para ver los detalles de una política de alertas, haz clic en su nombre.

A fin de restringir las políticas de alertas que se enumeran, agrega filtros. Cada filtro se compone de un nombre y un valor. Puedes establecer que el valor sea una coincidencia exacta para un nombre de política o una coincidencia parcial. Los filtros no realizan comparaciones que distinguen entre mayúsculas y minúsculas. Si tienes varios filtros, un AND lógico une los filtros, a menos que insertes un filtro OR. En la siguiente captura de pantalla, se enumeran todas las políticas de alertas que coinciden con test o My Uptime Check Alert Policy:

Descripción general de las alertas de muestra con filtros.

Desde la página Políticas, puedes editar, borrar, copiar, habilitar o inhabilitar una política de alertas:

  • Para editar o copiar una política, haz clic en Más opciones y selecciona la opción correspondiente. Editar y copiar una política es similar a crear una política de alertas. Puedes cambiar y, a veces, borrar los valores de los campos. Cuando termines, haz clic en Guardar.

  • Para borrar una política, haz clic en Más opciones y selecciona Borrar. En el diálogo de confirmación, selecciona Borrar.

  • Para cambiar el estado habilitado de la política de alertas, haz clic en el botón de activación ubicado bajo el encabezado Habilitado (Enabled).

Si seleccionas una política de alertas, se mostrarán los Detalles de la política (Policy details). Por ejemplo, la siguiente captura de pantalla muestra los detalles de la política de alertas llamada Test staging:

Página de detalles de la política de alertas de muestra.

En la sección Notificaciones, se enumera si configuraste una política para que te notifique cuando se cierren los incidentes. Siempre se te notifica cuando se abre un incidente. Para cambiar el comportamiento de notificaciones, edita la política de alertas.

Puedes editar, borrar, copiar, habilitar o inhabilitar una política de alertas desde la página Detalles de la política. Por ejemplo, para inhabilitar una política de alertas que está habilitada, haz clic en Habilitado y selecciona Desactivar. Del mismo modo, para habilitar una política que en la actualidad está inhabilitada, haz clic en Inhabilitado.