Administra las políticas de alertas

Una política de alertas describe el conjunto de condiciones que deseas supervisar. Estas condiciones pueden relacionarse con el mal estado de un sistema o con el consumo de recursos. Por ejemplo, es posible que desees crear una política para supervisar una verificación de tiempo de actividad o para supervisar el uso de la API de Cloud Monitoring. Además de las condiciones, en una política de alertas puedes especificar la forma en la que deseas que se te notifique y la documentación que se debe incluir en la notificación.

En esta página, se ilustra cómo usar Monitoring en Google Cloud Console para crear y administrar una política de alertas. También puedes usar la API de Cloud Monitoring para realizar estas tareas. 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. Esto incluye la comprensión de los componentes de una política, el concepto de incidente, los precios y las limitaciones. Consulta Introducción a las alertas para obtener más información.

Canales de notificación

Los canales de notificación te permiten especificar la forma en la que deseas que se te informe sobre las alertas. Si se configura un tipo de canal de notificación, tienes la opción de seleccionarlo cuando configuras notificaciones para tu política de alertas.

Para obtener una lista de los tipos de canales de notificación y la información de configuración del canal, consulta Opciones de notificación.

Políticas de alertas para verificaciones de tiempo de actividad

Crea la política de alertas para una verificación de tiempo de actividad desde la ventana Verificaciones de tiempo de actividad. Si sigues este lineamiento, verás que la mayoría de los campos de la política de alertas están preconfigurados:

Crea una política de alertas

  1. En Cloud Console, selecciona Monitoring:

    Ir a Monitoring

    Si nunca usaste Monitoring, se creará de manera automática un lugar de trabajo y tu proyecto se asociará con ese lugar de trabajo. De lo contrario, si tu proyecto no está asociado con un lugar de trabajo, aparecerá un cuadro de diálogo y podrás crear un lugar de trabajo nuevo o agregarlo a un lugar de trabajo existente. Después de realizar la selección, haz clic en Agregar. Una vez que se haya creado el lugar de trabajo, pasarás de forma automática a Alertas.

  2. Selecciona Alertas.

  3. Haz clic en Crear política.

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

  4. Cuando termines de especificar el nombre, las condiciones, los canales de notificación y de agregar la documentación, haz clic en Guardar (Save).

Asignación de nombres

En la ventana Crear nueva política de alertas, ingresa un nombre de política. El nombre de la política se incluye en las notificaciones y se muestra en la ventana Políticas.

Condiciones

Cada condición en una política de alertas describe un recurso que se supervisa y cuándo ese recurso no cumple con una medida de rendimiento. Si una política de alertas tiene 1 condición, se crea un incidente cuando la configuración de la condición se evalúa como verdadera. Por ejemplo, si la configuración es Any time series is above 10 for 5 minutes, cuando esta declaración se evalúa como verdadera, se cumple la condición y, por lo tanto, se debe crear un incidente. Consulta Varias condiciones para obtener información sobre cómo combinar varias condiciones.

Para agregar una condición de alerta a una política, en la ventana Crear nueva política de alertas, haz clic en Agregar condición. Para obtener información sobre cómo definir las condiciones, consulta Especifica las condiciones.

Políticas con varias condiciones

Una política de alertas puede contener hasta 6 condiciones.

Si usas la API de Cloud Monitoring o si tu política de alertas tiene varias condiciones, debes especificar cuándo se abren incidentes de las condiciones individuales:

  • Si usas Google Cloud Console, debes usar el campo Activadores de políticas.
  • Si usas la API de Cloud Monitoring, usa el campo combiner.

En esta tabla, se enumeran los parámetros de configuración de Cloud Console, el valor equivalente en la API de Cloud Monitoring y una descripción de cada configuración:

Cloud Console
Valor de activadores de política
API de Cloud Monitoring
Valor del combinador
Significado
Se cumple cualquier condición
(valor predeterminado)
OR Se abre un incidente si algún recurso infringe alguna de las condiciones.
Se cumplen todas las condiciones AND Se abre un incidente si al menos un recurso infringe cada condición, incluso si un recurso diferente infringe cada condición.
Todas las condiciones se cumplen
en los recursos coincidentes
AND_WITH_MATCHING_RESOURCE Se abre un incidente si el mismo recurso infringe cada condición. Esta configuración es la opción de combinación más estricta.

