Cómo crear y administrar canales de notificaciones

En este documento, se describe cómo configurar canales de notificaciones con la consola de Google Cloud. Cloud Monitoring usa estos canales para notificarte a ti o al equipo de guardia cuando se activa una política de alertas. Cuando creas un política de alertas, puedes elegir 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.

Nota: Los datos que se envían a los destinatarios del canal pueden contener información sensible. Revisa tus prácticas regulatorias antes de crear el canal de notificaciones.

Antes de comenzar

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

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

Para obtener más información sobre los roles de Cloud Monitoring, 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.

Nota: Te recomendamos que crees varios canales de notificaciones con fines de redundancia. Google no tiene control de muchos de los sistemas de entrega después de que envía la notificación a ese sistema. Además, un solo servicio de Google es compatible con la app de Cloud Mobile para dispositivos móviles, PagerDuty, Webhooks y Slack. Si usas uno de estos canales de notificaciones, usa el correo electrónico, SMS o Pub/Sub como canal redundante.

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

Correo electrónico

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

1. En 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 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 [e-mail].

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 tus 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 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 se produce el proyecto de Google Cloud seleccionado. Un canal de notificaciones 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, La supervisión tiene abierto el incidente, luego se reabrió 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 + Servicio nuevo.
     2. Ingresa un nombre y una descripción para el 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, regresarás a el panel Integrations (Integraciones) del nuevo servicio.
   • Para editar un servicio existente, haz lo siguiente:
     1. Selecciona un servicio del 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.
2. 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. 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 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 para 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 no se define este campo 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": 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:

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 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

Nota: Para completar estos pasos, debes ser un Propietario o administrador del lugar de trabajo de Slack. Para obtener más información, consulta Administra las solicitudes de invitación.

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  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 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. Para probar la conexión entre Cloud Monitoring y tu lugar de trabajo de Slack, haz clic en Enviar notificación de prueba (opcional). Si la conexión se realiza correctamente, verás un mensaje This is a test alert notification... en Canal de notificaciones de Slack que especificaste. Revisa el canal de notificaciones para confirmar la recepción.

5. Si el canal de Slack que quieres usar para las notificaciones es 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, 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 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

Nota: 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.

Nota: Si una función de Cloud Run se configura 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 Cómo autenticar llamadas de función a función y Cómo habilitar el acceso a una función.

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  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 cuadro de diálogo.
6. Haz clic en Probar conexión para enviar una carga útil de prueba al extremo de Webhook. Puedes ir al extremo receptor para verificar la entrega.
7. Haz clic en Guardar.

Cuando crees una política de alertas, selecciona Webhook en la sección Notificaciones y elige tu configuración de webhook. Las notificaciones 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 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.
  },
}

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

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

Pub/Sub

En esta sección, se describe cómo configurar las notificaciones de Pub/Sub canales. Para la redundancia, te recomendamos que crees varios canales de notificaciones. Vincula 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:

1. Habilita las APIs necesarias y crea un tema
2. Configura 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. 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:

[e-mail]

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:

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

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

Nota: Si planeas crear tu canal de notificaciones y Pub/Sub en diferentes proyectos de Google Cloud y, luego, habilita las APIs de Pub/Sub y Monitoring en ambos proyectos.

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.

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  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 la 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 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 Cómo autorizar una cuenta de servicio.
6. Ingresa un nombre visible para tu canal y el Nombre del tema de Pub/Sub.
7. (Opcional) Para verificar que el canal está configurado correctamente, haz lo siguiente: Haz clic en Enviar notificación de prueba.
8. Selecciona Agregar canal.

A continuación, autoriza la cuenta de servicio.

Autorizar cuenta de servicio

Nota: Completa este paso cuando crees el canal de notificaciones con la API o Google Cloud CLI, y cuando hayas omitido el paso de autorización cuando uses la consola de Google Cloud.

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 hacer lo siguiente:

• Autorizar 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 consola de Google Cloud y Google Cloud CLI. En esta sección, se describe 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:

   Ir a Temas

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

2. Selecciona el tema.
3. En la pestaña Permisos, selecciona Agregar principal.
4. En el campo Principal nueva, ingresa el nombre de las notificaciones. cuenta de servicio. La cuenta de servicio tiene los siguientes nombres: convención:

   [e-mail]

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, 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:[e-mail]
 

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:[e-mail]
    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:

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:

   [e-mail]

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

4. Selecciona Editar para la cuenta de servicio de notificaciones, 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, selecciona 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 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 para 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.

Google Chat

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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, instala el comando 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:

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

Instala la app de Google Cloud Monitoring

Debes usar el siguiente procedimiento para instalar 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:

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, selecciona Integraciones y apps.

   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  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 el ID de tu espacio de Chat en el campo ID de espacio de Chat y, luego, haz clic en Guardar.

Nota: No puedes ver ni administrar el incidente con la app de Google Cloud Monitoring. Para confirmar el incidente o posponer la política de alertas relacionada, usa la consola de Google Cloud, Google Cloud CLI o la API de Cloud Monitoring.

Crea un canal a pedido

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:

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

3. Regresa a la pestaña original y, en el diálogo de notificaciones, haz clic en Actualizar.

   

4. 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):

1. Opcional: Si aún no tienes una VM en tu proyecto de Google Cloud o quieres 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 ver más para crear VMs, consulta Crea una instancia de VM a partir de una imagen pública.

2. 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.

3. Selecciona Crear política.

4. Utiliza el menú Seleccionar una métrica para seleccionar la métrica Uso de CPU. para una instancia de VM.

5. Haz clic en Agregar filtro y agrega un filtro para tu VM.

6. Actualiza los campos Configurar activador de la siguiente manera:

   1. Selecciona Debajo del umbral para el campo Posición del umbral.

   2. Selecciona un valor mayor que el uso de CPU de tu instancia. Por ejemplo, si el gráfico muestra que el uso de la CPU es de alrededor del 5%, establece el límite en el 10%.

      Esta configuración establece la condición que se debe cumplir cuando 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.

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

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

9. Ingresa un nombre de política y haz clic en Crear política.

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

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

12. 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 mediante la consola de Google Cloud, haz lo siguiente:

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

   Ir a las Alertas

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

2. 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.

Nota: No puedes borrar un canal de notificaciones con la consola de Google Cloud. cuando el canal se asocia con una política de alertas. Sin embargo, puedes borrar el canal con la CLI de Google Cloud o la API de Cloud Monitoring. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones con la API.

Cómo ver los registros del canal de notificaciones

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

1. 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.

2. Ingresa y ejecuta tu consulta. Para consultas específicas sobre errores de canales de notificaciones, consulta Consultas de Cloud Monitoring.

¿Qué sigue?

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

• Incidentes para las políticas de alertas basadas en métricas
• Incidentes para políticas de alertas basadas en registros.