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: 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 a fin de automatizar una respuesta.

En este documento, se explica cómo escuchar las notificaciones de tu presupuesto programático suscribiéndote a tu tema de Pub/Sub con activadores de 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 detecte las notificaciones.
  2. Visualiza los eventos de la función de Cloud Run.
  3. Probar una Cloud Run Function

Antes de comenzar

Antes de comenzar, debes completar las siguientes tareas:

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

Crea una función de Cloud Run

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

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

    Ve a las funciones de Cloud Run

  2. Haz clic en CREAR SERVICIO.

  3. Selecciona Usar un editor directo para crear una función.

  4. Ingresa un Nombre del servicio que sea significativo para tu notificación de presupuesto.

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

  6. Haz clic en Agregar activador y selecciona Cloud Pub/Sub.

  7. Si se te solicita, habilita las APIs necesarias.

  8. En el panel Activador de Eventarc, completa los siguientes pasos:

    1. Ingresa un nombre para el activador.
    2. Establece Tipo de activador en Fuentes de Google.
    3. Configura Proveedor de eventos como Cloud Pub/Sub.
    4. Selecciona el tema de Cloud Pub/Sub que configuraste en tu presupuesto.
    5. Selecciona una Región.
    6. Haz clic en Guardar activador.

  9. Edita la configuración de Identity-Aware Proxy, Facturación, Escalado de servicios, Ingress y Contenedores, volúmenes, Herramientas de redes y seguridad según sea necesario y, luego, haz clic en Crear.

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

    Consulta los siguientes ejemplos de muestras de código:

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

  11. Establece Punto de entrada de la función en la función correcta que se ejecutará:

  12. 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 se envían las notificaciones 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 programáticas de control de costos: