Cómo configurar y administrar notificaciones

Puedes configurar Error Reporting para que envíe notificaciones a los canales de notificaciones de Cloud Monitoring seleccionados cuando se produzcan eventos de error.

Error Reporting envía notificaciones en los siguientes casos:

• Cuando ocurre un evento de error en un Google Cloud proyecto y no se puede agrupar con errores anteriores.

• Si se produce un evento de error en un grupo de errores que se marcó como Resuelto.

Administrar canales de notificaciones

Puedes crear, editar y borrar canales de notificaciones en Monitoring. Después de crear los canales de notificaciones, puedes configurar Error Reporting para usarlos.

Error Reporting te permite seleccionar entre cuatro tipos de canales de notificaciones: correo electrónico, dispositivo móvil, Slack y Webhooks.

Antes de comenzar

Para obtener los permisos que necesitas para ver y configurar canales de notificaciones con la Google Cloud consola, pídele a tu administrador que te otorgue el rol de IAM de editor de supervisión (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 a través de roles personalizados o cualquier otro rol predefinido.

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

Crea un canal de notificaciones

Para crear un canal de notificaciones con la Google Cloud consola, 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 Google Cloud consola de, ve a la  Alertas página:

   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. En la barra de herramientas de la Google Cloud consola, elige el Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
3. Haz clic en Editar canales de notificaciones.
4. En la sección Correo electrónico, haz clic en Agregar nuevo.
5. Ingresa una sola dirección de correo electrónico y una descripción.
6. 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].

Aplicación para dispositivos móviles

Usa la Google Cloud app para dispositivos móviles de la consola para supervisar los Google Cloud recursos de la consola y la información de Monitoring desde cualquier lugar. Google Cloud Las notificaciones de la app para dispositivos móviles de la consola 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 Nombre visible campo incluye información del dispositivo.
• Usuario indica que las notificaciones se envían a todos los dispositivos que tienen instalada la app para dispositivos móviles de la consola de Google Cloud .

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

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

1. Instala la app para dispositivos móviles de la Google Cloud consola desde la tienda de aplicaciones de tu dispositivo móvil.

2. Selecciona un proyecto para verlo en la Google Cloud app para dispositivos móviles de la consola de.

   Después de seleccionar un proyecto, se produce un intercambio de datos entre la app y el proyecto seleccionado Google Cloud Se crea un canal de notificaciones 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 Google Cloud console (móvil) y, luego, elige tu dispositivo móvil de la lista.

Slack

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

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

   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. En la barra de herramientas de la Google Cloud consola, elige el Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.

4. Haz clic en Editar canales de notificaciones.

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

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

6. Si el canal de Slack que deseas usar para las notificaciones es un canal privado, debes invitar manualmente a la app de Monitoring al canal:

   1. Abre Slack.

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

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

      /invite @Google Cloud Monitoring

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

Webhooks

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

• Webhooks solo admite extremos públicos. Se puede acceder a un extremo público desde Internet, por ejemplo, a través de HTTP (port:80) o HTTPS (port:443). El servicio de notificaciones debe poder establecer una conexión con el extremo y, en el caso de HTTPS, verificar el certificado de seguridad del servidor.
• Si una función de Cloud Run está configurada como extremo de webhook para un canal de notificaciones, asegúrate de que el usuario que invoca la función tenga el permiso de autenticación requerido. Para obtener más información, consulta Autentica para la invocación y Habilita el acceso a una función.
• Para enviar datos de notificaciones de Monitoring a Microsoft Teams, debes usar un servicio intermediario, como Power Automate o las funciones de Cloud Run. Configura el servicio para recibir la notificación de webhook de Monitoring convertir los datos a un formato compatible con Teams, y reenviar los datos al canal de Microsoft Teams adecuado.

Configura canales de notificaciones de Webhook

Para configurar las notificaciones de Webhooks, haz lo siguiente:

1. El controlador de webhook: Identifica la URL del extremo público para recibir los datos de webhook desde Monitoring.

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

   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. En la barra de herramientas de la Google Cloud consola, elige el Google Cloud proyecto. Para las configuraciones de App Hub, selecciona el proyecto host o el proyecto de administración de App Hub.
4. Haz clic en Editar canales de notificaciones.
5. En la sección Webhook, haz clic en Agregar nuevo.
6. Completa el cuadro de diálogo.
7. Haz clic en Probar conexión para enviar una carga útil de prueba al extremo de Webhook endpoint. Puedes ir al extremo receptor para verificar la entrega.
8. Haz clic en Guardar.

Esquema de webhook

