Cómo crear y administrar canales de notificaciones

En este documento, se describe cómo configurar canales de notificaciones con la consola de Google Cloud. Cloud Monitoring usa estos canales para notificarte a ti o a tu equipo de guardia cuando se activa una política de alertas. Cuando creas una política de alertas, puedes elegir quién recibe las notificaciones mediante la selección de la lista de canales de notificaciones configurados. Por ejemplo, puedes configurar políticas de alertas que supervisen las instancias de Compute Engine para publicar un tema de Pub/Sub y notificar al canal de Slack para el equipo de guardia.

Para obtener más información, consulta Latencia de notificación y Notificaciones por incidente.

En este documento, se describe cómo usar la consola de Google Cloud. Si usas la API de Cloud Monitoring, consulta Crea y administra canales de notificaciones con la API.

Antes de comenzar

Si quieres obtener los permisos que necesitas para ver y configurar los canales de notificaciones con la consola de Google Cloud, pídele a tu administrador que te otorgue el rol de IAM Editor de Monitoring (roles/monitoring.editor) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

Para obtener más información sobre las funciones de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.

Crea un canal de notificaciones

Cuando creas una política de alertas, puedes seleccionar cualquier canal de notificación configurado y agregarlo a tu política. Puedes configurar de forma previa tus canales de notificaciones o configurarlos como parte del proceso de creación de una política de alertas. Para obtener más información, consulta Cómo crear un canal a pedido.

Para crear un canal de notificaciones con la consola de Google Cloud, sigue las instrucciones específicas del canal que se incluyen en la siguiente tabla:

Correo electrónico

Para agregar un canal de notificaciones por correo electrónico, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  2. Haz clic en Editar canales de notificaciones.
  3. En la sección Correo electrónico, haz clic en Agregar nuevo.
  4. Ingresa una sola dirección de correo electrónico y una descripción.
  5. Haz clic en Guardar.

Si usas una dirección de correo electrónico del grupo como canal de notificaciones para una política de alertas, configura el grupo a fin de que acepte correos de alerting-noreply@google.com.

Puedes crear canales de correos electrónicos durante la creación de una política de alertas. Para obtener más información, consulta Cómo crear un canal a pedido.

Aplicación para celulares

Usa la app para dispositivos móviles de la consola de Google Cloud para supervisar tus recursos de la consola de Google Cloud y la información de Monitoring desde cualquier lugar. Las notificaciones de la app para dispositivos móviles de la consola de Google Cloud se envían a un dispositivo específico o a un usuario específico:

Lista de canales de notificaciones de la app para dispositivos móviles de la consola de Google Cloud.

  • Dispositivo indica que las notificaciones se envían solo al dispositivo específico que creó el canal de notificaciones. Para los canales de notificaciones con alcance de dispositivo, el campo Nombre visible incluye información del dispositivo.
  • Usuario indica que las notificaciones se envían a todos los dispositivos que tienen instalada la app para dispositivos móviles de la consola de Google Cloud.

Cloud Monitoring determina el permiso de la notificación cuando se crea el canal. No puedes seleccionar o cambiar el permiso.

Si deseas configurar un canal de notificaciones de la app para dispositivos móviles de la consola de Google Cloud para un proyecto específico de Google Cloud, haz lo siguiente:

  1. Instala la app para dispositivos móviles de la consola de Google Cloud desde la tienda de aplicaciones de tu dispositivo móvil.
  2. Selecciona un proyecto para verlo en la app para dispositivos móviles de la consola de Google Cloud.

    Después de seleccionar un proyecto, se produce un intercambio de datos entre la app y el proyecto de Google Cloud seleccionado. Se crea un canal de notificación cuando no existe y, después de unos minutos, este aparece en la sección Dispositivos móviles de la página Canales de notificaciones.

Si quieres agregar tu dispositivo móvil como canal de notificaciones para una política de alertas, en la sección de Notificaciones, selecciona la consola de Google Cloud (dispositivos móviles) y, luego, elige tu dispositivo móvil de la lista.

PagerDuty

La integración con PagerDuty permite la sincronización unidireccional o bidireccional con Monitoring. Independientemente de tu configuración, los siguientes enunciados son verdaderos:

  • Si se crea un incidente en Monitoring, se abre un incidente en PagerDuty.
  • No puedes usar PagerDuty para cerrar un incidente en Monitoring.

Si usas la sincronización unidireccional y resuelves el incidente en PagerDuty, el estado del incidente en PagerDuty se desvincula del estado del incidente en Monitoring. En efecto, si resuelves un incidente en PagerDuty, este se cierra de forma permanente en PagerDuty y no se puede volver a abrir.

Si usas la sincronización bidireccional, Monitoring controla el estado que muestra PagerDuty. Si resuelves el incidente en PagerDuty y si Monitoring lo tiene abierto, este se vuelve a abrir en PagerDuty.

Para configurar las notificaciones de PagerDuty, haz lo siguiente:

  1. En tu cuenta de PagerDuty, configura la integración en un servicio nuevo o agrégala a un servicio existente.
    1. Crea una cuenta o accede a una existente.
    2. Ve a la página Servicios.
      • Para crear un servicio, haz lo siguiente:
        1. Haz clic en + Servicio nuevo.
        2. Ingresa un nombre de servicio y una descripción y, luego, haz clic en Siguiente.
        3. Configura una política de derivación y, luego, haz clic en Siguiente.
        4. Si tu cuenta de PagerDuty admite la agrupación de alertas y las alertas transitorias, configúralas y haz clic en Next.
        5. En la página de configuración de integraciones, en la barra de herramientas Search for an integration(s), ingresa Events API v1 y, luego, haz clic en Create Service. Volverás al panel Integraciones de tu servicio nuevo.
      • Para editar un servicio existente, haz lo siguiente:
        1. Selecciona un servicio del directorio de servicios.
        2. En la página de servicio, selecciona el panel Integraciones.
        3. Haz clic en + Agregar otra integración para ir a la página de configuración de integraciones.
        4. En la página de configuración de integraciones, en la barra de herramientas Buscar integraciones, ingresa Events API v1 y, luego, haz clic en Agregar. Volverás al panel Integraciones del servicio editado.
    3. En el panel Integraciones de tu servicio, busca la ficha de tu nueva integración, expande su menú y, luego, copia la clave de integración.
  2. En Cloud Monitoring, agrega el canal de notificaciones de PagerDuty:
    1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

      Ir a las Alertas

    2. Haz clic en Editar canales de notificaciones.
    3. En la sección PagerDuty, haz clic en Agregar nuevo.
    4. Ingresa el Display Name (Nombre visible). Este nombre debe coincidir con el nombre del servicio de PagerDuty en el que configuraste tu nueva integración en el paso 1.
    5. Ingresa la clave de integración que copiaste en el paso 1 en el campo Clave de servicio.
    6. Haz clic en Guardar.
  3. Opcional: Si quieres configurar la sincronización bidireccional, haz lo siguiente:
    1. Ve a tu cuenta de PagerDuty.
    2. Selecciona Servicios y, luego, el nombre del servicio que ingresaste cuando configuraste la integración.
    3. Selecciona el panel Integraciones de tu servicio.
    4. Ve a la sección Configuración de incidentes y alertas y, luego, haz clic en Editar.
    5. Selecciona Crear incidentes y alertas y, luego, guarda los cambios.

Cuando crees una política de alertas, selecciona PagerDuty en la sección Notificaciones y elige tu configuración de PagerDuty.

El paquete JSON para PagerDuty tiene el siguiente formato:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Para ver un ejemplo y el esquema del campo details, expande las siguientes secciones.

Política de baja

El esquema de carga útil está sujeto a la política de baja de Google Cloud que se describe en la Sección 1.4(d) de las Condiciones del Servicio de Google Cloud Platform. Ten en cuenta que el esquema no controla los formatos de los valores de campo generados, y estos formatos pueden cambiar sin aviso previo. Por ejemplo, incident.summary, incident.documentation.content y incident.url están destinados a incluir datos relacionados con sus campos, pero el esquema no tiene restricciones para garantizar un análisis preciso de campos. Puedes consumir el valor como un todo y esperar que cumpla con la política de baja, pero no dependas del análisis de los campos generados.

SMS

Para configurar las notificaciones por SMS, sigue estos pasos:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  2. Haz clic en Editar canales de notificaciones.
  3. En la sección SMS, haz clic en Agregar nuevo.
  4. Completa el cuadro de diálogo y haz clic en Guardar.

Cuando configures tu política de alertas, selecciona el tipo de notificación SMS y elige un número de teléfono verificado de la lista.

Slack

La integración de Slack con Monitoring permite que tus políticas de alertas realicen publicaciones en un canal de Slack cuando se crea un incidente nuevo. Para configurar las notificaciones de Slack, haz lo siguiente:

  1. En Slack: crea un lugar de trabajo y un canal de Slack en el sitio de Slack. Registra la URL del canal.

  2. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  3. Haz clic en Editar canales de notificaciones.

  4. En la sección Slack, haz clic en Agregar nuevo para abrir la página de acceso de Slack:

    1. Selecciona tu lugar de trabajo de Slack.
    2. Haz clic en Permitir para habilitar el acceso de Google Cloud Monitoring a tu lugar de trabajo de Slack. Esta acción te lleva de vuelta a la página de configuración de Monitoring para tu canal de notificaciones.
    3. En el campo Nombre del canal de Slack, ingresa el nombre del canal de Slack que deseas utilizar para las notificaciones.
    4. En el campo Nombre visible de Cloud Alerting, ingresa una instrucción descriptiva breve. Monitoring muestra el valor de este campo en la página Canal de notificaciones.
    5. Para probar la conexión entre Cloud Monitoring y tu lugar de trabajo de Slack, haz clic en Enviar notificación de prueba (opcional). Si la conexión se realiza de forma correcta, verás un mensaje This is a test alert notification... en el canal de notificaciones de Slack que especificaste. Revisa el canal de notificaciones para confirmar la recepción.
  5. Si el canal de Slack que quieres usar para las notificaciones es privado, debes invitar manualmente la app de Monitoring al canal:

    1. Abre Slack.
    2. Ve al canal que especificaste como tu canal de notificaciones de Monitoring.

    3. Para invitar a la app de Monitoring al canal, ingresa y envía el siguiente mensaje en el canal:

      /invite @Google Cloud Monitoring

      Asegúrate de invitar a la app de Monitoring al canal privado que especificaste cuando creaste el canal de notificaciones en Monitoring. Invitar a la app de Monitoring a los canales públicos es opcional.

    Cuando crees una política de alertas, selecciona Slack en la sección Notificaciones y elige tu configuración de Slack.

Webhooks

Para configurar las notificaciones de Webhooks, haz lo siguiente:

  1. El controlador de webhook: Identifica la URL del extremo público para recibir los datos de webhook desde Monitoring.
  2. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  3. Haz clic en Editar canales de notificaciones.
  4. En la sección Webhook, haz clic en Agregar nuevo.
  5. Completa el cuadro de diálogo.
  6. Haz clic en Probar conexión para enviar una carga útil de prueba al extremo de Webhook. Puedes ir al extremo receptor para verificar la entrega.
  7. Haz clic en Guardar.

Cuando crees una política de alertas, selecciona Webhook en la sección Notificaciones y elige tu configuración de webhook. Las notificaciones enviadas por Error Reporting siguen el esquema 1.0, mientras que las notificaciones enviadas por Monitoring siguen el esquema 1.2:

Autenticación básica

