Struttura dell'esportazione dei dati dettagliati

Questo documento fornisce informazioni di riferimento per lo schema dei dati di costo di utilizzo dettagliato di fatturazione Cloud esportati in ogni tabella di BigQuery.

I dati di costo di utilizzo dettagliati forniscono tutte le informazioni incluse nei dati di costo standard di utilizzo, insieme a campi aggiuntivi che forniscono un costo granulare a livello di risorsa, come una macchina virtuale o un'unità SSD che genera l'utilizzo. L'esportazione dettagliata include informazioni granulari sui costi dei seguenti servizi:

  • AlloyDB per PostgreSQL
  • App Engine
  • BigQuery
  • Bigtable
  • Cloud Data Fusion
  • Cloud Deploy
  • Cloud Run Functions
  • Cloud Logging
  • Cloud Run
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Metastore di Managed Service for Apache Spark
  • Firestore e Datastore
  • Google Kubernetes Engine (GKE)
    Per visualizzare un'analisi dettagliata dei costi dei cluster GKE in un'esportazione dei dati dettagliata, devi anche abilitare l'allocazione dei costi per GKE.
  • Microsoft Active Directory gestito
  • Memorystore for Redis
  • Secret Manager
  • Spanner

Identifica i dati di costo granulari per servizio

Per analizzare informazioni granulari sui costi in un'esportazione dettagliata, utilizza la tabella seguente per identificare la colonna che contiene informazioni su risorse specifiche.

Descrizione servizio Colonna Come identificare le risorse
AlloyDB per PostgreSQL service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

App Engine service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

BigQuery service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Bigtable service.description e resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud Data Fusion service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud Deploy service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud Run Functions service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud Logging service.description e resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud Run service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Cloud SQL service.description e resource.global_name

La colonna service.description contiene il nome del servizio, mentre la colonna resource.global_name contiene un identificatore univoco della risorsa.

Cloud Storage service.description e resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Compute Engine service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Dataflow service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Metastore di Managed Service for Apache Spark service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Firestore e Datastore service.description e resource.name o resource.global_name

La colonna service.description sarà App Engine. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Google Kubernetes Engine (GKE) labels.key

Utilizza le seguenti chiavi di etichetta per filtrare le risorse:

  • goog-fleet-project: filtra le risorse del cluster in base al progetto host del parco risorse, se il cluster è registrato in un parco risorse.
  • goog-k8s-cluster-location: filtra le risorse GKE per località.
  • goog-k8s-cluster-name: filtra le risorse GKE per cluster.
  • goog-k8s-node-pool-name: filtra le risorse del cluster per pool di nodi.
  • k8s-namespace: filtra le risorse GKE per spazio dei nomi.
  • k8s-namespace-labels: filtra le risorse GKE in base all'etichetta dello spazio dei nomi del parco risorse.
  • k8s-workload-name: filtra le risorse del cluster in base al nome del workload Kubernetes, ad esempio un deployment, un StatefulSet, un DaemonSet, un ReplicaSet, un job o un CronJob.
  • k8s-workload-type: filtra le risorse del cluster in base al tipo di workload Kubernetes e alla relativa versione dell'API, ad esempio apps/v1-Deployment o batch/v1-Job.
  • k8s-label: visualizza tutte le tue risorse GKE.

Per visualizzare i costi granulari dei cluster GKE nell'esportazione dei dati di costo dettagliati, devi anche abilitare l'allocazione dei costi per GKE.

Consulta le query di esempio per filtrare i dati GKE nelle esportazioni BigQuery.

Microsoft Active Directory gestito service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Memorystore for Redis service.description e resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Pub/Sub service.description e resource.name o resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Secret Manager service.description, resource.name e resource.global_name

La colonna service.description contiene il nome del servizio. La colonna resource.name contiene il nome fornito dall'utente. La colonna resource.global_name contiene un identificatore univoco per la risorsa.

Spanner service.description e resource.global_name

La colonna service.description contiene il nome del servizio, mentre la colonna resource.global_name contiene un identificatore univoco della risorsa.

Consulta gli esempi di query su dati granulari per le tue risorse.

Schema dei dati di costo di utilizzo dettagliati

Nel set di dati BigQuery, i dati dettagliati sui costi di utilizzo di Google Cloud vengono caricati in una tabella di dati denominata gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Quando utilizzi i dati di costo di utilizzo dettagliati in BigQuery, tieni presente quanto segue:

  • Lo schema della tabella per l'esportazione dei dati di fatturazione Cloud dettagliati può cambiare nel tempo, ad esempio quando vengono aggiunti nuovi campi all'esportazione dettagliata. Per proteggere le query da future modifiche allo schema, anziché fare affidamento su query che fanno riferimento direttamente alle colonne esportate, ti consigliamo di utilizzare le viste BigQuery per normalizzare i dati in modo che la tabella presenti lo stesso schema alle query. Scopri di più su questa limitazione.
  • Quando selezioni o crei un set di dati BigQuery per i tuoi dati di costo di utilizzo dettagliati, puoi selezionare qualsiasi località del set di dati supportata per l'utilizzo con i dati di fatturazione Cloud.
  • Quando abiliti l'esportazione dei dati di costo di utilizzo dettagliato per la prima volta nella fatturazione Cloud, se selezioni un set di dati configurato per l'utilizzo di una località multiregionale (UE o Stati Uniti), i dati di fatturazione Cloud saranno disponibili retroattivamente dall'inizio del mese precedente. I dati vengono esportati in ordine cronologico. Per il backfill iniziale dei dati esportati, potrebbero essere necessari fino a cinque giorni per completare l'esportazione dei dati di fatturazione Cloud retroattivi prima di iniziare a visualizzare i dati di utilizzo più recenti.
  • Se abiliti l'esportazione dei dati di costo di utilizzo dettagliati e selezioni un set di dati configurato per l'utilizzo di una regione supportata, i dati di fatturazione Cloud saranno disponibili a partire dalla data in cui hai abilitato l'esportazione.
  • Se hai abilitato, disabilitato e successivamente riabilitato l'esportazione dei dati di costo di utilizzo dettagliati, i dati di fatturazione Cloud potrebbero non essere disponibili per il periodo in cui l'esportazione dei dati è stata disabilitata esplicitamente.
  • Scopri di più sulla frequenza dei caricamenti dei dati nelle tabelle BigQuery.
  • Consulta altre limitazioni che potrebbero influire sull'esportazione dei dati di fatturazione in BigQuery, ad esempio i set di dati con chiavi di crittografia gestite dal cliente (CMEK) abilitate.
  • Considera il volume di dati aggiuntivo di cui potrebbero aver bisogno le tue tabelle BigQuery e il costo aggiuntivo quando attivi l'esportazione dei dati di costo di utilizzo dettagliati anziché dei dati di costo di utilizzo standard. La maggiore granularità delle informazioni a livello di risorsa può aumentare il numero di righe, che vengono aggregate nel formato Costo di utilizzo standard. Ti consigliamo di consultare la pagina Controlla i costi in BigQuery per ulteriori best practice sulla gestione dei costi di BigQuery.
Campo Tipo Descrizione
billing_account_id Stringa

L'ID account di fatturazione Cloud a cui è associato l'utilizzo.

Per i rivenditori: per i costi di utilizzo generati da un subaccount di fatturazione Cloud, questo è l'ID del subaccount, non l'ID dell'account di fatturazione Cloud rivenditore principale.

invoice.month Stringa

L'anno e il mese (AAAAMM) della fattura che include le voci di costo. Ad esempio: "201901" equivale a gennaio 2019.

Puoi utilizzare questo campo per ottenere gli addebiti totali della fattura. Consulta gli esempi di query per l'esportazione della fatturazione Cloud in BigQuery.

invoice.publisher_type Stringa

Indica il publisher associato alla transazione. Questo campo supporta la suddivisione delle fatture tra le transazioni effettuate direttamente con Google (proprietarie) e quelle effettuate con un partner (di terze parti), il che indica anche quali normative potrebbero essere applicate alla transazione.

I valori possibili sono:
  • GOOGLE: transazione proprietaria non regolamentata di Google Cloud.
  • PARTNER: una transazione di terze parti, regolamentata o non regolamentata, effettuata da un partner.
cost_type Stringa

Il tipo di costo rappresentato da questa voce: standard, imposta, aggiustamento o errore di arrotondamento.

service.id Stringa L'ID del servizio a cui è associato l'utilizzo.
service.description Stringa Il servizio Google Cloud che ha segnalato i dati di fatturazione Cloud.
sku.id Stringa L'ID della risorsa utilizzata dal servizio. Per l'elenco completo degli SKU, consulta SKU diGoogle Cloud .
sku.description Stringa Una descrizione del tipo di risorsa utilizzata dal servizio. Ad esempio, un tipo di risorsa per Cloud Storage è Standard Storage US.
usage_start_time Timestamp L'ora di inizio della finestra di utilizzo orario entro la quale è stato calcolato il costo specificato. L'utilizzo e i costi di tutti i servizi vengono visualizzati con granularità oraria, il che significa che l'utilizzo dei servizi a lunga esecuzione è distribuito su più finestre orarie.

Per saperne di più, consulta la documentazione di BigQuery sui tipi di dati timestamp. Consulta anche Differenze tra dati esportati e fatture.

usage_end_time Timestamp L'ora di fine della finestra di utilizzo orario entro la quale è stato calcolato il costo specificato. L'utilizzo e i costi di tutti i servizi vengono visualizzati con granularità oraria, il che significa che l'utilizzo dei servizi a lunga esecuzione è distribuito su più finestre orarie.

Per saperne di più, consulta la documentazione di BigQuery sui tipi di dati timestamp. Consulta anche Differenze tra dati esportati e fatture.

project Struct project contiene campi che descrivono il progetto di fatturazione Cloud, ad esempio ID, numero, nome, ancestry_numbers ed etichette.
project.id Stringa L'ID del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.number Stringa Un identificatore univoco anonimizzato generato internamente per il progetto Google Cloud che ha generato i dati di fatturazione Cloud. Nelle richieste di assistenza e in altre comunicazioni con i clienti, Google farà riferimento ai tuoi progetti utilizzando questo numero.
project.name Stringa Il nome del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.ancestry_numbers Stringa Gli antenati nella gerarchia delle risorse per il progetto identificato dal project.id specificato (ad esempio, my-project-123).

Ad esempio: /ParentOrgNumber/ParentFolderNumber/. Scopri di più sulla gerarchia delle risorse.

project.ancestors Struct

Questo campo descrive la struttura e il valore della gerarchia delle risorse di una voce di costo, inclusi progetti, cartelle e organizzazioni. Gli antenati sono ordinati dal nodo alla radice (progetto, cartella, quindi organizzazione).

project.ancestors.resource_name Stringa Il nome della risorsa relativo per ogni predecessore nel formato "resourceType/resourceNumber". L'utilizzo di project.ancestors.resource_name offrirà una visione più completa di project.ancestry_numbers.
project.ancestors.display_name Stringa Il nome che hai creato per la risorsa nella console.
project.labels Struct Campi che descrivono l'etichetta del progetto, ad esempio chiave, valore.
project.labels.key Stringa Se sono presenti etichette, la parte della chiave della coppia chiave-valore che comprende l'etichetta nel progetto Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'utilizzo delle etichette, consulta Utilizzo delle etichette.
project.labels.value Stringa Se sono presenti etichette, la parte del valore della coppia chiave-valore che comprende l'etichetta nel progetto Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'utilizzo delle etichette, consulta Utilizzo delle etichette.
labels Struct Campi che descrivono l'etichetta, ad esempio chiave, valore.
labels.key Stringa Se sono presenti etichette, la parte della chiave della coppia chiave-valore che comprende l'etichetta sulla risorsa Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'utilizzo delle etichette, consulta Utilizzo delle etichette.
labels.value Stringa Se sono presenti etichette, la parte value della coppia chiave-valore che comprende l'etichetta sulla risorsa Google Cloud dove si è verificato l'utilizzo. Per saperne di più sull'utilizzo delle etichette, consulta Utilizzo delle etichette.
system_labels Struct Campi che descrivono l'etichetta di sistema, ad esempio chiave, valore.
system_labels.key Stringa Se sono presenti etichette di sistema, la parte key della coppia chiave-valore che comprende l'etichetta generata dal sistema sulla risorsa in cui si è verificato l'utilizzo. Consulta anche Etichette di sistema disponibili.
system_labels.value Stringa Se sono presenti etichette di sistema, la parte value della coppia chiave-valore che comprende l'etichetta generata dal sistema sulla risorsa in cui si è verificato l'utilizzo. Consulta anche Etichette di sistema disponibili.
location.location Stringa Località di utilizzo a livello di multi-regione, paese, regione o zona; oppure global per risorse che non hanno una località specifica. Per saperne di più, consulta Area geografica e regioni e Località Google Cloud .
location.country Stringa Quando location.location è un paese, una regione o una zona, questo campo indica il paese di utilizzo, ad esempio US. Per saperne di più, consulta Area geografica e regioni e Località Google Cloud .
location.region Stringa Quando location.location è una regione o una zona, questo campo è la regione di utilizzo, ad esempio us-central1. Per saperne di più, consulta Area geografica e regioni e Località Google Cloud .
location.zone Stringa Quando location.location è una zona, questo campo indica la zona di utilizzo, ad esempio us-central1-a. Per saperne di più, consulta Area geografica e regioni e Località Google Cloud .
cost Numero in virgola mobile

Costo per il modello di consumo applicabile, inclusi eventuali sconti negoziati riflessi nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

currency Stringa La valuta in cui viene addebitato il costo. Per saperne di più, consulta Valuta locale per fatturazione e pagamenti.
currency_conversion_rate Numero in virgola mobile Il tasso di cambio dai dollari statunitensi alla valuta locale. In altre parole, cost ÷ currency_conversion_rate è il costo in dollari statunitensi.
usage.amount Numero in virgola mobile La quantità di usage.unit utilizzata.
usage.unit Stringa L'unità base in cui viene misurato l'utilizzo delle risorse. Ad esempio, l'unità di base per Standard Storage è byte-secondi.
usage.amount_in_pricing_units Numero in virgola mobile La quantità di usage.pricing_unit utilizzata.
usage.pricing_unit Stringa L'unità in cui viene misurato l'utilizzo delle risorse, in base all'API Cloud Billing Catalog.
credits Struct credits contiene campi che descrivono la struttura e il valore dei crediti associati agli SKU di Google Cloud e Google Maps Platform.
credits.id Stringa Se presente, indica che un credito è associato allo SKU del prodotto. I valori credits.id sono un identificatore univoco alfanumerico (ad esempio, 12-b34-c56-d78) o una descrizione del tipo di credito (ad esempio, Sconto per impegno di utilizzo: CPU).

