Ascoltare le notifiche Pub/Sub

Architettura di riferimento di esempio

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

Questo documento spiega come ascoltare le notifiche di budget programmatico sottoscrivendo un argomento Pub/Sub con trigger di 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 rimane in ascolto delle notifiche.
  2. Visualizza gli eventi della funzione 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

Crea una funzione Cloud Run

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

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

    Vai alle funzioni Cloud Run

  2. Fai clic su CREA SERVIZIO.

  3. Seleziona Usa un editor in linea per creare una funzione.

  4. Inserisci un Nome servizio significativo per la notifica del budget.

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

  6. Fai clic su Aggiungi attivatore e seleziona Cloud Pub/Sub.

  7. Se richiesto, abilita le API necessarie.

  8. Nel riquadro Trigger Eventarc, completa i seguenti passaggi:

    1. Inserisci un nome trigger.
    2. Imposta Tipo di trigger su Origini Google.
    3. Imposta Fornitore di eventi su Cloud Pub/Sub.
    4. Seleziona l'argomento Cloud Pub/Sub che hai configurato nel tuo budget.
    5. Seleziona una Regione.
    6. Fai clic su Salva trigger.

  9. Modifica le impostazioni di Identity-Aware Proxy, Fatturazione, Scalabilità del servizio, Ingress e Container, Volume, Networking, Sicurezza in base alle tue esigenze, poi fai clic su Crea.

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

    Vedi i seguenti esempi per i campioni di codice:

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

  11. Imposta Entry point della funzione sulla funzione corretta da eseguire:

  12. Fai clic su DEPLOY.

Visualizza gli eventi della funzione Cloud Run

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

Testare una funzione Cloud Run

Man mano che le notifiche vengono inviate a Pub/Sub, gli iscritti 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 del messaggio come l'ID account di fatturazione. Per maggiori informazioni, vedi Formato delle notifiche.

Passaggi successivi

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