Gestire le notifiche di avviso relative al budget per la pubblicità programmatica

Panoramica

Il comportamento tipico di un budget è inviare email di avviso quando regole di soglia di avviso relativo al budget attivare 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 usare notifiche programmatiche per automatizzare le risposte del controllo dei costi. Ecco alcuni esempi di risposte sul controllo dei costi:

  • Limitare la spesa per Google Cloud disattivando automaticamente la fatturazione 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 ulteriori informazioni, vedi Esempi di risposte automatiche per il 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 l'accesso all'account di fatturazione Cloud è limitato o nullo, potrebbe disporre di autorizzazioni sufficienti per i progetti di tua proprietà.

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, devi disporre di queste autorizzazioni specifiche nel ruolo personalizzato:

Per consentire a un ruolo personalizzato di modificare un budget di fatturazione Cloud esistente per collegarlo a un argomento Pub/Sub esistente, hai bisogno di queste autorizzazioni:

Se monitori i costi a livello di progetto

Se disponi di accesso limitato o nullo a un account di fatturazione Cloud, puoi gestire i budget limitati esclusivamente ai 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 Editor Pub/Sub nel progetto di destinazione che contiene gli argomenti Pub/Sub.

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, devi disporre di queste autorizzazioni specifiche nel ruolo personalizzato:

  • resourcemanager.projects.get sul tuo progetto, per visualizzare le associazioni di progetti (come l'elemento account di fatturazione) per il tuo progetto.
  • billing.resourceCosts.get nel tuo progetto (facoltativo) per visualizzare i costi e l'utilizzo.
  • billing.resourcebudgets.read nel tuo progetto per visualizzare i budget per singolo progetto di un account di fatturazione che coprono il tuo progetto.
  • billing.resourcebudgets.write nel tuo progetto per creare o modificare i budget per un singolo progetto relativi al progetto.
  • roles/pubsub.editor nel progetto di destinazione per gli argomenti Pub/Sub (per creare nuovi argomenti Pub/Sub), o pubsub.topics.list nel 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 per dominio, potresti riscontrare un errore quando provi a configurare gli argomenti Pub/Sub o a collegarli a un budget di fatturazione Cloud.

In questo caso, potrebbe essere necessario forzare l'accesso all'account per connettere un argomento Pub/Sub a un budget. Nello specifico, 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. Ripristina criteri dell'organizzazione dell'organizzazione o del progetto (facoltativo).

Informazioni sulle autorizzazioni di Google Cloud

Per ulteriori informazioni sulle autorizzazioni della fatturazione Cloud, consulta:

Per saperne di più sulle autorizzazioni per i progetti Google Cloud, consulta:

Come configurare e attivare le notifiche programmatiche Pub/Sub

Per attivare le notifiche programmatiche in modo da ricevere Pub/Sub messaggi con lo stato corrente del budget, collega un Pub/Sub al budget della fatturazione Cloud.

Per connettere, modificare o rimuovere un argomento Pub/Sub collegato al tuo budget, procedi nel seguente modo:

1. crea un argomento Pub/Sub

Configura un argomento Pub/Sub in cui la fatturazione Cloud pubblicherà 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.

    Consiglio sui progetti: ti consigliamo di creare e utilizzare un progetto Google Cloud separato per contenere tutte le tue esigenze di amministrazione della fatturazione e FinOps per un account di fatturazione Cloud, inclusi gli argomenti Pub/Sub correlati a Cloud Billing. 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 un nome per l'argomento e fai clic su Crea argomento.

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

Per connettere un budget di fatturazione Cloud a un argomento Pub/Sub, esegui la seguenti:

  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 degli account di fatturazione a cui hai accesso.

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

      Budget aperti e avvisi
    2. Al prompt, scegli l'account di fatturazione Cloud per i quali vuoi gestire i budget.

      La sezione Budget e avvisi per la fatturazione selezionata .

    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. Quindi, vai a Fatturazione: apri la console Google Cloud Navigazione menu e e poi seleziona Fatturazione.

      Se ti viene chiesto di scegliere l'account di fatturazione che vuoi 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 per la fatturazione selezionata .

    4. Nella sezione Gestione dei costi della navigazione Fatturazione , seleziona Budget e avvisi.

  2. Se necessario, crea un budget. In alternativa, per modificare un budget esistente e le regole degli avvisi, fai clic sul nome di un 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 per FinOps o l'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, specifica un nome nel campo ID argomento. 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 l'avviso relativo al budget. i dettagli.

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 all'interno della 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 nell'ultimo periodo mese di calendario.
  • "LAST_PERIODS_COST": i costi sostenuti nel corso dell'ultimo periodo, 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 esempio, 0,9 corrisponde al 90%). Questa chiave non è presente se il costo effettivo non supera alcuna soglia.
forecastThresholdExceeded 0.2 La soglia di avviso relativa al costo previsto più alta è stata superata. 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, dovresti ricevere notifiche programmatiche come descritto qui:

  • Le notifiche relative al budget vengono inviate a più argomenti Pub/Sub volte al giorno con lo stato corrente del budget. Questo è un altro maggiore rispetto alle email di avviso relative al budget, che vengono inviate solo se un budget sia stata raggiunta la soglia.
  • Le notifiche Pub/Sub vengono inviate anche se la fatturazione Cloud non utilizzato.
  • Potrebbero essere necessarie diverse ore prima di ricevere il primo Pub/Sub notifica.
  • Pub/Sub garantisce solo la consegna "at-least-once". Potresti ricevono un messaggio più volte e i messaggi potrebbero arrivare in ordine non corretto.

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

    L'invio potrebbe non andare a buon fine 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.