Se il campo credits.id è vuoto, lo SKU del prodotto non è associato a un credito.

credits.full_name Stringa Il nome del credito associato allo SKU prodotto. Si tratta di una descrizione leggibile di un credits.id alfanumerico. Alcuni esempi sono Credito per la prova senza costi o Sconto per impegno di utilizzo basato sulla spesa.

I valori credits.full_name sono presenti solo per gli SKU con un credits.id alfanumerico. Se il valore di credits.id è una descrizione del tipo di credito (ad esempio Sconto per impegno di utilizzo: CPU), il campo credits.full_name è vuoto.

credits.type Stringa Questo campo descrive lo scopo o l'origine di credits.id. I tipi di credito includono:
  • FEE_UTILIZATION_OFFSET Per i nuovi sconti per impegno di utilizzo (CUD) basati sulla spesa, questo credito viene utilizzato per compensare le commissioni pagate per l'acquisto dei CUD. Con il nuovo modello, acquisti impegni a un prezzo scontato. Man mano che utilizzi gli SKU coperti dal CUD, questo credito compensa la tariffa. Quando utilizzi completamente l'impegno, la compensazione riduce la commissione a zero e l'utilizzo dello SKU idoneo viene addebitato al prezzo scontato.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: per gli sconti per impegno di utilizzo basati sulla spesa legacy che non fanno parte del nuovo modello di prezzi, questo è il credito guadagnato in cambio del tuo impegno a spendere un importo minimo per un servizio in una determinata regione.
  • COMMITTED_USAGE_DISCOUNT: contratti di utilizzo basato sulle risorse acquistati per Compute Engine in cambio di prezzi molto scontati per l'utilizzo delle VM.
  • DISCOUNT: il tipo di credito di sconto viene utilizzato per i crediti guadagnati dopo il raggiungimento di una soglia di spesa contrattuale. Tieni presente che nei report sulla fatturazione Cloud disponibili nella console Google Cloud , il tipo di credito di sconto è elencato come Sconti basati sulla spesa.
  • FREE_TIER: alcuni servizi consentono l'utilizzo senza costi delle risorse fino ai limiti specificati. Per questi servizi, vengono applicati crediti per implementare l'utilizzo del Livello senza costi.
  • PROMOTION: il tipo di credito promozionale include crediti per milestone basati sulla spesa, Google Cloud prova senza costi e crediti per campagne di marketing o altre sovvenzioni da utilizzare Google Cloud. Se disponibili, i crediti promozionali vengono considerati una forma di pagamento e vengono applicati automaticamente per ridurre il totale della fattura.
  • RESELLER_MARGIN: se sei un rivenditore, il tipo di credito margine del rivenditore indica gli sconti del Programma per rivenditori ottenuti per ogni voce idonea.
  • SUBSCRIPTION_BENEFIT: crediti ottenuti acquistando abbonamenti a lungo termine ai servizi in cambio di sconti.
  • SUSTAINED_USAGE_DISCOUNT: il tipo di credito per gli sconti per utilizzo sostenuto è uno sconto automatico che ricevi per l'esecuzione di risorse Compute Engine idonee per una parte significativa del mese di fatturazione, senza alcun impegno richiesto.
credits.name Stringa Una descrizione del credito applicato all'account di fatturazione Cloud.
credits.amount Numero in virgola mobile L'importo del credito applicato all'utilizzo.
adjustment_info Struct adjustment_info contiene campi che descrivono la struttura e il valore di un aggiustamento alle voci di costo associate a un account di fatturazione Cloud.

I valori adjustment_info sono presenti solo se l'elemento pubblicitario di costo è stato generato per una modifica della fatturazione Cloud. Una modifica può essere apportata per motivi di correzione o meno. Il tipo adjustment_info contiene i dettagli dell'aggiustamento, indipendentemente dal fatto che sia stato emesso per correggere un errore o per altri motivi.

adjustment_info.id Stringa Se presente, indica che un aggiustamento è associato a una voce di costo. adjustment_info.id è l'ID univoco di tutti gli aggiustamenti associati a un problema.
adjustment_info.description Stringa Una descrizione dell'aggiustamento e della relativa causa.
adjustment_info.type Stringa

Il tipo di aggiustamento.

I tipi includono:

  • USAGE_CORRECTION: una correzione dovuta a un utilizzo segnalato non corretto.
  • PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo errate.
  • METADATA_CORRECTION: una correzione per correggere i metadati senza modificare il costo.
  • GOODWILL: un credito emesso a favore del cliente per l'avviamento.
  • SALES_BASED_GOODWILL: un credito emesso a favore del cliente per avviamento, nell'ambito di un contratto.
  • SLA_VIOLATION: un credito emesso al cliente a causa di una violazione dell'obiettivo del livello di servizio (SLO).
  • BALANCE_TRANSFER: un aggiustamento per trasferire fondi da un account pagamenti a un altro.
  • ACCOUNT_CLOSURE: un aggiustamento per portare a zero il saldo di un account chiuso.
  • GENERAL_ADJUSTMENT: una modifica generale dell'account di fatturazione.
adjustment_info.mode Stringa

Modalità di emissione dell'aggiustamento,

Le modalità includono:

  • PARTIAL_CORRECTION: la correzione annulla parzialmente l'utilizzo e il costo originali.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: la correzione annulla completamente l'utilizzo e il costo originali ed emette voci corrette con l'utilizzo e il costo aggiornati.
  • COMPLETE_NEGATION: la correzione annulla completamente l'utilizzo e il costo originali e non viene rimonetizzato alcun ulteriore utilizzo.
  • MANUAL_ADJUSTMENT: l'aggiustamento viene allocato manualmente ai costi e all'utilizzo.
export_time Timestamp Un tempo di elaborazione associato all'aggiunta di dati di fatturazione Cloud. Questo valore aumenterà sempre a ogni nuova esportazione.
Consulta anche la sezione Differenze tra i dati esportati e le fatture di seguito.
tags Struct

Campi che descrivono il tag, ad esempio chiave, valore e spazio dei nomi.

tags.key Stringa

Il nome breve o il nome visualizzato della chiave associata a questo particolare tag.

tags.value Stringa

Le risorse collegate a un tags.key. In qualsiasi momento, è possibile collegare esattamente un valore a una risorsa per una determinata chiave.

tags.inherited Booleano

Indica se un'associazione di tag è ereditata (Tags Inherited = True) o diretta/non ereditata (Tags Inherited = False). Puoi creare un'associazione di tag a una risorsa padre nella gerarchia delle risorse.

tags.namespace Stringa

Rappresenta la gerarchia delle risorse che definisce la chiave e i valori dei tag. Lo spazio dei nomi può essere combinato con i nomi brevi della chiave tag e del valore tag per creare un nome completo univoco a livello globale per la chiave tag o il valore tag.

cost_at_list Numero in virgola mobile

Costo al prezzo di listino in base al modello di consumo predefinito.

transaction_type Stringa

Il tipo di transazione del venditore. Il tipo di transazione potrebbe essere uno dei seguenti:

  • GOOGLE = 1: servizi venduti da Google Cloud.
  • THIRD_PARTY_RESELLER = 2: servizi di terze parti rivenduti da Google Cloud.
  • THIRD_PARTY_AGENCY = 3: servizi di terze parti venduti da un partner, con Google Cloud che agisce in qualità di agente.