En este contexto, el término cumplir significa que la configuración de la condición se evalúa como true. Por ejemplo, si la configuración es Any time series is above 10 for 5 minutes, cuando esta declaración se evalúa como true, se cumple la condición.

Ejemplo

Supongamos que tienes un proyecto de Google Cloud que contiene dos instancias de VM, vm1 y vm2. Además, supongamos que creas una política de alertas con 2 condiciones:

  • La condición llamada CPU usage is too high supervisa el uso de CPU de las instancias. Esta condición se cumple cuando el uso de CPU de cualquier instancia supera los 100 ms/s durante 1 minuto.
  • La condición denominada Excessive utilization supervisa el uso de CPU de las instancias. Esta condición se cumple cuando el uso de CPU de cualquier instancia supera el 60% durante 1 minuto.

En un principio, supongamos que ambas condiciones se evalúan como false.

A continuación, supongamos que el uso de CPU de vm1 supera los 100 ms/s durante 1 minuto. Esto genera que CPU usage is too high se evalúe como true. Si las condiciones se combinan con Se cumple cualquier condición, se crea un incidente, ya que se cumple una condición. Si las condiciones se combinan con Se cumplen todas las condiciones o Se cumplen todas las condiciones en los recursos coincidentes, no se crea un incidente. Estas opciones de combinador requieren que ambas condiciones se evalúen como true.

Ahora, supongamos que el uso de CPU de vm1 continúa por encima de los 100 ms/s y que el uso de CPU de vm2 supera el 60% durante 1 minuto. El resultado es que ambas condiciones se evalúan como true. A continuación, se describe lo que ocurre según cómo se combinan las condiciones:

  • Se cumple cualquier condición: Se crea un segundo incidente porque vm2 genera que Excessive utilization se evalúe como true.

    Cuando la configuración de una condición se evalúa como true, la política de alertas mantiene un registro del recurso supervisado y la condición. Un incidente se crea en función de la vinculación del recurso y la condición. Por lo tanto, vm1 provoca que CPU usage is too high sea true y vm2 que provoca que CPU usage is too high sea true son eventos distintos. Se crea un incidente para cada evento.

  • Se cumplen todas las condiciones: Se crea un incidente porque ambas condiciones se evalúan como true.

    En este ejemplo, vm1 hace que CPU usage is too high sea true mientras vm2 hace que Excessive utilization se evalúe como true. En consecuencia, se crea un incidente.

  • Todas las condiciones se cumplen en los recursos coincidentes: un incidente no se crea en este caso porque ni vm1 ni vm2 provocaron que ambas condiciones se evalúen como true. Para que se cree un incidente en esta opción de combinador, la misma instancia de VM debe hacer que ambas condiciones se evalúen como true.

Notificaciones

Los canales de notificación te permiten especificar la forma en la que deseas que se te informe sobre las alertas. Si no agregas al menos un canal de notificaciones, no recibirás notificaciones cuando ocurra un incidente. 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 lo siguiente:

  1. Haz clic en Agregar canal de notificación.
  2. Selecciona el Tipo de canal de notificación.
  3. Es posible que debas completar campos adicionales. Por ejemplo, si seleccionas Correo electrónico, se te solicitará tu dirección de correo electrónico.
  4. Haz clic en Agregar.

Repite los pasos anteriores para agregar un canal de notificación adicional a tu política. Configurar al menos dos tipos de canales de notificación aumenta la confiabilidad.

Documentación

La documentación se incluye en las notificaciones para ayudarte a administrar el estado de la falla. Puedes usar Markdown para dar formato a tu documentación o usar texto sin formato.

Además de Markdown, puedes usar variables a fin de extraer información de la política para personalizar el contenido de tu documentación. Para obtener más información, consulta Usa 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}.

Las variables se reemplazan por sus valores 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.

Administra 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. Las coincidencias no distinguen mayúsculas de minúsculas. Si tienes varios filtros, estos se unen de manera automática con un AND lógico, 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 ventana 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, en algunos casos, 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 la ventana 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 My Uptime Check Alert Policy:

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

Puedes editar, borrar, copiar, habilitar o inhabilitar una política de alertas desde la ventana Detalles de la política (Policy details). Por ejemplo, para inhabilitar una política de alertas que está habilitada en la actualidad, 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.