Gestire le notifiche di avviso di budget programmatico

Panoramica

Il comportamento tipico di un budget è inviare email di avviso quando le regole di soglia di avviso per il budget attivano una notifica via email.

Diagramma delle notifiche di avviso relativo al budget
Figura 1: illustra la funzionalità email predefinita per le notifiche di avviso del budget e il metodo facoltativo per automatizzare le risposte per il 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 metodo di notifica migliore 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 sul controllo dei costi. Ecco alcuni esempi di risposte sul controllo dei costi:

  • Limitazione della spesa di Google Cloud mediante la disattivazione automatica della fatturazione o la terminazione delle risorse.
  • Inoltro dei messaggi relativi al budget ad altri mezzi (ad es. Slack).
  • Controllo dell'utilizzo delle risorse mediante la modifica delle quote.

Per ulteriori informazioni, consulta Esempi di risposte automatiche sul controllo dei costi.

Autorizzazioni richieste per questa attività

A seconda che tu gestisca i budget a livello di account di fatturazione Cloud o se sei un proprietario del progetto senza ruoli dell'account di fatturazione Cloud, hai bisogno di 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 disporre delle autorizzazioni a livello di account di fatturazione Cloud.

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

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, hai bisogno di queste autorizzazioni specifiche nei ruoli personalizzati:

Affinché i ruoli personalizzati possano modificare un budget esistente di Fatturazione Cloud per collegarlo a un argomento Pub/Sub esistente, sono necessarie queste autorizzazioni specifiche:

Se monitori i costi a livello di progetto

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

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

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

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, hai bisogno di queste autorizzazioni specifiche nei ruoli personalizzati:

Se imposti i criteri dell'organizzazione per limitare la condivisione delle risorse in base al dominio (ad esempio, attivando enforceInTransit sugli argomenti Pub/Sub), potresti riscontrare un errore durante il tentativo di configurare gli argomenti Pub/Sub o collegarli a un budget di fatturazione Cloud.

In questa situazione, potresti dover forzare l'accesso all'account per collegare correttamente un argomento Pub/Sub a un budget. Per forzare l'accesso all'account:

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

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

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

Informazioni sulle autorizzazioni di Google Cloud

Per ulteriori informazioni sulle autorizzazioni della fatturazione Cloud, consulta:

Per ulteriori informazioni sulle autorizzazioni per i progetti Google Cloud, consulta:

Come configurare e attivare le notifiche programmatiche Pub/Sub

Per consentire alle notifiche programmatiche di ricevere messaggi Pub/Sub con lo stato corrente del budget, collega un argomento Pub/Sub al budget per la fatturazione Cloud.

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

1. crea un argomento Pub/Sub

Configura un argomento Pub/Sub in cui la fatturazione Cloud pubblichi 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 oppure puoi creare un argomento univoco per ogni budget.

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

    Accedi a Pub/Sub nella console Google Cloud

  2. Seleziona un progetto.

    Ti consigliamo di creare e utilizzare un progetto Google Cloud distinto per contenere tutte le tue esigenze di amministrazione della fatturazione e FinOps per un account di fatturazione Cloud, inclusi gli argomenti Pub/Sub correlati alla fatturazione Cloud. Scopri di più sui vantaggi dell'utilizzo di un progetto incentrato su FinOps per i casi d'uso di amministrazione della fatturazione.

  3. Fai clic su Crea argomento.

  4. Nel campo ID argomento, fornisci il nome di un argomento e fai clic su Crea argomento.

2. Collegare un budget della fatturazione Cloud a un argomento Pub/Sub

Per collegare un budget della fatturazione Cloud a un argomento Pub/Sub:

  1. Utilizzando 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 gli account di fatturazione Cloud, puoi selezionare un account dall'elenco di account di fatturazione a cui hai accesso.

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

      Apri Budget e avvisi
    2. Quando richiesto, scegli l'account di fatturazione Cloud per cui vuoi gestire i budget.

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

    Se disponi solo delle autorizzazioni per il progetto, ma non per il rispettivo account di fatturazione Cloud, devi selezionare il progetto prima di passare 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 cui vuoi gestire i budget.
    3. Poi, vai a Fatturazione: apri il menu di navigazione della console Google Cloud e 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.

      Si apre la pagina Panoramica della fatturazione relativa all'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 e le regole di avviso esistenti, fai clic su un nome del 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 riportato nella sezione precedente, si tratta del tuo progetto Google Cloud di FinOps o 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, nel campo ID argomento, fornisci un nome e fai clic su Crea argomento.
    • Una volta creato, 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 sul budget.

Attributi

Gli attributi sono coppie chiave-valore contenute in tutte le notifiche inviate da Fatturazione Cloud al tuo 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 proprietario del budget.
budgetId de72f49d-779b-4945-a127-4d6ce8def0bb L'identificatore dell'avviso relativo al budget nell'account di fatturazione Cloud.
schemaVersion 1.0 La versione dello schema delle notifiche.

Dati

Per la versione dello schema 1.x, i dettagli dell'avviso sul 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 questo momento. Si tratta del 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ò essere 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 del costo effettivo configurata più alta. Il valore è una percentuale in formato decimale (ad es.0, 9 corrisponde al 90%). Questa chiave non è presente se il costo effettivo non supera alcuna soglia.
forecastThresholdExceeded 0.2 È stata superata la soglia di avviso del costo previsto più alta. Il valore è una percentuale in formato decimale (ad es.0, 2 corrisponde al 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 recapito 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 di seguito:

  • Le notifiche relative al budget vengono inviate all'argomento Pub/Sub più volte al giorno con lo stato corrente 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 fatturazione Cloud non ha alcun utilizzo.
  • Potrebbero essere necessarie diverse ore prima di ricevere la prima notifica Pub/Sub.
  • Pub/Sub garantisce solo la consegna "at-least-once". Potresti ricevere un messaggio più volte e i messaggi potrebbero arrivare fuori sequenza.

  • Se l'invio non va a buon fine a causa di una configurazione errata dell'argomento Pub/Sub, non riceverai una notifica.

    L'invio potrebbe non andare a buon fine per uno dei seguenti motivi: