Escuchar tus notificaciones de Pub/Sub

Arquitectura de referencia de ejemplo

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

En este documento se explica cómo recibir notificaciones de tu presupuesto programático suscribiéndote a tu tema de Pub/Sub con activadores de función de Cloud Run. Si no hay ningún suscriptor, Pub/Sub descartará los mensajes publicados y no podrás recuperarlos más adelante. En este documento, aprenderás a completar las siguientes tareas:

  1. Crea una función de Cloud Run que detecte las notificaciones.
  2. Ver eventos de funciones de Cloud Run.
  3. Prueba una función de Cloud Run.

Antes de empezar

Antes de empezar, debes completar las siguientes tareas:

  1. Crear un presupuesto
  2. Configurar notificaciones programáticas

Crear una función de Cloud Run

Para crear una función de Cloud Run, sigue estos pasos:

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

    Ir a Cloud Run Functions

  2. Haz clic en CREAR SERVICIO.

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

  4. Introduce un Nombre del servicio que te resulte significativo para la notificación de presupuesto.

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

  6. Haga clic en Añadir activador y seleccione Cloud Pub/Sub.

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

  8. En el panel Eventarc trigger (Activador de Eventarc), sigue estos pasos:

    1. Escribe un nombre del activador.
    2. Selecciona Fuentes de Google como Tipo de activador.
    3. En Proveedor de eventos, selecciona Cloud Pub/Sub.
    4. Selecciona el tema de Cloud Pub/Sub que hayas configurado en tu presupuesto.
    5. Selecciona una región.
    6. Haz clic en Guardar activador.

  9. Edita los ajustes de Identity-Aware Proxy, Facturación, Escalado de servicios, Ingreso y Contenedores, volumen, redes y seguridad según sea necesario y, a continuación, haz clic en Crear.

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

    Consulta los siguientes ejemplos de código:

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

  11. Define Función de punto de entrada en la función correcta que se va a ejecutar:

  12. Haz clic en DESPLEGAR.

Ver eventos de funciones de Cloud Run

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

Probar una función de Cloud Run

Cuando se envían notificaciones a Pub/Sub, los suscriptores reciben los mensajes. Para probar una notificación de ejemplo y asegurarte de que tu función funciona correctamente, publica un mensaje en Pub/Sub con el siguiente objeto como 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 puede añadir atributos de mensaje, como el ID de la cuenta de facturación. Para obtener más información, consulta el artículo sobre el formato de las notificaciones.

Siguientes pasos

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