Además de la solicitud de webhook enviada por Cloud Monitoring, la autenticación básica usa la especificación HTTP para el nombre de usuario y la contraseña. Cloud Monitoring requiere que tu servidor muestre una respuesta 401 con el encabezado WWW-Authenticate adecuado. Para obtener más información sobre la autenticación básica, consulta lo siguiente:

Autenticación con token

La autenticación de tokens requiere un parámetro de string de consulta en la URL del extremo y una clave que el servidor espera que sea un secreto entre sí y Monitoring. La siguiente es una URL de muestra en la que se incluye un token:

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Si Monitoring publica un incidente en la URL del extremo, tu servidor puede validar el token adjunto. Este método de autenticación es más eficaz cuando se usa con SSL/TLS para encriptar la solicitud HTTP, lo que evita que los espías conozcan el token.

Para ver un servidor de ejemplo en Python, consulta este servidor de muestra.

Política de baja

El esquema de carga útil está sujeto a la política de baja de Google Cloud que se describe en la Sección 1.4(d) de las Condiciones del Servicio de Google Cloud Platform. Ten en cuenta que el esquema no controla los formatos de los valores de campo generados, y estos formatos pueden cambiar sin aviso previo. Por ejemplo, incident.summary, incident.documentation.content y incident.url están destinados a incluir datos relacionados con sus campos, pero el esquema no tiene restricciones para garantizar un análisis preciso de campos. Puedes consumir el valor como un todo y esperar que cumpla con la política de baja, pero no dependas del análisis de los campos generados.

Pub/Sub

En esta sección, se describe cómo configurar los canales de notificaciones de Pub/Sub. Para redundancia, te recomendamos que crees varios canales de notificación. Se recomienda vincular Pub/Sub con la app para dispositivos móviles de la consola de Google Cloud, PagerDuty, Webhooks o Slack, ya que Pub/Sub usa un mecanismo de entrega diferente.

Para configurar un canal de notificaciones de Pub/Sub, haz lo siguiente:

  1. Habilita las APIs necesarias y crea un tema
  2. Configura el canal de notificaciones de un tema
  3. Autoriza una cuenta de servicio
  4. Configura el canal de notificaciones en una política de alertas

Para comprender el esquema de datos, consulta Ejemplo de esquema.

Para recibir las notificaciones de alerta, también debes crear una de las siguientes suscripciones: pull, push o BigQuery.

Cuando la suscripción esté en un proyecto diferente que el tema, crea una cuenta de servicio en el proyecto del suscriptor y otórgale la función de roles/pubsub.subscriber.

Antes de comenzar

Cuando agregas el primer canal de notificaciones para un proyecto de Google Cloud, Cloud Monitoring crea una cuenta de servicio para ese proyecto. También otorga la función de Agente de servicio de notificaciones de Monitoring de Identity and Access Management a la cuenta de servicio. Esta cuenta de servicio permite que Monitoring envíe notificaciones a los canales de notificaciones basados en Pub/Sub en este proyecto.

La cuenta de servicio tiene el siguiente formato:

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

El nombre de la cuenta de servicio de notificaciones incluye un número de proyecto único de Google Cloud. Puedes encontrar el nombre, el ID y el número del proyecto en el panel del proyecto en la consola de Google Cloud, o puedes recuperarlos con el siguiente comando:

gcloud projects describe PROJECT_ID --format="value(project_number)"

Puedes ver y editar la cuenta de servicio con la consola de Google Cloud o Google Cloud CLI.

Habilita las APIs necesarias y crea un tema

En el proyecto de Google Cloud en el que planeas crear el canal de notificaciones y el tema de Pub/Sub, haz lo siguiente:

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  4. Habilita las API de Pub/Sub and Cloud Monitoring.

    Habilita las API

  5. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  6. Comprueba que la facturación esté habilitada en tu proyecto.

    Descubre cómo puedes habilitar la facturación

  7. Habilita las API de Pub/Sub and Cloud Monitoring.

    Habilita las API

  8. Cree un tema de Pub/Sub. Para obtener información sobre cómo crear un tema, consulta Cómo crear un tema. Por ejemplo, para crear un tema llamado notificationTopic con Google Cloud CLI, ejecuta el siguiente comando:

    gcloud pubsub topics create notificationTopic

