Cómo crear y administrar canales de notificaciones

Correo electrónico

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

1. En la consola de Google Cloud, ve a la página notifications 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. 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 dispositivos móviles

Usa la app para dispositivos móviles de la consola de Google Cloud para supervisar los 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 o a un usuario específico:

• 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 de la consola de Google Cloud para dispositivos móviles.

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

Para configurar un canal de notificaciones de la app para dispositivos móviles de la consola de Google Cloud en 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. Un canal de notificación se crea cuando no existe y, después de unos minutos, este canal 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 Notificaciones, selecciona la consola de Google Cloud (móvil) y, luego, elige tu dispositivo móvil de la lista.

PagerDuty

PagerDuty admite la sincronización bidireccional con Monitoring. Como resultado, se cumple lo siguiente:

• Si se crea un incidente en Monitoring, se abre un incidente en PagerDuty.
• No puedes usar PagerDuty para cerrar un incidente en Monitoring.
• Si resuelves un incidente en PagerDuty y está abierto en Monitoring, se vuelve a abrir en PagerDuty.

Para configurar las notificaciones de PagerDuty, sigue estos pasos:

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 + Nuevo servicio.
     2. Ingresa un nombre y una descripción del servicio 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, luego, haz clic en Siguiente.
     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. Luego, se te redireccionará al panel Integraciones de tu servicio nuevo.
   • Para editar un servicio existente, haz lo siguiente:
     1. Selecciona un servicio de tu directorio de servicios.
     2. En la página de tu 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 Search for an integration(s), ingresa Events API v1 y, luego, haz clic en Add. Luego, volverás al panel Integraciones de tu servicio editado.
   3. En el panel Integraciones de tu servicio, busca la ficha de la integración nueva, expande su menú y, luego, copia la clave de integración.
   4. Opcional: Configura PagerDuty para asignar con precisión los valores de gravedad de los incidentes de Monitoring.
2. En Cloud Monitoring, agrega el canal de notificaciones de PagerDuty:

   1. En la consola de Google Cloud, ve a la página notifications 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. 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 integración nueva en el paso 1.
   5. Pega la clave de integración que copiaste en el paso 1 en el campo Clave del servicio.
   6. Haz clic en Guardar.

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.

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Política de baja

Configura PagerDuty para asignar niveles de gravedad

De forma predeterminada, las notificaciones de PagerDuty muestran todos los niveles de gravedad de los incidentes como “críticos”. Puedes configurar reglas de orquestación de eventos en PagerDuty para que la gravedad de la alerta de PagerDuty coincida con la gravedad del incidente de Monitoring:

1. En tu cuenta de PagerDuty, ve a la página Servicios.
2. Selecciona el servicio de PagerDuty en el que recibes notificaciones de Google Cloud.
3. Haz clic en Configuración.
4. Ve a la sección Administración de eventos y, luego, haz clic en Ver reglas de orquestación.
5. Haz clic en Nueva regla.
6. Para cada valor de gravedad de Monitoring que desees convertir, crea una regla condicional que asigne el valor de gravedad a un valor equivalente de PagerDuty:
   1. En el menú de Paso 1: ¿Cuándo se debe aplicar esta regla?, Selecciona Si los eventos coinciden con ciertas condiciones.
   2. Selecciona el editor de código.
   3. En la sección Si, ingresa event.custom_details.incident.severity matches part 'VALUE', donde VALUE es el nombre de un valor de gravedad de supervisión y, luego, haz clic en Siguiente.
   4. En Paso 2: ¿Qué acciones se deben aplicar?, selecciona Alert Data.
   5. Establece la gravedad de la alerta en un valor que coincida con el valor de supervisión que ingresaste en el paso C y, luego, guarda los cambios.
7. Opcional: Para agregar reglas adicionales, haz clic en Regla Else.

SMS

Para configurar las notificaciones por SMS, sigue estos pasos:

1. En la consola de Google Cloud, ve a la página notifications 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. 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 la consola de Google Cloud, ve a la página notifications 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.

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 usar para las notificaciones.
   4. En el campo Nombre visible de alertas de Cloud, ingresa una breve declaración descriptiva. 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 es exitosa, 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 deseas usar para las notificaciones es un canal privado, debes invitar manualmente a 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

Antes de configurar un canal de notificaciones de Webhook, ten en cuenta lo siguiente:

• Los webhooks solo admiten extremos públicos. Si necesitas notificaciones enviadas a un extremo que no es público, crea un canal de notificaciones de Pub/Sub y configura una suscripción al tema de Pub/Sub. Para obtener más información, consulta Las notificaciones de webhook fallan cuando se configuran para un extremo privado.
• Si una función de Cloud Run está configurada como extremo dewebhook para un canal de notificaciones, asegúrate de que el usuario que invoca la función tenga el permiso de autenticación requerido. Para obtener más información, consulta Autentica para la invocación y Habilita el acceso a una función.
• Los canales de notificaciones de webhook no son compatibles con Microsoft Teams. Para enviar datos de notificaciones de Monitoring a Microsoft Teams, crea una capa de integración para recibir el webhook de Monitoring y, luego, redirecciona el tráfico a Microsoft Teams.

