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 canales de notificaciones con la consola de Google Cloud. Cloud Monitoring usa estos canales para notificarte o tu equipo de guardia, cuando se activa una política de alertas. Cuando creas un política de alertas, tú eliges quién recibe notificaciones lista de canales de notificación configurados. Por ejemplo, puedes configurar políticas de alertas que supervisan las instancias de Compute Engine para publicar un tema de Pub/Sub y para notificar al canal de Slack para el equipo de guardia.

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

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

Antes de comenzar

Si deseas obtener los permisos que necesitas para ver y configurar los canales de notificaciones con la consola de Google Cloud, solicita 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.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles de Cloud Monitoring, ver 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 estos pasos: 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 Crea 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 tu Recursos y Monitoring de la consola de Google Cloud información desde cualquier lugar. Las notificaciones de la app para dispositivos móviles de la consola de Google Cloud son enviados a un dispositivo o usuario específicos:

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 tus dispositivos que tengan 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.

Configurar un canal de notificaciones de la app para dispositivos móviles de la consola de Google Cloud en relación con un proyecto 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 se produce el proyecto de Google Cloud seleccionado. Un canal de notificaciones se crea cuando no hay y, después de unos minutos, este canal aparecerá en la lista 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 alerta de alertas, en la sección de notificaciones de alertas, selecciona consola de Google Cloud (dispositivo móvil) y, luego, elige tu dispositivo móvil la lista.

PagerDuty

La integración con PagerDuty permite una 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 PagerDuty, entonces el estado del incidente en PagerDuty se desacopla de el estado del incidente en Monitoring. En efecto, si resolver un incidente en PagerDuty, entonces el incidente se cierra de forma permanente en PagerDuty y no se pueden volver a abrir.

Si usas la sincronización bidireccional, los controles de Monitoring el estado que muestra PagerDuty. Si resuelves el incidente en PagerDuty y si Monitoring tiene el incidente abierto, entonces el incidente se reabrió en PagerDuty.

Para configurar las notificaciones de PagerDuty, sigue estos pasos: haz lo siguiente:

En tu cuenta de PagerDuty, configura la integración en una nueva o agregar la integración 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, expande su menú y 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). Este nombre debe coincidir con el del servicio PagerDuty en el que configuraste tu nueva la integración en el paso 1.
5. Ingresa la clave de integración que copiaste en el paso 1 en el Service Key.
6. Haz clic en Guardar.
Opcional: Si deseas configurar la sincronización bidireccional, sigue estos pasos: 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 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, haz lo siguiente: 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": o la 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": la cadena y el nivel de gravedad de los incidentes. Si este campo no se define durante la creación de la política de alertas, Luego, Cloud Monitoring establece la gravedad de la política de alertas en No Severity.
    "threshold_value": string, el valor de umbral de esta condición, 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 quieres usar para las notificaciones.
4. En el campo Cloud Alerting Display Name, ingresa un nombre descripción. 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 espacio de trabajo de Slack, haz clic Enviar notificación de prueba. Si la conexión se realiza correctamente, verás un mensaje This is a test alert notification... en Canal de notificaciones de Slack que especificaste. Consulta el canal de notificaciones para confirmar la recepción.
Si el canal de Slack que quieres usar para las notificaciones es un privado, deberás invitarlo manualmente App de supervisión 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, haz lo siguiente: ingresando y enviando el siguiente mensaje en el canal:
```
/invite @Google Cloud Monitoring
```
  Asegúrate de invitar a la app de Monitoring a la versión privada canal que especificaste al crear el canal de notificaciones en Supervisión 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 que envía Error Reporting siguen Esquema 1.0 mientras que las notificaciones enviadas por Monitoring siguen la 1.2 Esquema:

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 las notificaciones de Pub/Sub canales. Para redundancia, recomendamos que crees varios canales de notificaciones. Vincular Pub/Sub con la app para dispositivos móviles de la consola de Google Cloud, Se recomienda PagerDuty, Webhooks o Slack porque 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 está en un proyecto diferente al del tema, crea una cuenta de servicio en el proyecto del suscriptor y otórgale los 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. Integra también otorga el rol 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 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 de 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 puedes recuperarla con el siguiente comando:

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

Puedes ver y editar la cuenta de servicio con el 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 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 los canales de notificaciones de Pub/Sub.

Configura las notificaciones de un tema

Para crear un canal de notificaciones de Pub/Sub, puedes usar el la API de Monitoring, Google Cloud CLI o la Consola de Google Cloud Después de crear la notificación de notificaciones, autoriza a la cuenta de servicio de notificaciones publicar cada tema que uses como un canal de notificaciones.

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

Si quieres 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 la 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.

El cuadro de diálogo Created Pub/Sub Channel muestra el nombre del a la cuenta de servicio que Monitoring crear.
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 la notificación o el canal, omita 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 autorizas a la cuenta de servicio a publicar temas específicos completar la configuración del canal de notificaciones. Para 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.
(Opcional) Para verificar que el canal está configurado correctamente, haz lo siguiente: Haz clic en Enviar notificación de prueba.
Selecciona Agregar canal.

Luego, autoriza la cuenta de servicio.

Autorizar cuenta de servicio

La autorización permite que la cuenta de servicio de notificaciones publicar 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 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 describe ambos enfoques.

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

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 las notificaciones. cuenta de servicio. La cuenta de servicio tiene los siguientes nombres: convención:
```
service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
```
Selecciona el rol Publicador de Pub/Sub y, luego, Guardar.

Para autorizar tu cuenta de servicio a un tema específico mediante de Google Cloud CLI, otorga el permiso pubsub.publisher Es el rol de IAM del tema en la cuenta de servicio. Por ejemplo, el siguiente comando configura la 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 exitosa de la El comando add-iam-policy-binding es como el 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 el pubsub topics add-iam-policy-binding página de referencia.

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 el servicio de notificaciones. cuenta, selecciona Agregar otro rol y, luego, agrégalo 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, selecciona el tema.

Ejemplo de esquema

Para ver un ejemplo de paquete JSON y el esquema, expande lo siguiente 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 hagan lo siguiente: para recibir notificaciones.

Antes de comenzar

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

Instala la app de Google Cloud Monitoring

Debes usar el siguiente procedimiento para instalar el App de Google Cloud Monitoring Instalación desde el Ficha de Google Workspace Marketplace no es compatible.

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

En Google Chat, abre o crea el espacio donde quieras para 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 Luego, vuelve 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 espacio de chat El ID se incluye en la confirmación de la instalación. De lo contrario, puedes puedes encontrar el ID del espacio de Chat como la serie de números y letras Sigue 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 estés para crear 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.
Vuelve a la pestaña original y, en el cuadro de diálogo de 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 uno una canalización que se basa en el envío de 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.

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 correctamente si crear una política de alertas y configurar la condición que se cumplirá.

Para probar manualmente tus 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 quieres usar una VM diferente para las pruebas y, luego, 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 ver más para crear VMs, 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 el gráfico muestra el uso de CPU a sea de alrededor del 5%. Luego, configura el umbral en 10%.
  
  Estos parámetros de configuración configuran la condición que se cumplirá cuando se cumpla el uso de CPU de una instancia de VM es inferior al umbral especificado. Porque tú seleccionaste el umbral para que sea superior al 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 el cada canal de notificaciones.
Borra la política de alertas. El incidente se cierra automáticamente después de que hasta que venza el cierre automático.
Si creaste una instancia de VM para esta prueba, bórrala.

Si no recibes las notificaciones esperadas, puedes hacer lo siguiente: buscar en el Explorador de registros entradas de registro con información sobre los notificaciones. 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, sigue estos pasos: 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 consultas específicas de para errores de canales de notificaciones, revisa Consultas de Cloud Monitoring.

¿Qué sigue?

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