A continuación, configura los canales de notificaciones de Pub/Sub.

Configura las notificaciones de un tema

Para crear un canal de notificaciones de Pub/Sub, puedes usar la API de Monitoring, Google Cloud CLI o la consola de Google Cloud. Después de crear el canal de notificaciones, autoriza a la cuenta de servicio de notificaciones para que publique cada tema que usas como canal de notificaciones.

Si quieres obtener información sobre el uso de la API de Monitoring o de Google Cloud CLI para crear el canal de notificaciones, consulta Crea canales.

Si deseas usar la consola de Google Cloud para crear el canal de notificaciones, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  2. Selecciona el proyecto de Google Cloud que contiene el tema de Pub/Sub que creaste.
  3. Haz clic en Editar canales de notificaciones.
  4. En la sección Pub/Sub, haz clic en Agregar nuevo.

    En el diálogo Created Pub/Sub Channel, se muestra el nombre de la cuenta de servicio que creó Monitoring.

  5. Autoriza la cuenta de servicio. Tu cuenta de servicio puede publicar todos los temas o temas específicos:

    • Para publicar todos los temas, selecciona Administrar roles y agrega el rol de Publicador de Pub/Sub.

      Después de completar estos pasos para configurar el canal de notificaciones, omite la siguiente sección, que se titula Autorizar cuenta de servicio, y continúa con Configura el canal de notificaciones en una política de alertas.

    • Para publicar temas específicos, continúa con el paso siguiente y autoriza a la cuenta de servicio para que publique temas específicos una vez que completes la configuración del canal de notificaciones. Si deseas obtener instrucciones para autorizar la cuenta de servicio, consulta Autoriza la cuenta de servicio.
  6. Ingresa un nombre visible para tu canal y el nombre del tema de Pub/Sub.
  7. Para verificar que el canal esté configurado correctamente, haz clic en Enviar notificación de prueba (opcional).
  8. Selecciona Agregar canal.

A continuación, autoriza la cuenta de servicio.

Autorizar cuenta de servicio

La autorización permite que la cuenta de servicio de notificaciones publique cada tema de Pub/Sub que usas como canal de notificaciones. En esta sección, se describe cómo puedes hacer lo siguiente:

  • Autoriza una cuenta de servicio para un tema específico.
  • Autoriza una cuenta de servicio para todos los temas.

Autoriza una cuenta de servicio para un tema específico

Puedes autorizar a una cuenta de servicio para que publique un tema específico con la consola de Google Cloud y Google Cloud CLI. En esta sección, se describen ambos enfoques.

Si deseas autorizar tu cuenta de servicio para un tema específico con la consola de Google Cloud, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, selecciona Pub/Sub y, luego, Temas:

    Ir a Temas

  2. Seleccione el tema.
  3. En la pestaña Permisos, selecciona Agregar principal.
  4. En el campo Principal nueva, ingresa el nombre de la cuenta de servicio de notificaciones. La cuenta de servicio tiene la siguiente convención de nombres:
    service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
  5. Selecciona el rol Publicador de Pub/Sub y, luego, Guardar.

Si quieres autorizar tu cuenta de servicio para un tema específico con Google Cloud CLI, otorga a la cuenta de servicio el rol de IAM pubsub.publisher correspondiente al tema. Por ejemplo, el siguiente comando configura el rol de IAM para el tema notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
 

Una respuesta a una ejecución correcta del comando add-iam-policy-binding es como la siguiente:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1
 

Para obtener más información, consulta la página de referencia de pubsub topics add-iam-policy-binding.

Autoriza una cuenta de servicio para todos los temas

A fin de autorizar tu cuenta de servicio para todos los temas, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige IAM:

    Ir a IAM

  2. Selecciona Incluir asignaciones de roles proporcionadas por Google como se muestra en la siguiente imagen:
    Selecciona la opción Incluir asignaciones de roles proporcionadas por Google.
  3. Busca la cuenta de servicio que tenga el siguiente formato:
    service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

    Vuelve a cargar la página cuando la cuenta de servicio no aparezca en la lista.

  4. Selecciona Editar para la cuenta de servicio de notificaciones, elige Agregar otro rol y, luego, agrega el rol Publicador de Pub/Sub.

A continuación, establece el canal de notificaciones en una política de alertas.

Establece el canal de notificaciones en una política de alertas

Para usar un canal de notificaciones de Pub/Sub en una política de alertas, selecciona Pub/Sub como el tipo de canal y, luego, el tema.

Ejemplo de esquema

Para ver un paquete JSON de ejemplo y el esquema, expande las siguientes secciones.

Política de baja

El esquema de carga útil está sujeto a la política de baja de Google Cloud que se describe en la Sección 1.4(d) de las Condiciones del Servicio de Google Cloud Platform. Ten en cuenta que el esquema no controla los formatos de los valores de campo generados, y estos formatos pueden cambiar sin aviso previo. Por ejemplo, incident.summary, incident.documentation.content y incident.url están destinados a incluir datos relacionados con sus campos, pero el esquema no tiene restricciones para garantizar un análisis preciso de campos. Puedes consumir el valor como un todo y esperar que cumpla con la política de baja, pero no dependas del análisis de los campos generados.

Google Chat

La app de Google Cloud Monitoring permite que tus espacios de Google Chat reciban notificaciones.

Antes de comenzar

Si estás en una organización, para instalar la app de Google Cloud Monitoring, debes tener acceso a ella. Si no tienes acceso, solicita a un administrador de Google Workspace que haga lo siguiente:

  1. Agrega la app a la lista de apps permitidas de Marketplace y habilita el acceso en la unidad organizativa superior.
  2. Establece la configuración de instalación del usuario de la app de Marketplace para que los usuarios puedan instalarla.

Instala la app de Google Cloud Monitoring

Debes usar el siguiente procedimiento para instalar la app de Google Cloud Monitoring. No se admite la instalación desde la ficha de Google Workspace Marketplace.

Para instalar la app y configurar un espacio como canal de notificaciones, haz lo siguiente:

  1. En Google Chat, abre o crea el espacio en el que quieres recibir notificaciones.

  2. Instala la aplicación de Google Cloud Monitoring:

    1. Selecciona el nombre de tu espacio y, luego, Integraciones y apps.

    2. Si la app de Google Cloud Monitoring no aparece en la lista de apps, regresa a tu espacio, ingresa @Google Cloud Monitoring y presiona Intro.

    3. Haz clic en Agregar al espacio.

  3. Copia el ID del espacio de Chat en el portapapeles.

    Si instalaste la app de Google Cloud Monitoring, el ID del espacio de chat se incluye en la confirmación de la instalación. De lo contrario, puedes encontrar el ID del espacio de chat como la serie de números y letras que siguen a space/ al final de la URL del espacio de chat.

  4. Abre una pestaña del navegador nueva y, luego, configura el canal de notificaciones:

    1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

      Ir a las Alertas

    2. Haz clic en Editar canales de notificaciones.

    3. Ve a la sección Google Chat y haz clic en Agregar nuevo.

    4. Ingresa tu ID del espacio de chat en el campo ID del espacio de Chat y, luego, haz clic en Guardar.

Crea un canal on demand

