Se usó la API de Cloud Translation para traducir esta página.

Cómo crear y administrar canales de notificaciones

En este documento, se describe cómo configurar los 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 notificaciones mediante las selecciones 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 las notificaciones 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 por 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 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.

Es posible que también puedas obtener los permisos necesarios a través de funciones personalizadas o, también, otras funciones predefinidas.

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.

Si deseas crear un canal de notificaciones con la consola de Google Cloud, sigue las instrucciones específicas del canal que aparecen en la siguiente tabla:

Correo electrónico

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

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.
Haz clic en Editar canales de notificaciones.
En la sección Correo electrónico, haz clic en Agregar nuevo.
Ingresa una sola dirección de correo electrónico y una descripción.
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 en un proyecto específico de Google Cloud, haz lo siguiente:

Instala la app para dispositivos móviles de la consola de Google Cloud desde la tienda de aplicaciones de tu dispositivo móvil.
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. Cuando no existe uno, se crea un canal de notificaciones y, después de unos minutos, aparece en la sección Dispositivos móviles de la página Canales de notificaciones.

Para agregar tu dispositivo móvil como canal de notificaciones de una política de alertas, en la sección Notificaciones de alertas, selecciona Google Cloud Console (móvil) 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. De hecho, si resuelves un incidente en PagerDuty, el incidente se cierra de forma permanente en PagerDuty y no se puede reabrir.

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

Para configurar las notificaciones de PagerDuty, haz lo siguiente:

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.
3. En el panel Integraciones del servicio, busca la ficha de tu nueva integración, expande su menú y, luego, copia la clave de integración.
En Cloud Monitoring, agrega el canal de notificaciones de PagerDuty:
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. 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). Debe coincidir con el nombre del servicio PagerDuty en el que configuraste la integración nueva en el paso 1.
5. Ingresa la clave de integración que copiaste en el paso 1 en el campo Clave del servicio.
6. Haz clic en Guardar.
Opcional: Si deseas 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 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.

Ejemplos de JSON

De forma predeterminada, el backend de alertas intenta generar un paquete JSON con formato de versión 1.2. Para obtener más información sobre este formato, consulta la siguiente sección.

A continuación, se muestra un ejemplo de un paquete de este tipo:


{
  "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"
}

Estructura del esquema, versión 1.2

En esta sección, se describe la versión 1.2 del esquema de la carga útil. Es posible que algunos campos no aparezcan en todos los paquetes que se muestran o tengan valores vacíos, según la configuración de la política de alertas, el estado del incidente o el recurso que se supervisa. Algunos campos toman estructuras incorporadas como valores. Estas estructuras se describen como referencia porque su contenido también puede variar.

En un paquete que se muestra, los campos pueden ocurrir en cualquier orden. En la siguiente descripción, se organizan en grupos relacionados.

{
  "version": "1.2",
  "incident": {

    Información sobre el incidente.

    "incident_id": string que genera el ID de este incidente.
    "scoping_project_id": es la string, el ID del proyecto que aloja el permiso de las métricas.
    "scoping_project_number": el número del proyecto de alcance.
    "url": Cadena, URL de la consola de Google Cloud de este incidente.
    "started_at": número, tiempo (en segundos de Unix) cuando se abrió el incidente.
    "ended_at": número, tiempo (en segundos de Unix) cuando se cerró el incidente. Se propaga solo cuando state es closed.
    "state": string, estado del incidente: open o closed. Si es open, ended_at es nulo.
    "summary": string, resumen textual generado del incidente.
    "apigee_url": string, URL de Apigee para este incidente, solo para los tipos de recursos de Apigee Environment y Proxy*.
    "observed_value": Es la string, el valor observado que activó o resolvió la alerta, puede estar vacía si la condición venció.

    Información sobre el recurso supervisado para el que se abrió el incidente.

    "resource": {
      "type": string, identificador del tipo de recurso supervisado en el que se alerta, por ejemplo, gce_instance. Consulta Lista de recursos supervisados.
      "labels": Objeto, pares clave-valor para etiquetas asociadas con el recurso supervisado.
    },
    "resource_type_display_name": string, nombre visible del tipo de recurso supervisado.
    "resource_id": string, ID de instancia del recurso supervisado, el mismo valor que resource.labels.instance_id.
    "resource_display_name": string, nombre visible del recurso supervisado.
    "resource_name": string, nombre generado de este recurso supervisado; consiste en valores de otros campos.

    Información sobre el tipo de métrica de los datos de series temporales.

    "metric": {
      "type": string, identificador del tipo de métrica que se alerta, por ejemplo, compute.googleapis.com/instance/cpu/utilization. Consulta Lista de métricas.
      "displayName": string, nombre visible del tipo de métrica.
      "labels": Son los pares clave-valor de objeto para las etiquetas asociadas con la métrica.
    },
    "metadata": {
      "system_labels": Pares clave-valor para objetos para etiquetas de metadatos del sistema.
      "user_labels": Son los objetos, pares clave-valor para etiquetas de metadatos del usuario.
    },

    Información sobre la política de alertas y la condición que abrió/resolvió el incidente.
    Los valores se extraen del objeto AlertPolicy relevante.

    "policy_name": string, nombre visible para la política de alertas.
    "policy_user_labels": Objetos, pares clave-valor para cualquier etiqueta de usuario adjunta a la política.
    "documentation": Un objeto, una estructura incorporada con el formato Documentation.
    "condition": Un objeto, una estructura incorporada con el formato Condition.
    "condition_name": string, nombre visible de la condición, mismo valor que condition.displayName.
    "severity": cadena y nivel de gravedad de los incidentes Si este campo no está definido durante la creación de la política de alertas, Cloud Monitoring establece la gravedad de la política de alertas en No Severity.
    "threshold_value": Es la cadena, el valor de umbral de esta condición, que puede estar vacía si la condición no es una condición de umbral.
  },
}

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:

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.
Haz clic en Editar canales de notificaciones.
En la sección SMS, haz clic en Agregar nuevo.
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:

