Ascoltare le notifiche Pub/Sub

Architettura di riferimento di esempio

Diagramma di un esempio che utilizza le notifiche programmatiche di avviso budget per automatizzare una risposta di controllo dei costi.
Figura 1: un esempio di utilizzo degli avvisi budget per automatizzare le risposte al controllo dei costi utilizzando Pub/Sub per le notifiche programmatiche e le funzioni Cloud Run per automatizzare una risposta.

Questo documento spiega come ascoltare le notifiche di budget programmatiche abbonandoti all'argomento Pub/Sub con gli attivatori della funzione Cloud Run. Senza un sottoscrittore, Pub/Sub elimina i messaggi pubblicati e non puoi recuperarli in un secondo momento. In questo documento imparerai a completare le seguenti attività:

  1. Crea una funzione Cloud Run che riceva le notifiche.
  2. Visualizza gli eventi delle funzioni Cloud Run.
  3. Testa una funzione Cloud Run.

Prima di iniziare

Prima di iniziare, devi completare le seguenti attività:

  1. Creare un budget
  2. Configurare le notifiche programmatiche

Creare una funzione Cloud Run

Per creare una funzione Cloud Run, completa i seguenti passaggi:

  1. Nella console Google Cloud, vai alla pagina Funzioni Cloud Run.

    Vai alle funzioni Cloud Run

  2. Fai clic su CREA FUNZIONE e inserisci un nome funzione significativo per la notifica del budget.

  3. Seleziona la regione in cui verranno eseguite le funzioni Cloud Run. Non puoi modificare questa impostazione dopo aver eseguito il deployment della funzione.

  4. Per Tipo di trigger, seleziona Cloud Pub/Sub.

  5. Seleziona l'argomento Cloud Pub/Sub che hai configurato nel bilancio.

  6. Modifica le impostazioni di runtime, build, connessioni e sicurezza come necessario, poi fai clic su Avanti.

  7. Scrivi il codice utilizzando l'editor in linea o carica un file che indichi alla funzione come gestire le notifiche.

    Per esempi di codice, consulta gli esempi riportati di seguito:

    Per informazioni dettagliate sulle notifiche che riceverà il tuo codice, consulta Formato delle notifiche.

  8. Imposta Punto di ingresso sulla funzione corretta da eseguire:

  9. Fai clic su ESEGUI IL ROLLOUT.

Visualizzare gli eventi delle funzioni Cloud Run

Dopo aver eseguito il deployment della funzione Cloud Run, fai clic su LOG per visualizzare i log delle chiamate della funzione.

Testare una funzione Cloud Run

Quando le notifiche vengono inviate a Pub/Sub, i sottoscrittori ricevono i messaggi. Per testare una notifica di esempio e assicurarti che la funzione funzioni come previsto, pubblica un messaggio in Pub/Sub con il seguente oggetto come corpo del messaggio:

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

Puoi anche aggiungere attributi dei messaggi, come l'ID account di fatturazione. Per ulteriori informazioni, consulta la sezione Formato della notifica.

Passaggi successivi

Per scoprire di più su come utilizzare le notifiche programmatiche, consulta i seguenti esempi di risposte programmatiche per il controllo dei costi: