Gestire le notifiche di avviso relative al budget programmatico

Panoramica

Il comportamento tipico di un budget è l'invio di email di avviso quando le regole di soglia di avviso del budget attivano una notifica via email.

Diagramma delle notifiche di avviso relative al budget
Figura 1: illustra la funzionalità email predefinita per le notifiche di avviso relative al budget e il metodo facoltativo per automatizzare le risposte al controllo dei costi utilizzando Pub/Sub per le notifiche programmatiche.

Tuttavia, se utilizzi i budget come strumento di controllo dei costi, le notifiche via email potrebbero non essere il miglior metodo di notifica da utilizzare per garantire un'azione tempestiva per controllare i costi di Google Cloud. Oltre alle notifiche via email, puoi utilizzare le notifiche programmatiche per automatizzare le risposte al controllo dei costi. Ecco alcuni esempi di risposte al controllo dei costi:

  • Limitare la spesa Google Cloud disattivando automaticamente la fatturazione o terminando le risorse.
  • Inoltro dei messaggi relativi al budget ad altri mezzi (ad es. Slack).
  • Limitazione dell'utilizzo delle risorse mediante la modifica delle quote.

Per saperne di più, consulta Esempi di risposte automatiche al controllo dei costi.

Autorizzazioni richieste per questa attività

A seconda che tu stia gestendo i budget a livello di account di fatturazione Cloud o sia il proprietario di un progetto senza ruoli dell'account di fatturazione Cloud, è necessario un insieme diverso di autorizzazioni, descritto nelle sezioni seguenti.

Se monitori i costi a livello di account di fatturazione

Se monitori principalmente i costi per il tuo account di fatturazione Cloud, devi avere le autorizzazioni a livello di account di fatturazione Cloud.

Se l'accesso all'account di fatturazione Cloud è limitato o nullo, potresti disporre di autorizzazioni sufficienti per i progetti di tua proprietà.

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, nel ruolo personalizzato sono necessarie le seguenti autorizzazioni specifiche:

Affinché un ruolo personalizzato possa modificare un budget di fatturazione Cloud esistente per collegarlo a un argomento Pub/Sub esistente, devi disporre di queste autorizzazioni specifiche:

Se monitori i costi a livello di progetto

Se l'accesso a un account di fatturazione Cloud è limitato o nullo, puoi gestire budget che hanno come ambito solo i progetti di tua proprietà.

  • Per creare, modificare o visualizzare i budget per il progetto, devi disporre di uno dei seguenti ruoli nel progetto:

  • Per impostare o modificare gli argomenti Pub/Sub, devi disporre del ruolo Editor Pub/Sub nel progetto di destinazione che contiene gli argomenti Pub/Sub.

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, nel ruolo personalizzato sono necessarie le seguenti autorizzazioni specifiche:

  • resourcemanager.projects.get sul progetto per visualizzare le associazioni di progetti (come l'account di fatturazione collegato) per il progetto.
  • billing.resourceCosts.get sul progetto (facoltativo) per visualizzare i costi e l'utilizzo.
  • billing.resourcebudgets.read nel progetto, per visualizzare i budget di un single-project di un account di fatturazione che hanno come ambito il tuo progetto.
  • billing.resourcebudgets.write sul progetto per creare o modificare budget di single-project con ambito a livello di progetto.
  • roles/pubsub.editor nel progetto di destinazione per gli argomenti Pub/Sub (per creare nuovi argomenti Pub/Sub) oppure pubsub.topics.list sul progetto di destinazione che contiene gli argomenti Pub/Sub esistenti che vuoi utilizzare.

Se hai impostato i criteri dell'organizzazione per limitare la condivisione delle risorse in base al dominio, potresti riscontrare un errore quando cerchi di configurare gli argomenti Pub/Sub o di collegarli a un budget di fatturazione Cloud.

In questo caso, potrebbe essere necessario forzare l'accesso all'account per collegare un argomento Pub/Sub a un budget. In particolare, per forzare l'accesso all'account:

  1. Rimuovi il criterio dell'organizzazione contenente il vincolo di limitazione del dominio utilizzando uno dei seguenti metodi:

  2. Segui i passaggi per collegare un argomento Pub/Sub a un budget di fatturazione Cloud.

  3. (Facoltativo) Ripristina il criterio dell'organizzazione per l'organizzazione o il progetto.

Informazioni sulle autorizzazioni di Google Cloud

Per ulteriori informazioni sulle autorizzazioni per la fatturazione Cloud, vedi:

Per ulteriori informazioni sulle autorizzazioni dei progetti Google Cloud, vedi:

Come configurare e attivare le notifiche programmatiche Pub/Sub

Per abilitare le notifiche programmatiche per ricevere messaggi Pub/Sub con lo stato attuale del budget, collega un argomento Pub/Sub al tuo budget di fatturazione Cloud.

Per collegare, modificare o rimuovere un argomento Pub/Sub collegato al budget, segui questi passaggi:

1. crea un argomento Pub/Sub

Configura un argomento Pub/Sub per la fatturazione Cloud in cui pubblicare gli avvisi relativi al budget. Se hai già configurato un argomento Pub/Sub per i budget di fatturazione Cloud, puoi riutilizzarlo per tutti i budget o creare un argomento unico per budget.

  1. Vai alla pagina Pub/Sub della console Google Cloud.

    Accedi a Pub/Sub della console Google Cloud

  2. Seleziona un progetto.

  3. Fai clic su Crea argomento.

  4. Nel campo ID argomento, fornisci un nome per l'argomento e fai clic su Crea argomento.

2. Collega un budget di fatturazione Cloud a un argomento Pub/Sub

Per collegare un budget di fatturazione Cloud a un argomento Pub/Sub, segui questi passaggi:

  1. Utilizza la procedura adatta al tuo livello di accesso agli account di fatturazione Cloud, accedi alla pagina Budget e avvisi nella sezione Fatturazione della console Google Cloud:

    Utenti con autorizzazioni per l'account di fatturazione Cloud Utenti con autorizzazioni solo a livello di progetto (Anteprima)

    Se disponi delle autorizzazioni per l'account di fatturazione Cloud, puoi selezionare da un elenco di account di fatturazione a cui hai le autorizzazioni di accesso.

    1. Accedi alla pagina Budget e avvisi nella console Google Cloud.

      Apri budget e avvisi
    2. Al prompt, scegli l'account di fatturazione Cloud per il quale vuoi gestire i budget.

      Si apre la pagina Budget e avvisi per l'account di fatturazione selezionato.

    Se disponi solo delle autorizzazioni del progetto, ma non ne hai nessuna sull'account di fatturazione Cloud del progetto, devi selezionare il progetto prima di accedere alla sezione Fatturazione.

    1. Accedi alla dashboard della console Google Cloud e seleziona un progetto.

      Apri la console Google Cloud
    2. Seleziona il progetto per il quale vuoi gestire i budget.
    3. Poi, vai a Fatturazione: apri il menu di navigazione della console Google Cloud e poi seleziona Fatturazione.

      Se ti viene chiesto di scegliere l'account di fatturazione da visualizzare e gestire, fai clic su Vai all'account di fatturazione collegato per visualizzare l'account di fatturazione collegato al progetto selezionato.

      Viene visualizzata la pagina Panoramica della fatturazione per l'account di fatturazione selezionato.

    4. Nella sezione Gestione dei costi del menu di navigazione Fatturazione, seleziona Budget e avvisi.

  2. Se necessario, crea un budget. In alternativa, per modificare un budget esistente e le regole di avviso, fai clic su un nome budget.

  3. Nella sezione Azioni, in Gestisci notifiche, seleziona Collega un argomento Pub/Sub a questo budget.

  4. Nel campo Progetto, fai clic su Seleziona un progetto e scegli il progetto che contiene gli argomenti Pub/Sub che hai configurato. Se hai seguito il consiglio nella sezione precedente, questo è il tuo progetto Google Cloud di amministrazione della fatturazione.

  5. In Seleziona un argomento Pub/Sub, seleziona un argomento esistente o crea un nuovo argomento selezionando Crea un argomento.

    • Se crei un nuovo argomento, fornisci un nome per l'argomento nel campo ID argomento e fai clic su Crea argomento.
    • Dopo la creazione, l'argomento verrà selezionato.

  6. Fai clic su Salva.

Formato delle notifiche

Le notifiche inviate all'argomento Pub/Sub sono composte da due parti:

  • Attributi: un insieme di coppie chiave-valore che descrivono l'evento.
  • Dati: una stringa contenente un oggetto JSON che descrive i dettagli dell'avviso relativo al budget.

Attributi

Gli attributi sono coppie chiave-valore contenute in tutte le notifiche inviate dal fatturazione Cloud all'argomento Pub/Sub. Le notifiche contengono sempre il seguente insieme di coppie chiave/valore, indipendentemente dal payload delle notifiche.

Nome dell'attributo Esempio Descrizione
billingAccountId 01D4EE-079462-DFD6EC L'identificatore dell'account di fatturazione Cloud a cui appartiene il budget.
budgetId de72f49d-779b-4945-a127-4d6ce8def0bb L'identificatore dell'avviso relativo al budget all'interno dell'account di fatturazione Cloud.
schemaVersion 1.0 La versione dello schema delle notifiche.

Dati

Per la versione 1.x dello schema, i dettagli degli avvisi relativi al budget vengono restituiti in una stringa UTF-8 con codifica base64 contenente un oggetto JSON con le seguenti proprietà:

Dati Esempio Descrizione
budgetDisplayName "My Personal Budget" Il nome leggibile assegnato al budget.
costAmount 140.321 L'importo dei costi maturati. Il tipo di costi monitorati dipende dai filtri e dalle impostazioni del budget.
costIntervalStart "2021-02-01T08:00:00Z" L'inizio del periodo di avviso relativo al budget. "costAmount" include i costi per l'utilizzo a partire da questa data. È il primo giorno del periodo di tempo del budget (mese, trimestre, anno o un intervallo di date personalizzato) durante il quale si è verificato l'utilizzo del budget.
budgetAmount 152.557 L'importo stanziato nel budget.
budgetAmountType "SPECIFIED_AMOUNT" Il tipo di importo del budget. Può trattarsi di uno dei seguenti valori:
  • "SPECIFIED_AMOUNT": un importo fisso.
  • "LAST_MONTH_COST": costi totali sostenuti durante l'ultimo mese di calendario.
  • "LAST_PERIODS_COST": i costi sostenuti durante l'ultimo periodo di calendario non mensile, ad esempio un trimestre o un anno.
alertThresholdExceeded 0.9 È stata superata la soglia di avviso per i costi effettivi configurati più alta. Il valore è una percentuale in formato decimale (ad esempio, 0,9 è 90%). Questa chiave non è presente se il costo effettivo non supera alcuna soglia.
forecastThresholdExceeded 0.2 È stata superata la soglia di avviso più alta relativa ai costi previsti. Il valore è una percentuale in formato decimale (ad esempio, 0,2 è 20%). Questa chiave non è presente se il costo previsto non supera alcuna soglia.
currencyCode "USD" La valuta dell'avviso relativo al budget. Tutti i costi e gli importi degli avvisi relativi al budget sono in questa valuta.

Garanzie di consegna per le notifiche a Pub/Sub

Dopo aver creato un budget e averlo collegato a un argomento Pub/Sub, puoi aspettarti di ricevere notifiche programmatiche come descritto qui:

  • Le notifiche di budget vengono inviate all'argomento Pub/Sub più volte al giorno con lo stato attuale del budget. Si tratta di una frequenza diversa rispetto alle email di avviso relative al budget, che vengono inviate solo quando viene raggiunta una soglia di budget.
  • Le notifiche Pub/Sub vengono inviate anche se l'account di fatturazione Cloud non ha alcun utilizzo.
  • Potrebbero essere necessarie diverse ore prima di ricevere la prima notifica Pub/Sub.
  • Pub/Sub garantisce solo la distribuzione "at-least-once". Potresti ricevere un messaggio più volte e i messaggi non arrivano nell'ordine corretto.

  • Se la consegna non va a buon fine a causa di un errore di configurazione dell'argomento Pub/Sub, non riceverai una notifica.

    La pubblicazione potrebbe non riuscire per uno dei seguenti motivi:

    • L'argomento Pub/Sub non esiste più.
    • La fatturazione Cloud non è più autorizzata a pubblicare nell'argomento Pub/Sub.
    • Hai superato la quota di notifiche.
Avanti
Esempi di controlli dei costi automatici con notifiche del budget