Questo campo viene compilato per gli elementi pubblicitari con cost_type = regular e può essere mancante per altri cost_types.
seller_name Stringa

Il nome legale del venditore.

Questo campo viene compilato per le voci di costo relative al Marketplace, che vengono impostate per i paesi in cui Google o una società consociata può agire come agente del fornitore. Per saperne di più, consulta Giurisdizioni delle agenzie.

price Struct

Campi che descrivono la struttura e i valori relativi ai prezzi addebitati per l'utilizzo.

price.list_price Numerico

Prezzo di listino dello SKU in base al modello di consumo predefinito.

price.effective_price_default Numerico

Prezzo dello SKU in base al modello di consumo predefinito, inclusi eventuali sconti negoziati riflessi nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

price.list_price_consumption_model Numerico

Prezzo di listino dello SKU in base al modello di consumo applicabile prima di eventuali sconti negoziati riflessi nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

price.effective_price Numerico

Prezzo dello SKU in base al modello di consumo applicabile, inclusi eventuali sconti negoziati riflessi nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

price.tier_start_amount Numerico

Il numero minimo di unità per un livello di prezzo di uno SKU. Per saperne di più, consulta Informazioni sui livelli di prezzo.

price.unit Stringa

L'unità di utilizzo in cui viene specificato il prezzo e viene misurato l'utilizzo delle risorse.

price.pricing_unit_quantity Numerico

La quantità dell'unità di prezzo dello SKU. Ad esempio, se il prezzo è 1 $per 1.000.000 di byte, questa colonna mostra 1.000.000.

cost_at_effective_price_default Numerico

Costo per il modello di consumo predefinito, inclusi eventuali sconti negoziati che si riflettono nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

cost_at_list_consumption_model Numerico

Costo per il modello di consumo applicabile prima di eventuali sconti negoziati riflessi nei prezzi personalizzati nel contratto collegato al tuo account di fatturazione Cloud (se applicabile).

consumption_model Struct

Campi che descrivono il modello di consumo applicabile.

consumption_model.id Stringa

L'ID del modello di consumo.

consumption_model.description Stringa

La descrizione del modello di consumo.

Campi aggiuntivi disponibili per l'esportazione dei dati di costo di utilizzo dettagliati
resource Struct

I campi che descrivono la struttura e il valore delle informazioni relative alle risorse del servizio (come una macchina virtuale o un'unità SSD) che generano l'utilizzo.

resource.global_name Stringa

Un identificatore di servizio univoco a livello globale per la risorsa che ha generato l'utilizzo pertinente.

resource.name Stringa

Un identificatore specifico del servizio per la risorsa che ha generato l'utilizzo pertinente. Può trattarsi di un input generato dall'utente.

subscription Struct

Campi che descrivono i tuoi impegni basati sulla spesa o sulle risorse. Puoi utilizzare questi campi per analizzare le tariffe per impegni specifici.

subscription.instance_id Stringa

L'ID abbonamento collegato a un impegno.

consumption_model.applied_subscription_instance_id Stringa

L'ID univoco dell'istanza dell'abbonamento che ha fornito i vantaggi dello sconto sulle voci di costo di utilizzo. Per gli sconti per impegno di utilizzo (CUD) basati sulla spesa, questo valore corrisponde a subscription.instance_id negli elementi pubblicitari dei costi delle tariffe.

Questo campo non è nullo nelle righe coperte da CUD basati sulla spesa ed è nullo nelle righe in cui non viene applicato alcuno sconto del modello di consumo.

Informazioni sui dati di costo di utilizzo standard e dettagliati

Le sezioni seguenti descrivono i dati di costo di utilizzo standard e dettagliati esportati in BigQuery.

Informazioni sulle etichette

I dati di costo per un'etichetta specifica mostrano solo l'utilizzo a partire dalla data in cui l'etichetta è stata applicata a una risorsa. Ad esempio, se aggiungi l'etichetta environment:dev a una VM di Compute Engine il 15 gennaio 2024, qualsiasi analisi per environment:dev include solo l'utilizzo di quella VM dal 15 gennaio.

Potresti anche visualizzare i dati delle etichette in momenti diversi per servizi diversi, a seconda di quando ogni servizio li fornisce.

Etichette di sistema disponibili

Le etichette di sistema sono coppie chiave-valore per metadati importanti sulla risorsa che ha generato l'utilizzo. Le seguenti etichette di sistema vengono incluse automaticamente nell'utilizzo applicabile.

system_labels.key Esempio system_labels.value Descrizione
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Configurazione della macchina virtuale. Per saperne di più, consulta Tipi di macchine.
compute.googleapis.com/cores per n1-standard-4 è 4; per custom-2-2048 è 2 Il numero di vCPU disponibili per la macchina virtuale.
compute.googleapis.com/memory per n1-standard-4 è 15360 (ovvero 15 GB * 1024 MB/GB); per custom-2-2048 è 2048 La quantità di memoria (in MB) disponibile per la macchina virtuale.
compute.googleapis.com/is_unused_reservation true; false Indica l'utilizzo prenotato tramite Prenotazioni a livello di zona ma non utilizzato.
compute.googleapis.com/reservation_name my-a2-reservation Il nome breve della prenotazione di Compute Engine. Per gli scenari proprietari (1P), sono incluse anche le prenotazioni condivise utilizzate dalle istanze create dai servizi Google Cloud , come Vertex AI. Per saperne di più su come condividere le prenotazioni con servizi proprietari (1P) in Vertex AI, consulta quanto segue:
compute.googleapis.com/reservation_project_id my-gcp-project L'ID progetto proprietario della prenotazione di Compute Engine. Per gli scenari proprietari (1P), sono incluse anche le prenotazioni condivise utilizzate dalle istanze create dai servizi Google Cloud , come Vertex AI. Per saperne di più su come condividere le prenotazioni con servizi proprietari (1P) in Vertex AI, consulta quanto segue:
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart Lo stato dell'oggetto di archiviazione addebitato.

Differenze tra dati esportati e fatture

Google Cloud e i prodotti idonei alla fatturazione, come Google Maps Platform, Google AI Studio e Firebase, segnalano i dati di utilizzo alla fatturazione Cloud a intervalli variabili. A causa della complessità dei nostri sistemi di fatturazione ed elaborazione, potresti riscontrare un ritardo tra l'utilizzo dei servizi, l'applicazione degli addebiti per l'utilizzo ai tuoi account pagamenti tramite Google e la visualizzazione di utilizzo e costi nei vari report e dashboard sui costi.

  • In genere, i dettagli sui costi sono disponibili entro un giorno, ma a volte possono essere necessarie più di 24 ore.
  • Per gli account online self-service, è possibile che gli addebiti per alcuni utilizzi vengano applicati rapidamente, ad esempio da 5 a 15 minuti dopo l'utilizzo.
  • A causa di questa differenza di tempistica, potresti notare addebiti nei tuoi account pagamenti con pagamento posticipato o anticipato prima di poter visualizzare i dettagli di questi addebiti in un report sui costi o in una dashboard di fatturazione. Questi ritardi del sistema influiscono anche sugli avvisi relativi al budget, sul rilevamento di anomalie e sui dati di fatturazione esportati in BigQuery.

Alla fine di un mese di calendario, l'utilizzo segnalato in ritardo potrebbe non essere incluso nella fattura di quel mese e potrebbe invece essere riportato nella fattura del mese successivo.

Quando esegui query sui costi utilizzando i campi timestamp, i dati restituiti potrebbero includere l'utilizzo segnalato in ritardo che non era stato originariamente incluso nella fattura generata per lo stesso mese di utilizzo. Di conseguenza, i dati di fatturazione Cloud restituiti potrebbero non corrispondere direttamente alla fattura.

I campi timestamp includono:

  • usage_start_time
  • usage_end_time
  • export_time

Per restituire i dati di fatturazione Cloud che corrispondono direttamente a una fattura, esegui una query su invoice.month anziché sui campi di timestamp.

Imposte

A partire dal 1° settembre 2020, i dati sui costi di utilizzo mostrano la tua responsabilità fiscale per ciascuno dei tuoi progetti, anziché come singola voce. Se hai query o visualizzazioni che dipendono dai dati fiscali, potresti dover aggiornare le query per tenere conto di queste modifiche.

Ad esempio, per i costi registrati prima del 1° settembre, i dati sui costi di utilizzo sono simili all'esempio seguente, che mostra un'obbligazione fiscale totale di 10 $.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normale 60 $
123456-ABCDEF-123456 test-project Normale 40 $
123456-ABCDEF-123456 [empty] Tasse 10 $

Per i costi registrati dopo il 1° settembre, i 10 $vengono suddivisi in 6 $per example-project e 4 $per test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Normale 60 $
123456-ABCDEF-123456 test-project Normale 40 $
123456-ABCDEF-123456 example-project Tasse $ 6
123456-ABCDEF-123456 test-project Tasse 4 $

Errori e aggiustamenti

Nel raro caso in cui i dati di fatturazione Cloud contengano un errore o richiedano un aggiustamento, vengono aggiunti dati correttivi. Questi aggiustamenti rientrano in una delle due categorie: modifiche o correzioni della fatturazione.

Modifiche alla fatturazione

Le modifiche alla fatturazione vengono visualizzate come voci separate. Se hai ricevuto una modifica alla fatturazione, una nuova riga nell'esportazione della fatturazione Cloud in BigQuery mostra la modifica. Gli aggiustamenti mostrati corrispondono ai documenti di fattura, nota di credito e nota di debito disponibili nell'area Documenti della sezione Fatturazione della console Google Cloud .

Per saperne di più sulle modifiche alla fatturazione e su come vengono applicate, consulta Informazioni su note e aggiustamenti.

Correzioni

Le correzioni vengono visualizzate come nuovi dati che annullano i dati errati sugli SKU di origine. In alcuni casi, i nuovi dati sostituiscono l'addebito errato. Tutte le colonne dell'esportazione dei dati di fatturazione corrisponderanno ai dati originali, ad eccezione delle seguenti colonne:

  • cost
  • credit
  • usage.amount
  • export_time

Ad esempio, immagina che il 1° gennaio ti vengano addebitati 10 $per l'utilizzo di SKU A. Nella fattura di gennaio (emessa all'inizio di febbraio), vedrai un addebito di 10 $per SKU A. Tuttavia, il 2 febbraio, Google Cloud ha emesso una correzione per SKU A, riducendo il costo di utilizzo a 5 $. Nella fattura di febbraio (emessa all'inizio di marzo) riceverai due elementi pubblicitari aggiuntivi:

  • -10 $ per l'utilizzo del 1° gennaio (annullando l'addebito originale)
  • 5 $ per l'utilizzo del 1° gennaio (indicando l'addebito previsto)

Queste nuove voci hanno una colonna adjustment_info nell'esportazione dei dati di fatturazione. La fattura originale di gennaio, che mostra l'addebito eccessivo, non verrà modificata. Puoi verificare gli addebiti nell'esportazione dei dati di fatturazione visualizzando i costi per usage_start_time e raggruppandoli per Day. In queste visualizzazioni, vengono accumulate tutte le correzioni o gli addebiti per l'utilizzo monetizzato in ritardo e non devi preoccuparti di eventuali dati temporaneamente errati.

Se vuoi informazioni più dettagliate sulle correzioni, visualizza tutti gli addebiti in un mese di fatturazione e cerca gli addebiti in cui la data di utilizzo è precedente al mese di fatturazione. Questi addebiti sono il risultato di correzioni o di un utilizzo monetizzato in ritardo.

Il seguente esempio di codice mostra come creare una query di base che restituisce il costo totale delle correzioni o dell'utilizzo monetizzato in ritardo:

SELECT
  SUM(cost)
    +   SUM(IFNULL((SELECT SUM(c.amount)
      FROM   UNNEST(credits) c), 0))
    AS total
FROM `project.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE
  invoice.month = '202311' AND
  DATE(TIMESTAMP_TRUNC(usage_start_time, Day, 'US/Pacific')) < '2023-11-01';

Per un esempio di query che restituisce una suddivisione dei costi per servizio, per gli addebiti della fattura, in cui la data di utilizzo si è verificata prima del mese di fatturazione, consulta Esegui query sui dettagli dei costi per visualizzare le correzioni o l'utilizzo monetizzato in ritardo per servizio per un mese di fatturazione specificato in "Esempi di query per l'esportazione dei dati di fatturazione Cloud".

Informazioni sui crediti promozionali nei contratti con prezzi personalizzati

Se hai un contratto con prezzi personalizzati, potresti ricevere crediti promozionali da utilizzare su Google Cloud nell'ambito del contratto. Ad esempio, potresti ricevere 1000 $da utilizzare per le risorse Compute Engine. I crediti promozionali vengono in genere considerati una forma di pagamento. Se disponibili, i crediti promozionali vengono applicati automaticamente per ridurre il totale della fattura.

I termini del contratto specificano se i crediti promozionali si applicano ai costi calcolati al prezzo di listino di uno SKU o al prezzo netto (al netto degli sconti).

Se i crediti promozionali si applicano ai costi calcolati al prezzo di listino, nel report Tabella dei costi è presente un servizio denominato Invoice, con uno SKU denominato Contract billing adjustment. Questo SKU modifica i tuoi crediti in modo che vengano applicati ai costi al prezzo di listino. Per visualizzare l'utilizzo a cui si riferisce l'aggiustamento, esegui una query sulle colonne system.labels. La chiave in system.labels.key è cloud-invoice.googleapis.com/sku_id e il valore in system.labels.value contiene l'ID SKU a cui sono stati applicati il credito e l'aggiustamento.

Informazioni sui tag

I tag sono risorse sotto forma di coppie chiave-valore che possono essere collegate alle risorse direttamente o tramite ereditarietà. Puoi utilizzare i tag per eseguire storni di addebito, audit e altre analisi di allocazione dei costi. Puoi anche utilizzare i tag e l'applicazione condizionale delle policy per avere un controllo granulare in tutta la gerarchia delle risorse.

I tag hanno un modello di autorizzazioni solido e possono supportare l'ereditarietà, la gestione centralizzata, la standardizzazione della nomenclatura e l'integrazione del motore delle policy, mentre le etichette sono uno strumento separato che consente di annotare le risorse.

I dati dei tag vengono visualizzati nelle esportazioni BigQuery per risorse, progetti, cartelle e organizzazioni.

Tag disponibili

Le esportazioni di Costi standard e Costi dettagliati per risorse, progetti, cartelle e organizzazioni includono i seguenti campi per i dati dei tag: Chiave tag, Valore tag, Tag ereditati e Spazio dei nomi tag.

I tag a livello di risorsa nell'esportazione dei dati di fatturazione Cloud sono disponibili per le seguenti risorse:

  • Cluster, istanze e backup di AlloyDB per PostgreSQL
  • Repository Artifact Registry
  • Istanze Bigtable
  • Servizi e job Cloud Run
  • Bucket Cloud Storage
  • Istanze di Compute Engine
  • Istanze Memorystore for Redis
  • Secret globali e regionali di Secret Manager
  • Istanze Spanner
  • Database Firestore

Limitazioni dei tag

  • La propagazione dei tag alle esportazioni di BigQuery potrebbe richiedere fino a un'ora. Se un tag è stato aggiunto o rimosso entro un'ora o se una risorsa esiste da meno di un'ora, potrebbe non essere visualizzato nell'esportazione.

Esempi di query sui costi di utilizzo dettagliati

Questa sezione fornisce esempi di come eseguire query sui dati di costo di utilizzo dettagliati di fatturazione Cloud esportati in BigQuery.

Poiché lo schema dei costi di utilizzo dettagliati include tutti i campi dello schema dei costi di utilizzo standard, gli esempi di query forniti per i dati standard esportati in BigQuery funzionano anche con i dati dettagliati esportati. Gli esempi di query standard non sono scritti per recuperare le informazioni a livello di risorsa fornite con l'opzione di esportazione dei costi di utilizzo dettagliati. Quando crei query per i dati dettagliati, puoi utilizzare un esempio di query standard come modello, aggiornare il nome della tabella e aggiungere uno dei campi disponibili nello schema dei costi di utilizzo dettagliati.

Valori comuni utilizzati nelle query di esempio sui costi dettagliati

Gli esempi di query in questa sezione utilizzano il seguente valore per Nome tabella: project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX

Restituisci i costi a livello di risorsa in una fattura

Le seguenti query mostrano due modi per visualizzare i valori di costo e credito a livello di risorsa su una fattura utilizzando i dati di fatturazione esportati.

  • Il campo total somma direttamente i valori di costo e credito in virgola mobile, il che può comportare errori di arrotondamento in virgola mobile.
  • Il campo total_exact converte i valori di costi e crediti in micro prima di sommarli, quindi li riconverte in dollari dopo la somma, evitando l'errore di arrotondamento della rappresentazione in virgola mobile.

Somma i costi per ogni risorsa, per fattura

Questa query mostra il totale delle fatture di ogni resource.name al mese, come somma di costi, tasse, aggiustamenti ed errori di arrotondamento standard. Tutti i costi non associati a un elemento a livello di risorsa vengono aggregati sotto il nome null per il mese.

SQL standard

SELECT
  invoice.month,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2
ORDER BY 1 ASC, 2 ASC
;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga mese nome totale total_exact
1 201901 null 1005,004832999999984 $ 1005,00 $
2 201901 backend1 781,8499760000028 $ 781,85 $
3 201902 null 953,0034923645475983 $ 953,03 $
4 201902 backend1 992,3101739999999717 $ 992,31 $
5 201902 bitnami-launchpad-wordpress-1-wordpress 1,2817819999999998 $ 1,28 $

Restituisce i dettagli per tipo di costo per ogni risorsa, per mese di fatturazione

Questa query mostra i totali per ogni cost_type per ogni resource.name al mese. I tipi di costi includono costi, tasse, aggiustamenti ed errori di arrotondamento standard. Tutti i costi non associati a un elemento a livello di risorsa vengono aggregati sotto il nome null per il mese.

SQL standard

SELECT
  invoice.month,
  cost_type,
  resource.name,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM   UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2, 3
ORDER BY 1 ASC, 2 ASC, 3 ASC
;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga mese cost_type nome totale total_exact
1 201901 normale null 1000.501209987994782 $ 1000,50 $
2 201901 rounding_error null –0,500489920049387 $ –0,50 $
3 201901 tax null 10,000329958477891 $ $ 10,00
4 201901 aggiustamento null –5,002572999387045 $ -5,00 $
5 201901 normale backend1 410,998795012082947 $ 411,00 $
2 201901 rounding_error backend1 –0,2404900489920378 $ -0,24 $
3 201901 tax backend1 4,105840329977189 $ 4,11 $

Visualizza un'analisi dettagliata dei costi dei cluster Google Kubernetes Engine (GKE)

Questa sezione fornisce esempi di filtri dei costi dei cluster GKE nei report di BigQuery Export. Per scoprire di più sui costi dei cluster GKE, consulta Visualizza l'analisi dettagliata dei costi dei cluster.

Filtra i costi di GKE

Le seguenti query di esempio mostrano come filtrare e raggruppare i costi di GKE per i tipi di risorse supportati in base a nome del cluster, spazio dei nomi ed etichetta.

Costi dei cluster GKE prima dei crediti

SELECT
  SUM(cost) AS cost_before_credits,
  labels.value AS cluster_name
FROM  `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY labels.value
;