Para ver la estructura del esquema de Webhook para Error Reporting, haz clic en lo siguiente:

Estructura del esquema, versión 1.0

{
  "version": "1.0",
  "subject": string, descripción del grupo de errores nuevo o reabierto.
  "group_info": {
    "project_id": string, proyecto al que pertenece el grupo de errores.
    "detail_link": string, vínculo a la página Detalles de Error Reporting del grupo de errores.
  },
  "exception_info": {
    "type": string, tipo de excepción registrada en el evento.
    "message": string, mensaje de excepción para el evento.
  },
  "event_info": {
    "log_message": string
    "request_method": string
    "request_url": string
    "referrer": string
    "user_agent": string
    "service": string
    "version": string
    "response_status": string
  },
}

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.

Edita y borra canales de notificaciones

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

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

   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 mediante la Google Cloud consola cuando el canal está asociado a una política de alertas. Sin embargo, puedes borrar el canal con Google Cloud CLI o la API de Cloud Monitoring. Para obtener más información, consulta Cómo crear y administrar canales de notificaciones con la API.

Selecciona canales de notificaciones a través de la Google Cloud consola de

Para seleccionar un canal de notificaciones existente, debes tener una de las siguientes funciones:

• Usuario de Error Reporting
• Administrador de Error Reporting
• Editor de proyecto
• Propietario del proyecto

Para seleccionar a dónde deseas enviar notificaciones cuando se produzcan grupos de errores nuevos, completa los siguientes pasos.

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

   Ir a Error Reporting

   También puedes usar la barra de búsqueda para encontrar esta página.

2. Haz clic en Configurar notificaciones para abrir la página Notificaciones de error.

3. En el menú desplegable Canales de notificaciones, selecciona los canales a los que deseas enviar las notificaciones.

   Si no ves el canal que necesitas, haz clic en Administrar canales de notificaciones para crear un canal nuevo. Para crear un canal de notificaciones, tu función debe ser una de las que se enumeran en Creación de canales.

4. Después de seleccionar los canales, haz clic en Guardar.

Información adicional

A continuación, se incluye información adicional que se aplica cuando se crean y administran notificaciones en Error Reporting.

Contenido de las notificaciones

Las notificaciones de los grupos de errores contienen información relacionada con las entradas de registro del grupo. La información incluida depende del tipo de recurso supervisado en el que ocurrió el evento de error. Por ejemplo, algunas notificaciones pueden contener el nombre y la versión del recurso supervisado.

Un mensaje que describe un evento de error se incluye en la notificación solo cuando el grupo de errores se identifica mediante las entradas de registro en un bucket de registros cuya región es global.

Cuándo se envían las notificaciones

Error Reporting envía una notificación en dos situaciones:

• Cuando ocurre un evento de error y no hay un grupo de errores existente.
• Cuando ocurre un evento de error para un grupo de errores existente y el estado del grupo de errores se establece en Resolved.

Para recibir notificaciones futuras del grupo de errores, debes establecer el estado del grupo de errores en Resolved. Ninguna otra acción, como usar la API para borrar el grupo de errores o esperar a que los datos venzan, genera una notificación si ocurre otro evento de error.

Límite de frecuencia de notificaciones

Error Reporting usa las siguientes reglas para limitar la cantidad de notificaciones que puedes recibir debido a eventos de error:

• Se pueden enviar como máximo 5 notificaciones por grupo de errores en un período de 60 minutos.

• Si ocurren más de 5 eventos de error en el mismo grupo de errores en un período de 60 minutos, sucede lo siguiente:

  • Recibirás una notificación de que se silenciarán más notificaciones durante las próximas seis horas.

  • Se escribe una entrada de registro con el nivel de gravedad de la advertencia.

• Cuando resuelves un grupo de errores, las notificaciones de ese grupo de errores se suspenden durante cinco minutos.

Estado de resolución

Si se produce un evento de error en un grupo de errores que tiene un estado de resolución de Resuelto, incluso si se borraron eventos de error anteriores, el estado del grupo de errores se establece en Abierto y Error Reporting envía una notificación.

Sin embargo, Error Reporting no envía notificaciones cuando se producen eventos de error y el grupo de errores correspondiente está Silenciado.

Para administrar el estado de resolución de tus grupos de errores, ve a Administra grupos de errores.

Notificaciones para dispositivos móviles

Error Reporting envía notificaciones móviles a la Google Cloud app en iOS y Android. Para habilitar las notificaciones móviles, primero debes instalar la app en tu dispositivo móvil:

Descargar la Google Cloud app