Configura los canales de notificaciones de Webhook

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 la consola de Google Cloud, ve a la página notifications 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.

3. Haz clic en Editar canales de notificaciones.
4. En la sección Webhook, haz clic en Agregar nuevo.
5. Completa el 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 que envía Error Reporting siguen el esquema 1.0, mientras que las que envía Monitoring siguen el esquema 1.2:

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "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:

• Especificación de RFC
• Autenticación básica

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

Pub/Sub

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

Para configurar un canal de notificaciones de Pub/Sub, sigue estos pasos:

1. Habilita las APIs necesarias y crea un tema
2. Cómo configurar el canal de notificaciones de un tema
3. Cómo autorizar una cuenta de servicio
4. Cómo configurar 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: extracción, envío o BigQuery.

Cuando la suscripción esté en un proyecto diferente al tema, crea una cuenta de servicio en el proyecto del suscriptor y bríndale el rol de roles/pubsub.subscriber.

Antes de comenzar

Cuando agregas el primer canal de notificaciones de Pub/Sub a un proyecto de Google Cloud, Cloud Monitoring crea una cuenta de servicio para ese proyecto. También otorga el rol de Identity and Access Management Agente de servicio de notificaciones de supervisión 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 único del proyecto 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 recuperarlo 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 obligatorias 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Pub/Sub and Cloud Monitoring APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Pub/Sub and Cloud Monitoring APIs.

   Enable the APIs

8. Cree un tema de Pub/Sub. Para obtener información sobre cómo crear un tema, consulta Crea 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 tus canales de notificaciones de Pub/Sub.

Configura notificaciones para 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 uses como canal de notificaciones.

Si quieres obtener información para usar la API de Monitoring o Google Cloud CLI para crear el canal de notificaciones, consulta Cómo crear canales.

Para usar la consola de Google Cloud y crear el canal de notificaciones, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página notifications 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. 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.

   El diálogo Created Pub/Sub Channel 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, titulada Cómo autorizar una cuenta de servicio, y continúa con Cómo configurar el canal de notificaciones en una política de alertas.

   • Para publicar temas específicos, continúa con el siguiente paso y autoriza a la cuenta de servicio a publicar temas específicos después de completar la configuración del canal de notificaciones. Para obtener instrucciones para autorizar la cuenta de servicio, consulta Cómo autorizar una 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 uses como canal de notificaciones. En esta sección, se describe cómo hacer lo siguiente:

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

Cómo autorizar 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 console de Google Cloud y Google Cloud CLI. En esta sección, se describen ambos enfoques.

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

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

   Ve a Temas.

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

2. Selecciona el tema.
3. En la pestaña Permisos, selecciona Agregar principal.
4. En el campo Principal nuevo, 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.

Para autorizar tu cuenta de servicio para un tema específico con Google Cloud CLI, otorga el rol de IAM pubsub.publisher para el tema a la cuenta de servicio. Por ejemplo, con el siguiente comando, se 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 similar a 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.

Cómo autorizar una cuenta de servicio para todos los temas

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

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

   Ir a IAM

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

2. Selecciona Incluir asignaciones de roles proporcionadas por Google, como se muestra en la siguiente imagen:
   
3. Busca la cuenta de servicio que tiene 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 edit Editar para la cuenta de servicio de notificaciones, selecciona Agregar otro rol y, luego, agrega el rol Publicador de Pub/Sub.

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

Cómo configurar 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, selecciona el tema.

Ejemplo de esquema

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

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "severity": "no severity",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\" metadata.system_labels.\"state\"=\"ACTIVE\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown",
      "subject": "ALERT - No severity",
      "links": [
        {
          "displayName": "Playbook",
          "url": "https://myownpersonaldomain.com/playbook?name=${resource.name}"
        }
      ]
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}

Política de baja

Google Chat

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

Antes de comenzar

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

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

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 deseas recibir notificaciones.

2. Instala la app de Google Cloud Monitoring:

   1. Selecciona el nombre de tu espacio y, luego, Apps y integraciones.

   2. Si la app de Google Cloud Monitoring no aparece en la lista de apps, vuelve a tu espacio, ingresa @Google Cloud Monitoring y, luego, 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 instalación. De lo contrario, puedes encontrar el ID del espacio de chat como la serie de números y letras que sigue a space/ al final de la URL del espacio de chat.

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

   1. En la consola de Google Cloud, ve a la página notifications 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. Haz clic en Editar canales de notificaciones.

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

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