Costi di GKE inclusi i crediti per spazio dei nomi

SELECT
  labels.value as namespace,
  SUM(cost) + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) AS cost_after_credits,
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "k8s-namespace"
GROUP BY namespace
;

Costi GKE per SKU

SELECT
  project.id AS project_id,
  labels.value AS cluster_name,
  sku.id AS sku_id,
  sku.description AS sku_description,
  SUM(cost) AS cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
JOIN UNNEST(labels) AS labels
  ON labels.key = "goog-k8s-cluster-name"
GROUP BY
  cluster_name, project_id, sku_description, sku_id
;

Esempi di query con tag

I seguenti esempi illustrano i modi per eseguire query sui dati con i tag.

Calcola i costi per mese di fatturazione con i tag

La seguente query mostra come utilizzare i costi di reso per mese di fatturazione per il tag cost_center.

SELECT
  invoice.month AS invoice_month,
  tag.value AS cost_center,
  ROUND((SUM(CAST(cost AS NUMERIC))
    + SUM(IFNULL((SELECT SUM (CAST(c.amount AS NUMERIC))
                  FROM UNNEST(credits) AS c), 0))), 2)
    AS net_cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`, UNNEST(tags) AS tag
WHERE tag.key = "cost_center" AND tag.namespace = "821092389413"
GROUP BY invoice.month, tag.value
ORDER BY invoice.month, tag.value;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga invoice_month cost_center net_cost
1 202208 android_mobile_apps 9,93
2 202208 ios_mobile_apps 9,93
3 202209 android_mobile_apps 25,42
4 202209 ios_mobile_apps 25,4
5 202209 personalizzazione 16.08

Visualizza i costi delle risorse senza tag

Questa query mostra il totale delle fatture per le risorse senza tag, raggruppate per mese di fatturazione.

SELECT
 invoice.month AS invoice_month,
 ROUND((SUM(CAST(cost AS NUMERIC))
   + SUM(IFNULL((SELECT SUM(CAST(c.amount AS NUMERIC))
                 FROM UNNEST(credits) AS c), 0))), 2)
   AS net_cost
FROM
 `project-ID.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE "color" NOT IN (SELECT key FROM UNNEST(tags))
GROUP BY invoice_month
ORDER BY invoice_month;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga invoice_month net_cost
1 202202 0
2 202203 16,81
3 202204 54,09
4 202205 55,82
5 202206 54,09
6 202207 55,83
7 202208 31,49

Esegui query utilizzando le etichette di sistema

Le etichette di sistema per le prenotazioni Google Cloud offrono una maggiore visibilità sull'utilizzo delle prenotazioni. Ti consentono di monitorare quali istanze utilizzano quali prenotazioni e di analizzare i costi associati alla capacità utilizzata e non utilizzata direttamente in BigQuery.