Cuando agregas un canal de notificaciones a una política de alertas, debes seleccionar un canal de una lista. Para actualizar la lista de opciones cuando creas una política de alertas, usa el siguiente proceso:

  1. En el diálogo de notificaciones, haz clic en Administrar canales de notificaciones. Se abrirá la ventana Canales de notificaciones en una nueva pestaña del navegador.
  2. Para agregar un canal de notificaciones nuevo, ubica el tipo de canal, haz clic en Agregar nuevo y, luego, sigue las instrucciones específicas del canal que se encuentran en la tabla anterior.
  3. Regresa a la pestaña original y, en el diálogo de notificación, haz clic en Actualizar.

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

  4. Selecciona el canal de notificaciones de la lista actualizada.

Cómo recibir notificaciones sobre un canal no compatible

Si tu canal de notificaciones preferido no es compatible, considera crear una canalización que se base en el envío de tus notificaciones a Pub/Sub. Para ver un ejemplo de Python que usa Flask, consulta Crea notificaciones personalizadas con Cloud Monitoring y Cloud Run. Para ver otros ejemplos, consulta el repositorio de Git de cloud-alerting-notification-forwarding.

Cómo probar un canal de notificaciones

Cloud Monitoring no admite una opción de prueba para los canales de notificación. Sin embargo, puedes verificar que un canal de notificaciones esté configurado correctamente mediante la creación de una política de alertas y la configuración de la condición que se activará.

Para probar de forma manual tus canales de notificaciones, puedes crear una política de alertas que supervise el uso de CPU de tus instancias de máquina virtual (VM):

  1. En el panel de navegación de la consola de Google Cloud, elige Compute Engine y, luego, Instancias de VM.

    Ir a Instancias de VM

  2. Selecciona una instancia de VM o crea una.
  3. Crea una política de alertas para supervisar el uso de CPU de esa instancia.

    Si tu proyecto de Google Cloud contiene varias instancias, agrega un filtro para seleccionar una.

  4. Configura los campos Activador de condición de la siguiente manera:

    1. Selecciona Umbral en el campo Tipo de condición.
    2. Selecciona Por debajo del umbral en el campo Posición del umbral.
    3. Selecciona un valor que sea mayor que el uso de CPU para tu instancia. Por ejemplo, si el gráfico muestra que el uso de CPU es de alrededor del 5%, establece el umbral en 10%.
    4. Expande Opciones avanzadas y selecciona No retest en el campo Retest window.

    Esta configuración establece la condición que se activará cuando el uso de CPU de una instancia de VM sea inferior al umbral especificado. Debido a que seleccionaste el umbral para que sea mayor que el uso de CPU de tu instancia de VM, la condición se activa.

  5. Agrega los canales de notificaciones a tu política.

  6. Expande Duración del cierre automático de incidentes y selecciona 30 min.

  7. Ingresa un nombre para la política y haz clic en Crear política.

  8. Después de que se active la condición, verifica que hayas recibido una notificación en cada canal de notificaciones.

  9. Borra la política de alertas. El incidente se cierra de forma automática después de que vence la duración del cierre automático.

  10. Si creaste una instancia de VM para esta prueba, bórrala.

Cómo editar y borrar canales de notificaciones

Para editar o borrar un canal de notificaciones con la consola de Google Cloud, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

    Ir a las Alertas

  2. Haz clic en Editar canales de notificaciones.

    El panel Canales de notificaciones contiene una sección para cada tipo de canal de notificaciones. En cada sección se muestran todas las configuraciones para ese tipo:

    • Para modificar una entrada, haz clic en Editar. Haz clic en Guardar una vez que se hayan completado los cambios.
    • Para borrar una entrada, haz clic en Borrar. Haz clic en Borrar en el cuadro de diálogo de confirmación.

Ver registros del canal de notificaciones

Puedes usar el Explorador de registros para ver los errores del canal de notificaciones:

  1. En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  2. Ingresa y ejecuta tu consulta. Para obtener consultas específicas sobre los errores del canal de notificaciones, revisa la sección Consultas de Cloud Monitoring.

¿Qué sigue?

Para obtener más información sobre incidentes, consulta los siguientes documentos: