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áticas suscribiéndote a tu tema de Pub/Sub con activadores de funciones 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. Consulta 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 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 Google Cloud consola, ve a la páginaFunciones de Cloud Run.

    Ve a las funciones de Cloud Run

  2. Haz clic en Escribe una función.

  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 funciones de Cloud Run. 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 requeridas.

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

    1. Ingresa un nombre para el activador.
    2. Configura el Tipo de activador como Fuentes de Google.
    3. Configura el 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, Escalamiento de servicios, Ingreso 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 para obtener muestras de código:

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

  11. Configura el Punto de entrada de la función en la función correcta para ejecutar:

  12. Haz clic en IMPLEMENTAR.

Consulta 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 notificaciones a Pub/Sub, los suscriptores reciben los mensajes. Para probar una notificación de muestra y asegurarte de que tu función funcione como se espera, 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, revisa los siguientes ejemplos de respuestas de control de costos programáticas: