Administra las políticas de alertas

En este documento, se describe cómo editar, enumerar y ver tus políticas de alertas con la consola de Google Cloud. También se describe cómo ver la representación JSON de una política y cómo agregar políticas de alertas a un panel personalizado. Cuando agregas políticas a un panel personalizado, puedes verlas en el mismo contexto que tus datos de métricas.

En este documento, no se describe cómo editar, enumerar y ver tus políticas de alertas con la API de Cloud Monitoring. Para obtener más información, consulta Administra las políticas de alertas según la API.

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 mediante 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 más información, consulta Descripción general de las alertas.

Edita, enumera o borra políticas de alertas

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

   Ir a las Alertas

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

   La página Alertas muestra paneles que enumeran información de resumen, incidentes y políticas de alertas.

2. Haz clic en Ver todas las políticas en el panel Políticas.

   En la página Políticas, se enumeran todas las políticas, se incluye una barra de filtros y, para cada política, se muestran opciones para editarla, copiarla o borrarla:

   • Para filtrar la lista de políticas de alertas, realiza una de las siguientes acciones:

     • Ingresa un nombre en la barra de filtros. Por ejemplo, para mostrar solo las políticas cuyo nombre contiene Example, ingresa Example. Una comparación que distingue mayúsculas de minúsculas prueba si una política aparece en la lista.
     • Haz clic en Políticas de filtro, selecciona la propiedad del filtro y, luego, ingresa un valor para el filtro o selecciona uno del menú.

     Cuando agregas varios filtros, un AND lógico los une.

3. Opcional: Para ver los detalles de una política, haz clic en su nombre. Para obtener información sobre la página Detalles de la política, consulta Cómo ver una política de alertas.

4. Opcional: 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 basada en métricas. Sin embargo, no todos los campos se pueden modificar. Cuando termines, haz clic en Guardar política.

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

   Si un panel contiene un gráfico que muestra datos de una política de alertas, ese gráfico dejará de mostrar datos cuando se borre la política de alertas. Para obtener más información, consulta El widget de la política de alertas no muestra ningún dato.

Cómo ver una política de alertas

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

   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. Para ver todas las políticas, haz clic en Ver todas las políticas en el panel Políticas.

3. Busca la política que deseas ver y selecciónala.

Por ejemplo, en la siguiente captura de pantalla, se muestran los detalles de la política de alertas llamada Test staging:

Como se muestra en la imagen anterior, la página de detalles te proporciona información sobre la política de alertas:

• Para ver los incidentes que creó la política, consulta la sección Incidentes.

• Para ver los canales de notificación configurados, consulta la sección Canales de notificación.

• Para ver la información adicional que especificaste para que se incluya en una notificación, consulta la sección Documentación.

• Para ver las etiquetas definidas por el usuario, consulta la sección Etiquetas. Para ver ejemplos que ilustran cómo puedes usar etiquetas para agregar información a tus incidentes, consulta Cómo anotar incidentes con etiquetas.

• Para editar, copiar, borrar, descargar la representación JSON o cambiar el estado habilitado de la política, usa las opciones de la barra de herramientas. Por ejemplo, para inhabilitar una política de alertas que está habilitada, haz clic en Habilitado y, luego, selecciona Inhabilitar en el cuadro de diálogo de confirmación.

Nota: Es posible que se active de inmediato una política que se haya vuelto a habilitar. Para obtener más información, consulta Notificaciones para políticas de alertas inhabilitadas y obtén una explicación.

Consulta la representación JSON de una política de alertas

Cuando creas o modificas una política de alertas con la API de Cloud Monitoring, le proporcionas una representación JSON de esa política al método de la API. Puedes crear el archivo JSON por tu cuenta con la documentación de la API para guiar el contenido. Una alternativa es crear una política con la consola de Google Cloud y, luego, descargarla en tu sistema local. El archivo JSON que descargaste se puede editar y usar como plantilla para otras políticas. Para ver ejemplos de políticas descritas por JSON, consulta Políticas de ejemplo.

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

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

   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. Busca la política que deseas ver y, luego, haz clic en su nombre para abrir la página Detalles de la política.
3. Haz clic en JSON.

Para ver la representación JSON de una política de alertas cuando la edites, haz clic en  Ver código.

Agrega una política de alertas al panel

Para ver tus políticas de alertas en el mismo contexto que tus datos de métricas, agrégalas a un panel personalizado. Cuando veas ese panel, se mostrará un gráfico para cada política de alertas que hayas agregado. Estos gráficos muestran la métrica supervisada, el umbral y la cantidad de incidentes abiertos de la política. Estos gráficos también contienen vínculos que te permiten ver o editar la política.

Puedes agregar políticas con una condición a los paneles personalizados. Las políticas que contienen varias condiciones solo se pueden ver desde el contexto de alertas.

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

1. En la consola de Google Cloud, ve a la página  Paneles.

   Dirígete a Paneles de control

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

2. Selecciona un panel o haz clic en Crear panel.
3. En la barra de herramientas, haz clic en  Agregar widget.
4. En el cuadro de diálogo Agregar widget, selecciona Alert Policy.
5. Haz clic en Política de alertas y, luego, selecciona una política de alertas. Solo se pueden seleccionar políticas de alertas con una sola condición desde el menú Política de alertas.
6. Para aplicar los cambios en el panel, en la barra de herramientas, haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

En la siguiente captura de pantalla, se muestra un gráfico de una política de alertas:

En este ejemplo, la política de alertas supervisa el uso de CPU de dos máquinas virtuales diferentes. La línea discontinua muestra el umbral de la 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 sobre el chip que muestra la cantidad de incidentes abiertos, se abrirá un cuadro de diálogo que vincula a la política de alertas subyacente.

Para obtener más información, consulta Cómo mostrar políticas de alertas e incidentes en un panel.