En Slack: crea un lugar de trabajo y un canal de Slack en el sitio de Slack. Registra la URL del canal.
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.
Haz clic en Editar canales de notificaciones.
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 Cloud Alerting Display Name (Nombre visible de alertas de Cloud), ingresa una instrucción descriptiva breve. Monitoring muestra el valor de este campo en la página Canal de notificaciones.
5. (Opcional) Para probar la conexión entre Cloud Monitoring y tu lugar de trabajo de Slack, haz clic en Enviar notificación de prueba. Si la conexión se establece correctamente, 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.
Si el canal de Slack que deseas usar para las notificaciones es privado, debes invitar de forma manual 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:

El controlador de webhook: Identifica la URL del extremo público para recibir los datos de webhook desde Monitoring.
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.
Haz clic en Editar canales de notificaciones.
En la sección Webhook, haz clic en Agregar nuevo.
Completa el cuadro de diálogo.
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.
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 que envía Monitoring siguen el esquema 1.2:

Ejemplos de JSON

De forma predeterminada, el backend de alertas intenta generar un paquete JSON con formato de versión 1.2. Para obtener más información sobre este formato, consulta la siguiente sección.

A continuación, se muestra un ejemplo de un paquete de este tipo:


{
  "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"
}

Estructura del esquema, versión 1.2

En un paquete que se muestra, los campos pueden ocurrir en cualquier orden. En la siguiente descripción, se organizan en grupos relacionados.

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

Pub/Sub

En esta sección, se describe cómo configurar los canales de notificaciones de Pub/Sub. Para redundancia, te recomendamos crear varios canales de notificaciones. Se recomienda sincronizar 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, sigue estos pasos:

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

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

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

Cuando la suscripción se encuentra en un proyecto diferente al del tema, crea una cuenta de servicio en el proyecto del suscriptor y otórgale el rol 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 Monitoring a la cuenta de servicio. Esta cuenta de servicio permite que Monitoring envíe notificaciones a 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 de proyecto de Google Cloud. Puedes encontrar el nombre, el ID y el número del proyecto en su panel de 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 mediante 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:

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.

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

Go to project selector

Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Habilita las API de Pub/Sub and Cloud Monitoring.

Habilita las API

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

Go to project selector

Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Habilita las API de Pub/Sub and Cloud Monitoring.

Habilita las API

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

Si quieres obtener información sobre el uso de la API de Monitoring o 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:

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.
Selecciona el proyecto de Google Cloud que contiene el tema de Pub/Sub que creaste.
Haz clic en Editar canales de notificaciones.
En la sección Pub/Sub, haz clic en Agregar nuevo.

En el cuadro de diálogo Created Pub/Sub Channel, se muestra el nombre de la cuenta de servicio que creó Monitoring.
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 Publicador de Pub/Sub.
  
  Después de completar estos pasos para configurar el canal de notificaciones, omite la siguiente sección, que se titula Autoriza la 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 siguiente paso y autoriza a la cuenta de servicio para que publique temas específicos después de completar la configuración del canal de notificaciones. Si quieres obtener instrucciones para autorizar la cuenta de servicio, consulta Autoriza la cuenta de servicio.
Ingresa un nombre visible para tu canal y el nombre del tema de Pub/Sub.
Para verificar que el canal esté configurado correctamente, haz clic en Enviar notificación de prueba (opcional).
Selecciona Agregar canal.

Luego, 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 un canal de notificaciones. En esta sección, se describe cómo puedes hacer lo siguiente:

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

Autoriza una cuenta de servicio para un tema específico

Puedes autorizar 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 mediante la consola de Google Cloud, sigue estos pasos:

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

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo sea Pub/Sub.
Selecciona el tema.
En la pestaña Permisos, selecciona Agregar principal.
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
```
Selecciona el rol Publicador de Pub/Sub y, a continuación, selecciona Guardar.

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

La 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

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

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.
Selecciona Incluir asignaciones de roles proporcionadas por Google como se muestra en la siguiente imagen:
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.
Selecciona 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.

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, el tema.

Ejemplo de esquema

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

Ejemplos de JSON

De forma predeterminada, el backend de alertas intenta generar un paquete JSON con formato de versión 1.2. Para obtener más información sobre este formato, consulta la siguiente sección.

A continuación, se muestra un ejemplo de un paquete de este tipo:


{
  "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"
}

Estructura del esquema, versión 1.2

En un paquete que se muestra, los campos pueden ocurrir en cualquier orden. En la siguiente descripción, se organizan en grupos relacionados.

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 estás en una organización, debes tener acceso a la app de Google Cloud Monitoring para instalar la app de Google Cloud Monitoring. Si no tienes acceso, solicita a un administrador de Google Workspace que haga lo siguiente:

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 lista de Google Workspace Marketplace.

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

En Google Chat, abre o crea el espacio en el que quieres recibir notificaciones.
Instala la app de Google Cloud Monitoring:
1. Selecciona el nombre de tu espacio y, luego, selecciona 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, luego, presiona Intro.
3. Haz clic en Agregar al espacio.
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.
Abre una nueva pestaña del navegador y configura el canal de notificaciones:
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. 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 de 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:

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.
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.
Regresa a la pestaña original y, en el diálogo de la notificación, haz clic en Actualizar.
Selecciona el canal de notificaciones de la lista actualizada.

Cómo recibir notificaciones en 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 cloud-alerting-notification-forwarding de Git.

Prueba un canal de notificaciones

Cloud Monitoring no admite una opción de prueba para los canales de notificaciones. Sin embargo, puedes verificar que un canal de notificaciones esté configurado de forma correcta creando una política de alertas y configurando la condición que se cumplirá.

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

Opcional: Si aún no tienes una VM en tu proyecto de Google Cloud o deseas usar una VM diferente para las pruebas, crea una VM:
1. En la consola de Google Cloud, ve a la página Instancias de VM.
  Ir a Instancias de VM
  
  Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Compute Engine.
2. Selecciona Crear instancia y, luego, configura tu VM. Para obtener más información sobre la creación de VM, consulta Crea una instancia de VM a partir de una imagen pública.
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.
Selecciona Crear política.
Usa el menú Seleccionar una métrica para seleccionar la métrica Uso de CPU para una instancia de VM.
Haz clic en Agregar filtro y agrega un filtro para tu VM.
Actualiza los campos Configure trigger de la siguiente manera:
1. Selecciona Por debajo del umbral en el campo Posición del umbral.
2. Selecciona un valor superior al uso de CPU para tu instancia. Por ejemplo, si en el gráfico se muestra que el uso de CPU es de alrededor del 5%, establece el umbral en 10%.
  
  Con esta configuración, se configura la condición que se cumplirá cuando el uso de CPU de una instancia de VM sea menor que el umbral especificado. Debido a que seleccionaste que el umbral sea mayor que el uso de CPU de tu instancia de VM, se cumple la condición de la política de alertas.
Agrega los canales de notificación a tu política.
Expande Duración del cierre automático de incidentes y selecciona 30 min.
Ingresa un nombre para la política y haz clic en Crear política.
Después de que se cumpla la condición, verifica que hayas recibido una notificación en cada canal de notificaciones.
Borra la política de alertas. El incidente se cierra automáticamente después de que vence la duración del cierre automático.
Si creaste una instancia de VM para esta prueba, bórrala.

Si no recibes las notificaciones esperadas, puedes buscar en el Explorador de registros entradas de registro con información sobre las notificaciones faltantes. Para obtener más información, consulta No se reciben las notificaciones.

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:

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.
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 de canales de notificaciones

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

En la consola de Google Cloud, ve a la página Explorador de registros:
Ir al Explorador de registros

Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
Ingresa y ejecuta tu consulta. Para realizar consultas específicas sobre errores de canales de notificaciones, visita Consultas de Cloud Monitoring.

¿Qué sigue?

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