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 di 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 del budget programmatiche sottoscrivendo l'argomento Pub/Sub con i trigger delle funzioni Cloud Run. Senza un sottoscrittore, Pub/Sub elimina i messaggi pubblicati e non puoi recuperarli in un secondo momento. In questo documento, scoprirai come completare le seguenti attività:

  1. Crea una funzione Cloud Run che ascolti 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. Crea un budget
  2. Configura 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 Scrivi una funzione.

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

  4. Inserisci un Nome servizio che sia 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 trigger e seleziona Cloud Pub/Sub.

  7. Se richiesto, attiva le API richieste.

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

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

  9. Modifica le impostazioni Identity-Aware Proxy, Fatturazione, Scalabilità del servizio, Ingresso e Container, volume, networking, sicurezza in base alle esigenze, quindi fai clic su Crea.

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

    Per esempi di codice, consulta i seguenti esempi:

    Per dettagli sulle notifiche che il codice riceverà, consulta Formato delle notifiche.

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

  12. Fai clic su ESEGUI IL DEPLOYMENT.

Visualizza 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 di funzione.

Testa 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 del messaggio, ad esempio l'ID account di fatturazione. Per ulteriori informazioni, consulta Formato delle notifiche.

Passaggi successivi

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