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 Supervisa 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, con el valor de una métrica del sistema o con el consumo de recursos. Por ejemplo, es posible que desees 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 con 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 un incidente y los precios y las limitaciones, consulta Introducción a las alertas.

Cree una política de alertas

Cloud Monitoring actualiza 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 decides probar la interfaz de vista previa y, luego, deseas 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 Canales de notificaciones en una pestaña nueva del navegador. En esta página, puedes actualizar los canales de notificaciones configurados. Cuando termines 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 abra y cierre un incidente, selecciona Notificar cuando se cierre un incidente. Según la configuración predeterminada, las notificaciones se envían solo cuando se abre un incidente.

      Pantalla que muestra la notificación cuando se cierra un incidente

    5. Si se muestra el campo Duración del cierre automático de incidentes, configura el valor de este campo para que sea el tiempo que Monitoring debe esperar antes de cerrar incidentes cuando las observaciones dejen de llegar (opcional) , 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 desactivas la VM mientras un incidente está abierto, de forma 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. Especifica la documentación que se incluirá en las notificaciones(opcional). Para formatear tu documentación, puedes usar Markdown. A fin de extraer información de la política para personalizar el contenido de tu documentación, puedes usar variables. Para obtener más información sobre cómo puedes dar formato al contenido de este campo y adaptarlo, consulta Usa Markdown y variables en las 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 solo 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.

Obtener vista previa de la interfaz

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 en la página Crear política de alertas, configura la condición de la política de alertas.

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

    1. Para cada condición adicional, haz clic en Agregar condición y, luego, configura esa condición.
    2. Una vez que hayas agregado todas las condiciones, selecciona cómo se combinan en el paso Activador de condiciones múltiples. Para obtener información, consulta Políticas con varias condiciones.
  5. Si quieres recibir una notificación cuando se cumpla la condición de una política de alertas, asegúrate de habilitar Usar canal de notificaciones en el paso Notificaciones y nombre. 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 la sección para crear un canal a pedido.

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

    2. Para recibir una notificación cuando se resuelva un incidente, selecciona Notificar cuando se cierre un incidente.

      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.

    Puedes cambiar los canales de notificaciones para una política de alertas si editas esa política.

  6. Si se muestra el campo Duración del cierre automático de incidentes, configura el valor de este campo para que sea el tiempo que Monitoring debe esperar antes de cerrar incidentes cuando las observaciones dejen de llegar (opcional) , 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, de forma 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 (Documentation) del paso Notificaciones y nombre (opcional).

    Para dar formato a tu documentación, puedes usar Markdown. A fin de extraer información de la política para personalizar 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 las notificaciones, Monitoring reemplaza las variables por sus valores. Los valores reemplazan las variables solo en las notificaciones. En el panel de vista previa y en otras partes 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 las 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 controles de canal.

    Para 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). nombre.

  9. Haga clic en Crear.

Configura 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 desees 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 quieres supervisar una proporción de métricas.

      Si usas el modo MQL, tu consulta no se podrá convertir en modo básico ni en 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 conteo de procesos que se ejecutan en máquinas virtuales (VM).
      • Una métrica personalizada para la que aún no tiene datos.

      Si usas el modo de filtro directo, tu consulta no se puede convertir en 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 Transformar datos (opcional).

  3. Configura el activador de condición.

Modo básico

Para seleccionar la serie temporal que se supervisará 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 (Apply).

    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 se enumera en el menú.

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

  2. Para supervisar solo algunas de las series temporales que se muestran en el gráfico, agrega un filtro (opcional). En el cuadro de diálogo de filtro, usa el campo Filtro para seleccionar la etiqueta que deseas filtrar. Por ejemplo, puedes filtrar por grupo de recursos, nombre, etiqueta de recurso, zona y 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 seleccionar, se abre el Editor de consultas, que muestra una consulta que incluye tus selecciones. Si modificas la consulta existente y, luego, regresas al modo básico, las 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 de la condición.

    Tu 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, regresas al modo básico, las modificaciones se descartan.

Modo de filtro directo

Para seleccionar la serie temporal que se supervisará mediante el modo de filtro directo, haz lo siguiente:

  1. Haga clic en ? en el encabezado de la sección Seleccionar métrica y, luego, selecciona 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 información sobre la sintaxis, consulta los siguientes recursos:

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

Si realizas selecciones con el modo básico y, luego, ingresas al modo de filtro directo, podrás ver el filtro de supervisión. Puedes regresar 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 los cambios no se conserven.

Si usas el modo de filtro directo para seleccionar la serie temporal que se supervisará y, luego, cambiar al modo de 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. Para cambiar la forma en que se alinean los puntos de una serie temporal en intervalos fijos, puedes configurar la ventana móvil y la función de ventana progresiva (opcional). 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 analítica es max, el punto alineado es el valor máximo de todas las muestras registradas en los últimos 15 minutos.

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

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

    Para crear una sola serie temporal, sigue estos pasos:

    1. Establece el campo Agregación de serie temporal en un valor distinto a none. Por ejemplo, si seleccionas mean, cada punto de la serie temporal que se muestra es el promedio de puntos de la serie temporal individual.

    2. Asegúrate de que el campo Time series group by esté vacío.

    Para agrupar series temporales, haz lo siguiente:

    1. Establece el campo Agregación de serie temporal en un valor distinto a none.

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

    2. En el campo Serie temporal de agrupación por, selecciona una o más etiquetas según las que deseas agrupar.

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

    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 Configurar activador de alertas 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 dejen de llegar los datos de métricas, selecciona Ausencia de métricas.

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

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

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

    • Condición de ausencia de la métrica

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

    • Condición del umbral

      Ingresa cómo el valor de la métrica cumple con los criterios de la condición. Para ello, usa la Posición del umbral, el Valor del límite y el Tiempo por encima del umbral. Por ejemplo, si estableces estos valores en Sobre el umbral, 0.3 y 5 minutes, entonces una serie temporal cumple la condición si cada muestra de un 5- minuto es mayor que 0.3.

      Ingresa el tiempo que las mediciones deben cumplir con los criterios de condición antes de que las alertas generen un incidente mediante la ventana Retest (Volver a probar). 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 tu 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 no se muestra ver código, significa que estás usando la interfaz heredada, o bien la opción está oculta en Más opciones.

Agrega 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 umbral 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 Edición no se muestra, luego haga clic en Visualización y seleccionaCambiar al modo de edición ,

  4. Selecciona Alert chart en la biblioteca de widgets o haz clic en 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 las 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. La línea roja discontinua muestra el umbral de condición, que se establece 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 en el chip que muestra la cantidad de incidentes abiertos, se abrirá un cuadro de diálogo que vinculará a la política de alertas subyacente.

Para obtener más información, consulta Usa 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 en 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 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 indica si configuraste una política para notificarte cuando se cerraron los incidentes. Siempre se te notifica cuando se abre un incidente. Para cambiar el comportamiento de las 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 habilitada, haz clic en Habilitada y selecciona Desactivar. Del mismo modo, para habilitar una política inhabilitada, haz clic en Inhabilitada.