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 relativo al budget e il metodo facoltativo per automatizzare i costi controllare le risposte utilizzando Pub/Sub per le notifiche programmatiche.

Tuttavia, se utilizzi i budget come strumento per il controllo dei costi, puoi ricevere notifiche via email potrebbe non essere il metodo di notifica migliore da usare per garantire un'azione tempestiva i costi di Google Cloud. Oltre alle notifiche via email, puoi usare notifiche programmatiche per automatizzare le risposte del controllo dei costi. Esempi delle risposte al controllo dei costi include:

  • 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 o meno i budget nell'account di a livello di account o sei proprietario di un progetto senza fatturazione Cloud ai ruoli dell'account, è necessario un insieme di autorizzazioni diverso, descritto nella sezione le 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, sono necessari questi 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 all'ambito solo ai progetti di tua proprietà.

  • Per creare, modificare o visualizzare i budget per il tuo progetto, devi disporre di una delle seguenti opzioni: i seguenti ruoli sul progetto:

  • Per impostare o modificare gli argomenti Pub/Sub, è necessario Ruolo di Editor Pub/Sub nel progetto di destinazione che contiene gli argomenti Pub/Sub.

Se la tua organizzazione utilizza ruoli personalizzati per l'autenticazione, sono necessari questi 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 sul tuo progetto (facoltativo) per visualizzare i costi e l'utilizzo del progetto.
  • billing.resourcebudgets.read sul tuo progetto, per visualizzare i budget per singoli progetti di un account di fatturazione hanno come ambito il tuo progetto.
  • billing.resourcebudgets.write sul tuo progetto, per creare o modificare i budget di progetto singolo che con ambito a livello di 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 il Pub/Sub esistente gli argomenti che vuoi utilizzare.

Se hai impostato criteri dell'organizzazione a limitare la condivisione delle risorse in base al dominio, potresti riscontrare un errore quando tenti di configurare argomenti Pub/Sub o connetterle 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. In particolare, per forzare l'accesso all'account, procedi nel seguente modo:

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

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

  3. Ripristina criteri dell'organizzazione dell'organizzazione o del progetto (facoltativo).

Informazioni sulle autorizzazioni di Google Cloud

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

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

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 Fatturazione Cloud per pubblicare gli avvisi relativi al budget. Se dispone già di un argomento Pub/Sub per i budget di fatturazione Cloud configurato, puoi riutilizzarlo per tutti i budget o creare un argomento unico in base al budget.

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

    Accedi alla console Google Cloud Pub/Sub

  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 connettere un budget di fatturazione Cloud a un argomento Pub/Sub, esegui la seguenti:

  1. Utilizzando la procedura adatta al tuo livello di accesso Account di fatturazione Cloud, accedi alla scheda Budget e pagina Avvisi Nella sezione Fatturazione della console Google Cloud:

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

    Se disponi delle autorizzazioni per l'account di fatturazione Cloud, puoi scegliere da un elenco di account di fatturazione per i quali disponi delle autorizzazioni l'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 ne hai nessuna all'account di fatturazione Cloud del progetto, devi selezionare 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. 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 da visualizzare e gestisci, 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 segui consiglio nel sezione precedente, questo è il tuo progetto Google Cloud per l'amministrazione della fatturazione.

  5. In Seleziona un argomento Pub/Sub, seleziona un argomento esistente, oppure 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.
    • 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 l'avviso relativo al budget. i dettagli.
di Gemini Advanced.

Attributi

Gli attributi sono coppie chiave-valore contenute in tutte le notifiche inviate dalla 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 della 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 un formato con codifica Base64 Stringa UTF-8 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 ora. Questo è il primo giorno del periodo di tempo del budget. (mese, trimestre, anno o un intervallo di date personalizzato) durante il quale il budget è stato utilizzato.
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 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 La soglia di avviso sul costo effettivo configurato più alta è stata superata. Il valore è un 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 esempio, 0,2 è il 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 inclusi in questo valuta.

Garanzie di consegna per le notifiche a Pub/Sub

Dopo aver creato un budget e averlo collegato a un argomento Pub/Sub, puoi 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. Si tratta di un metodo 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.

    La consegna potrebbe non riuscire per uno dei seguenti motivi:

    • L'argomento Pub/Sub non esiste più.
    • La fatturazione Cloud non è più autorizzata a pubblicare in Pub/Sub.
    • Hai superato la quota di notifiche.