Questi esempi utilizzano due etichette di sistema:

  • compute.googleapis.com/reservation_name
  • compute.googleapis.com/reservation_project_id

Queste etichette sono presenti nei record di fatturazione Cloud sia delle istanze che utilizzano una prenotazione sia della parte non utilizzata di una prenotazione.

Gli esempi seguenti mostrano come eseguire query sull'esportazione della fatturazione di BigQuery per analizzare il consumo delle prenotazioni utilizzando le etichette di sistema.

Prima di iniziare

Per eseguire query utilizzando le etichette di sistema, devi aver attivato l'esportazione della fatturazione Cloud in BigQuery, in particolare l'esportazione dei Dati di costo di utilizzo dettagliati. Questa esportazione contiene le informazioni a livello di risorsa, incluse le etichette di sistema, necessarie per visualizzare le nuove etichette di prenotazione.

Per configurare o verificare l'esportazione in BigQuery, consulta la seguente documentazione:

  1. Panoramica dell'esportazione dei dati di fatturazione in BigQuery
  2. Configura l'esportazione dei dati di fatturazione in BigQuery
  3. Informazioni sullo schema di esportazione dei dati dettagliati

Assicurati che il set di dati BigQuery sia configurato per ricevere l'esportazione dettagliata. Il nome della tabella sarà in genere nel formato gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Visualizza il consumo per una determinata istanza

Questa query ti consente di verificare se una determinata istanza ha utilizzato una prenotazione durante un determinato periodo e, in caso affermativo, di quale prenotazione si trattava.


SELECT
  t.usage_start_time,
  sl_reservation.value AS reservation_name,
  t.sku.description AS sku_description,
  SUM(t.usage.amount) AS total_usage_amount
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
  LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
WHERE
  t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
  t.resource.name LIKE '%tc-billing-case1-instance-1757983787%'
GROUP BY t.usage_start_time, reservation_name, t.sku.description
ORDER BY t.usage_start_time, reservation_name, t.sku.description;

Risultato di esempio:

usage_start_time reservation_name sku_description total_usage_amount
2025-09-16 00:00:00.000000 UTC Core di istanza E2 in esecuzione nelle Americhe 597
2025-09-16 01:00:00.000000 UTC Core di istanza E2 in esecuzione nelle Americhe 3009
2025-09-16 01:00:00.000000 UTC tc-billing-case1-res0-1757983787 Core di istanza E2 in esecuzione nelle Americhe 591
2025-09-16 02:00:00.000000 UTC Core di istanza E2 in esecuzione nelle Americhe 10
2025-09-16 02:00:00.000000 UTC tc-billing-case1-res0-1757983787 Core di istanza E2 in esecuzione nelle Americhe 3054
2025-09-16 02:00:00.000000 UTC tc-billing-case1-res1-1757983787 Core di istanza E2 in esecuzione nelle Americhe 37

Nota:

  • Filtro SKU: limitare lo SKU ai core della CPU offre una distribuzione più chiara delle risorse. Questo valore può essere modificato per altre risorse prenotate, come RAM, SSD locale, TPU o GPU.
  • Consumo on demand: quando sia reservation_name che reservation_project_id sono null, l'istanza utilizza risorse on demand.

Quando più righe con reservation_name e reservation_project_id diversi corrispondono a un'istanza specifica in un determinato periodo di tempo, significa che la prenotazione utilizzata dall'istanza è cambiata durante quel periodo. La sezione Utilizzo descrive in dettaglio il consumo.

Analizza la distribuzione dell'utilizzo per una determinata prenotazione

Questa query ti aiuta a comprendere la distribuzione dell'utilizzo per una determinata prenotazione condivisa, mostrando la capacità utilizzata o inutilizzata tra i diversi progettiGoogle Cloud che possono utilizzare la prenotazione specificata.


SELECT
  t.project.id AS consumer_project_id,
  t.sku.description AS sku_description,
  CASE
    WHEN t.resource.global_name NOT LIKE '%instances/%' THEN 'Unused Capacity'
    WHEN t.resource.name IS NOT NULL AND t.resource.name != '' THEN 'Instance Usage'
    ELSE 'Other Reservation Cost'
  END AS usage_category,
  SUM(t.usage.amount) AS total_usage_amount,
  t.usage.unit AS usage_unit,
  SUM(t.cost) AS total_cost_usd
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
  LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
  LEFT JOIN
  UNNEST(t.system_labels) AS sl_project_id
  ON sl_project_id.key = 'compute.googleapis.com/reservation_project_id'
WHERE
  t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
  sl_reservation.value LIKE '%tc-billing-case2-res-1757983801%'
GROUP BY consumer_project_id, t.sku.description, usage_category,
  usage_unit
ORDER BY consumer_project_id, usage_category;

Risultati di esempio:

consumer_project_id sku_description usage_category total_usage_amount usage_unit total_cost_usd
disco-sector-292704 Core di istanza E2 in esecuzione nelle Americhe Utilizzo dell'istanza 14551 secondi 0,088158
flash-freehold-292704 Core di istanza E2 in esecuzione nelle Americhe Utilizzo dell'istanza 7347 secondi 0,044512
united-sandbox-303721 Core di istanza E2 in esecuzione nelle Americhe Capacità inutilizzata 7936 secondi 0,04808

Elenca tutte le istanze che utilizzano una prenotazione

Analogamente, possiamo scrivere una query per comprendere tutte le istanze, incluse quelle proprietarie (1P), che hanno utilizzato una determinata prenotazione durante un determinato periodo di tempo.


SELECT
  t.usage_start_time,
  t.usage_end_time,
  t.project.id AS consumer_project_id,
  t.resource.name AS instance_name,
  t.usage.amount AS usage_amount
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
  LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
WHERE
  t.service.id = '6F81-5844-456A' AND DATE(TIMESTAMP_TRUNC(t._PARTITIONTIME, DAY)) = '2025-09-16' AND t.sku.description LIKE '%Core%' AND
  sl_reservation.value LIKE '%tc-billing-case2-res-1757983801%' AND t.resource.global_name NOT LIKE '%allocation/%' AND
  t.resource.name IS NOT NULL AND t.resource.name != ''
ORDER BY t.usage_start_time, t.project.id, t.resource.name;

Risultati di esempio:

usage_start_time usage_end_time consumer_project_id instance_name usage_amount
2025-09-16 00:00:00.000000 UTC 2025-09-16 01:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins0-1757983801 552
2025-09-16 00:00:00.000000 UTC 2025-09-16 01:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins1-1757983801 533
2025-09-16 00:00:00.000000 UTC 2025-09-16 01:00:00.000000 UTC flash-freehold-292704 projects/978655420110/instances/tc-billing-case2-ins2-1757983801 517
2025-09-16 01:00:00.000000 UTC 2025-09-16 02:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins0-1757983801 3600
2025-09-16 01:00:00.000000 UTC 2025-09-16 02:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins1-1757983801 3600
2025-09-16 01:00:00.000000 UTC 2025-09-16 02:00:00.000000 UTC flash-freehold-292704 projects/978655420110/instances/tc-billing-case2-ins2-1757983801 3600
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins0-1757983801 3022
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins0-1757983801 79
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins1-1757983801 79
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC disco-sector-292704 projects/204187533293/instances/tc-billing-case2-ins1-1757983801 3086
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC flash-freehold-292704 projects/978655420110/instances/tc-billing-case2-ins2-1757983801 3151
2025-09-16 02:00:00.000000 UTC 2025-09-16 03:00:00.000000 UTC flash-freehold-292704 projects/978655420110/instances/tc-billing-case2-ins2-1757983801 79

Analizza l'utilizzo delle prenotazioni di Vertex AI con BigQuery

Per analizzare il modo in cui i prodotti proprietari (1P), come Vertex AI, utilizzano le prenotazioni condivise tra i progetti in cui sono attivi i job Vertex AI, utilizza le seguenti etichette di sistema in BigQuery:

  • compute.googleapis.com/reservation_name
  • compute.googleapis.com/reservation_project_id

Per ulteriori informazioni su come condividere le prenotazioni con prodotti proprietari (1P) in Vertex AI, consulta quanto segue:

Le seguenti query di esempio mostrano come utilizzare queste etichette per ottenere una visibilità dettagliata sull'utilizzo delle prenotazioni, monitorare il modo in cui le istanze consumano queste prenotazioni ed eseguire un'analisi approfondita dei costi.

Elenca i tipi di SKU che utilizzano una prenotazione per un prodotto proprietario in Vertex AI

Se crei e condividi una prenotazione con Vertex AI per un job di addestramento, la seguente query restituisce l'elenco dei tipi di SKU per la data corrente.


SELECT DISTINCT
  t.sku.description AS sku_description
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
WHERE
  TRUE
  AND t.service.id = '6F81-5844-456A'
  AND DATE(t.usage_start_time) = CURRENT_DATE()
  AND EXISTS(
    SELECT 1
    FROM UNNEST(t.Tags) AS tag
    WHERE
      tag.key = 'gcp-product'
      AND tag.value = 'vertex_ai'
      AND tag.inherited = TRUE
  )
  AND sl_reservation.value = 'RESERVATION_NAME'
  AND t.resource.name IS NOT NULL
  AND t.resource.name != ''
ORDER BY sku_description ASC;

Risultati di esempio

I risultati mostrano che il job di addestramento utilizza tre tipi di SKU all'interno del servizio Vertex AI.

sku_description
Core di istanza predefinita N1 in esecuzione nelle Americhe
RAM per istanza predefinita N1 in esecuzione nelle Americhe
GPU Nvidia Tesla T4 in esecuzione nelle Americhe

Analizza le statistiche degli SKU per prenotazione per un prodotto proprietario in Vertex AI

La seguente query ti aiuta a comprendere la distribuzione delle istanze e i relativi costi di utilizzo associati a una prenotazione per un prodotto proprietario (1P) nel mese corrente.


SELECT
  t.sku.description AS sku_description,
  t.usage_start_time AS usage_start_time,
  t.usage_end_time AS usage_end_time,
  SUM(t.usage.amount) AS total_usage_amount
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
LEFT JOIN
  UNNEST(t.system_labels) AS sl_project_id
  ON sl_project_id.key = 'compute.googleapis.com/reservation_project_id'
WHERE
  TRUE
  AND t.service.id = '6F81-5844-456A'
  AND t.invoice.month = '202602'
  AND EXISTS(
    SELECT 1
    FROM UNNEST(t.Tags) AS tag
    WHERE
      tag.key = 'gcp-product'
      AND tag.value = 'vertex_ai'
      AND tag.inherited = TRUE
  )
  AND sl_reservation.value = 'RESERVATION_NAME'
  AND sl_project_id.value = 'PROJECT_ID'
  AND t.resource.name IS NOT NULL
  AND t.resource.name != ''
GROUP BY sku_description, usage_start_time, usage_end_time;

Risultati di esempio

L'output seguente mostra in che modo gli SKU utilizzano la prenotazione e fornisce una suddivisione dei costi di utilizzo corrispondenti.

sku_description usage_start_time usage_end_time total_usage_amount
Core di istanza predefinita N1 in esecuzione nelle Americhe 2026-02-10 05:00:00.000000 UTC 2026-02-10 06:00:00.000000 UTC 5040
RAM per istanza predefinita N1 in esecuzione nelle Americhe 2026-02-10 05:00:00.000000 UTC 2026-02-10 06:00:00.000000 UTC 20293720473600
GPU Nvidia Tesla T4 in esecuzione nelle Americhe 2026-02-10 05:00:00.000000 UTC 2026-02-10 06:00:00.000000 UTC 1260
Core di istanza predefinita N1 in esecuzione nelle Americhe 2026-02-10 04:00:00.000000 UTC 2026-02-10 05:00:00.000000 UTC 14400
RAM per istanza predefinita N1 in esecuzione nelle Americhe 2026-02-10 04:00:00.000000 UTC 2026-02-10 05:00:00.000000 UTC 57982058496000
GPU Nvidia Tesla T4 in esecuzione nelle Americhe 2026-02-10 04:00:00.000000 UTC 2026-02-10 05:00:00.000000 UTC 3600

Analizza l'utilizzo delle prenotazioni per Vertex AI nei progetti condivisi

Se utilizzi una prenotazione condivisa tra più progetti proprietari in cui sono attivi job Vertex AI, puoi utilizzare la seguente query per analizzare e suddividere i costi di utilizzo per singolo progetto.


SELECT
  t.project.id AS consumer_project_id,
  t.sku.description AS sku_description,
  t.usage.unit AS usage_unit,
  SUM(t.usage.amount) AS total_usage_amount
FROM
  project-ID.dataset.gcp_billing_export_resource_v1_X AS t
LEFT JOIN
  UNNEST(t.system_labels) AS sl_reservation
  ON sl_reservation.key = 'compute.googleapis.com/reservation_name'
LEFT JOIN
  UNNEST(t.system_labels) AS sl_project_id
  ON sl_project_id.key = 'compute.googleapis.com/reservation_project_id'
WHERE
  TRUE
  AND t.service.id = '6F81-5844-456A'
  AND EXISTS(
    SELECT 1
    FROM UNNEST(t.Tags) AS tag
    WHERE
      tag.key = 'gcp-product'
      AND tag.value = 'vertex_ai'
      AND tag.inherited = TRUE
  )
  AND sl_reservation.value = 'RESERVATION_NAME'
  AND sl_project_id.value = 'PROJECT_ID'
GROUP BY
  consumer_project_id, sku_description, usage_unit
ORDER BY consumer_project_id, sku_description, usage_unit;

Risultati di esempio

L'output seguente mostra il contributo di ogni progetto ai costi di utilizzo totali durante l'utilizzo della prenotazione.

consumer_project_id sku_description usage_unit total_usage_amount
project1 Core di istanza predefinita N1 in esecuzione nelle Americhe secondi 4221572
project1 RAM per istanza predefinita N1 in esecuzione nelle Americhe byte-secondi 16998309356466500
project1 GPU Nvidia Tesla T4 in esecuzione nelle Americhe secondi 1057391
project2 Core di istanza predefinita N1 in esecuzione nelle Americhe secondi 3996192
project2 RAM per istanza predefinita N1 in esecuzione nelle Americhe byte-secondi 16009292257431300
project2 GPU Nvidia Tesla T4 in esecuzione nelle Americhe secondi 993985

Per informazioni relative ai dati di fatturazione Cloud esportati, consulta quanto segue:

Per i dettagli dei report sui costi e sui prezzi disponibili nella console Google Cloud , consulta quanto segue: