Escucha tus notificaciones de Pub/Sub

Arquitectura de referencia de ejemplo

Diagrama de un ejemplo en el que se usan notificaciones programáticas de alertas de presupuesto para automatizar una respuesta de control de costos.
Figura 1: Un ejemplo del uso de alertas de presupuesto para automatizar las respuestas de control de costos con Pub/Sub para notificaciones programáticas y funciones de Cloud Run para automatizar una respuesta.

En este documento, se explica cómo escuchar tus notificaciones de presupuesto programático suscribiéndote a tu tema de Pub/Sub con activadores de la función de Cloud Run. Sin un suscriptor, Pub/Sub descarta los mensajes publicados y no puedes recuperarlos más tarde. En este documento, aprenderás a completar las siguientes tareas:

  1. Crea una función de Cloud Run que escuche las notificaciones.
  2. Visualiza los eventos de la función de Cloud Run.
  3. Prueba una función de Cloud Run.

Antes de comenzar

Antes de comenzar, debes completar las siguientes tareas:

  1. Crea un presupuesto
  2. Configura notificaciones programáticas

Crear una Cloud Run Function

Para crear una función de Cloud Run, completa los siguientes pasos:

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

    Ve a las funciones de Cloud Run

  2. Haz clic en CREATE FUNCTION y, luego, ingresa un Nombre de la función que sea significativo para tu notificación de presupuesto.

  3. Selecciona la región en la que se ejecutarán tus funciones de Cloud Run. No puedes editar este parámetro de configuración después de implementar tu función.

  4. En Tipo de activador, selecciona Cloud Pub/Sub.

  5. Selecciona el tema de Cloud Pub/Sub que configuraste en tu buget.

  6. Edita la configuración de entorno de ejecución, compilación, conexiones y seguridad según sea necesario y, luego, haz clic en Siguiente.

  7. Escribe código con el editor intercalado o sube un archivo que le indique a tu función cómo controlar las notificaciones.

    Consulta los siguientes ejemplos para ver muestras de código:

    Para obtener más detalles sobre las notificaciones que recibirá tu código, consulta Formato de notificación.

  8. Establece el Punto de entrada en la función correcta para ejecutar:

  9. Haz clic en IMPLEMENTAR.

Visualiza los eventos de la función de Cloud Run

Después de implementar la función de Cloud Run, haz clic en REGISTROS para ver los registros de las invocaciones de tu función.

Prueba una función de Cloud Run

A medida que las notificaciones se envían a Pub/Sub, los suscriptores reciben los mensajes. Para probar una notificación de muestra y asegurarte de que tu función funciona como se esperaba, publica un mensaje en Pub/Sub con el siguiente objeto como el cuerpo del mensaje:

{
    "budgetDisplayName": "name-of-budget",
    "alertThresholdExceeded": 1.0,
    "costAmount": 100.01,
    "costIntervalStart": "2019-01-01T00:00:00Z",
    "budgetAmount": 100.00,
    "budgetAmountType": "SPECIFIED_AMOUNT",
    "currencyCode": "USD"
}

También puedes agregar atributos de mensajes, como el ID de la cuenta de facturación. Para obtener más información, consulta Formato de notificación.

¿Qué sigue?

Para obtener más información sobre cómo puedes usar las notificaciones programáticas, consulta los siguientes ejemplos de respuestas de control de costos programáticas: