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 dettagliate 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
  • Dataproc Metastore
  • Firestore e Datastore
  • Google Kubernetes Engine (GKE)
    Per visualizzare un'analisi dettagliata dei costi dei cluster GKE in un'esportazione dettagliata dei dati, devi anche abilitare l'allocazione dei costi per GKE.
  • Microsoft Active Directory gestito
  • Memorystore for Redis
  • Secret Manager
  • Spanner

Identificare i dati granulari sui costi per servizio

Per analizzare informazioni dettagliate sui costi in un'esportazione dettagliata, utilizza la seguente tabella 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 per la 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.

Dataproc Metastore 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 i seguenti tasti delle etichette per filtrare le risorse:

  • goog-fleet-project: filtra le risorse del cluster per 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 in base al pool di nodil.
  • 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 (solo clienti GKE Enterprise).
  • 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 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.

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 per la risorsa.

Consulta esempi di query sui dati granulari per le tue risorse.

Schema dei dati sul costo di utilizzo dettagliato

Nel tuo set di dati BigQuery, i dati dettagliati sul costo 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 dettagliati relativi all'utilizzo in BigQuery, tieni presente quanto segue:

  • Lo schema della tabella per l'esportazione dettagliata dei dati di fatturazione Cloud può cambiare nel tempo, ad esempio quando vengono aggiunti nuovi campi all'esportazione dettagliata. Per proteggere le query da modifiche future dello 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 tue query. Scopri di più su questa limitazione.
  • Quando selezioni o crei un set di dati BigQuery per i dati di costo dettagliati relativi all'utilizzo, puoi selezionare qualsiasi posizione 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 posizione multiregionale (UE o Stati Uniti), i dati di fatturazione Cloud saranno disponibili retroattivamente a partire 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 prima che l'esportazione dei dati retroattivi di fatturazione Cloud venga completata e prima che tu possa iniziare a visualizzare i dati di utilizzo più recenti.
  • Se abiliti l'esportazione dei dati di costo di utilizzo dettagliato e selezioni un set di dati configurato per utilizzare una località regione supportata, i dati di fatturazione Cloud saranno disponibili a partire dalla data in cui hai abilitato l'esportazione.
  • Se hai attivato, disattivato e successivamente riattivato 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 disattivata esplicitamente.
  • Scopri di più sulla frequenza di caricamento dei dati nelle tabelle BigQuery.
  • Consulta altre limitazioni che potrebbero influire sull'esportazione dei dati di fatturazione in BigQuery, come i set di dati con le chiavi di crittografia gestite dal cliente (CMEK) abilitate.
  • Tieni conto del volume di dati aggiuntivo che potrebbero richiedere le tabelle BigQuery e del 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 Controllare i costi in BigQuery per ulteriori best practice per la gestione dei costi di BigQuery.
Campo Tipo Descrizione
billing_account_id Stringa

L'ID dell'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 principale del rivenditore.

invoice.month Stringa

L'anno e il mese (AAAAMM) della fattura che include le voci relative ai costi. Ad esempio, "201901" equivale a gennaio 2019.

Puoi utilizzare questo campo per conoscere gli addebiti totali sulla fattura. Consulta Esempi di query per l'esportazione della fatturazione in BigQuery.

invoice.publisher_type Stringa

Indica il publisher associato alla transazione. Questo campo supporta la divisione delle fatture tra le transazioni effettuate direttamente con Google (proprietario) e le transazioni effettuate con un partner (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, da parte di un partner.
cost_type Stringa

Il tipo di costo rappresentato da questa voce: Regular (Normale), Tax (Imposte), Adjustment (Aggiustamento) o Rounding (Arrotondamento).

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

Per ulteriori informazioni, consulta la documentazione di BigQuery sui tipi di dati timestamp. Vedi anche: Differenze tra i dati esportati e le fatture.

usage_end_time Timestamp L'ora di fine dell'intervallo di utilizzo orario in cui è stato calcolato il costo specificato. L'utilizzo e i costi di tutti i servizi sono visualizzati con granularità oraria, il che significa che l'utilizzo dei servizi a lunga esecuzione è distribuito su più intervalli orari.

Per ulteriori informazioni, consulta la documentazione di BigQuery sui tipi di dati timestamp. Vedi anche: Differenze tra i dati esportati e le fatture.

project Struct project contiene campi che descrivono il progetto 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 e anonimizzato, generato internamente per il Google Cloud progetto 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 con questo numero di progetto.
project.name Stringa Il nome del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.ancestry_numbers Stringa I predecessori nella gerarchia di risorse del progetto identificato dal valore di 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, poi organizzazione).

project.ancestors.resource_name Stringa Il nome risorsa relativo per ogni antenato nel formato "resourceType/resourceNumber". L'utilizzo di project.ancestors.resource_name offre 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.key Stringa Se sono presenti etichette, la parte relativa alla 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, vedi Utilizzare le etichette.
project.labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta nel progetto Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'uso delle etichette, vedi Utilizzare le etichette.
labels.key Stringa Se sono presenti etichette, la parte relativa alla chiave della coppia chiave-valore che comprende l'etichetta nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'uso delle etichette, vedi Utilizzare le etichette.
labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'uso delle etichette, vedi Utilizzare le etichette.
system_labels.key Stringa Se sono presenti etichette di sistema, la parte relativa alla chiave della coppia chiave-valore che comprende l'etichetta generata dal sistema nella risorsa in cui si è verificato l'utilizzo. Vedi anche: Etichette di sistema disponibili.
system_labels.value Stringa Se sono presenti etichette di sistema, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta generata dal sistema nella risorsa in cui si è verificato l'utilizzo. Vedi anche: Etichette di sistema disponibili.
location.location Stringa Posizione di utilizzo a livello di più regioni, paese, regione o zona; o global per le risorse che non hanno una posizione specifica. Per saperne di più, consulta Aree geografiche e regioni e Google Cloud posizioni.
location.country Stringa Quando location.location è un paese, una regione o una zona, questo campo corrisponde al paese di utilizzo, ad esempio US. Per saperne di più, consulta Aree geografiche e regioni e Google Cloud posizioni.
location.region Stringa Quando location.location è una regione o una zona, questo campo corrisponde alla regione di utilizzo, ad esempio us-central1. Per saperne di più, consulta Aree geografiche e regioni e Google Cloud posizioni.
location.zone Stringa Quando location.location è una zona, questo campo è la zona di utilizzo, ad esempio us-central1-a. Per saperne di più, consulta Aree geografiche e regioni e Google Cloud posizioni.
cost Numero in virgola mobile Il costo dell'utilizzo prima di applicare eventuali crediti, con una precisione fino a sei cifre decimali. Per ottenere il costo totale inclusi i crediti, è necessario aggiungere i credits.amount al costo. Per ulteriori informazioni, consulta questa query di esempio.
currency Stringa La valuta in cui viene addebitato il costo. Per saperne di più, vedi Valuta locale per fatturazione e pagamenti.
currency_conversion_rate Numero in virgola mobile Il tasso di cambio dai dollari statunitensi alla valuta locale. ovvero 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à base per l'archiviazione standard è 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 prodotto. I valori di credits.id possono essere identificatori univoci alfanumerici (ad esempio 12-b34-c56-d78) o descrizioni del tipo di credito (ad esempio Sconto per impegno di utilizzo: CPU).

Se il campo credits.id è vuoto, lo SKU 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 crediti per le prove gratuite o sconti per impegni di utilizzo basati sulla spesa.

I valori di 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:
  • COMMITTED_USAGE_DISCOUNT: Contratti per uso confermato basati su risorse acquistati per Compute Engine in cambio di prezzi notevolmente scontati per l'utilizzo delle VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratti per uso confermato basati sulla spesa acquistati per servizi in cambio di un impegno di spesa minimo.
  • DISCOUNT: questo tipo di credito viene utilizzato per i crediti guadagnati al raggiungimento di una soglia di spesa contrattuale. Tieni presente che nei report di fatturazione Cloud disponibili nella console Google Cloud , il tipo di credito sconto è indicato come Sconti basati sulla spesa (contrattuali).
  • FREE_TIER: alcuni servizi offrono l'utilizzo senza costi delle risorse fino ai limiti specificati. Per questi servizi, i crediti vengono applicati per implementare l'utilizzo del livello gratuito.
  • PROMOTION: questo tipo di credito include Google Cloud prova gratuita e crediti per le campagne di marketing oppure altri vantaggi per utilizzare Google Cloud. Se disponibili, i crediti promozionali sono considerati una forma di pagamento e vengono applicati automaticamente per ridurre l'importo totale della fattura.
  • RESELLER_MARGIN: se sei un rivenditore, il tipo di credito margine rivenditore indica gli sconti del Programma per rivenditori guadagnati per ogni voce idonea.
  • SUBSCRIPTION_BENEFIT: crediti guadagnati acquistando abbonamenti a lungo termine a servizi in cambio di sconti.
  • SUSTAINED_USAGE_DISCOUNT: il tipo di credito per sconti per utilizzo sostenuto è uno sconto automatico guadagnato per l'esecuzione di risorse Compute Engine specifiche per una parte significativa del mese di fatturazione.
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 di adjustment_info sono presenti solo se la voce di costo è stata generata in seguito a una modifica della fatturazione Cloud. Può verificarsi una modifica per motivi di correzione o non correzione. Il tipo adjustment_info contiene i dettagli sull'aggiustamento, se è 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 per 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 errato registrato.
  • PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo non corrette.
  • METADATA_CORRECTION: una correzione apportata ai metadati senza modificare il costo.
  • GOODWILL: un credito emesso per il cliente per l'avviamento.
  • SALES_BASED_GOODWILL: un credito emesso per il cliente per l'avviamento nell'ambito di un contratto.
  • SLA_VIOLATION: un credito emesso per il cliente a causa di una violazione di un 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 azzerare il saldo di un account chiuso.
  • GENERAL_ADJUSTMENT: una modifica generale all'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 le voci corrette con utilizzo e costo aggiornati.
  • COMPLETE_NEGATION: la correzione annulla completamente l'utilizzo e il costo originali e non vengono rimonetizzati ulteriori utilizzi.
  • MANUAL_ADJUSTMENT: l'aggiustamento viene assegnato manualmente al costo e all'utilizzo.
export_time Timestamp Tempo di elaborazione associato a un'aggiunta di dati di fatturazione Cloud. Questo valore aumenterà sempre a ogni nuova esportazione.
Vedi anche 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 tag specifico.

tags.value Stringa

Le risorse allegate a un tags.key. In un determinato momento, è possibile collegare un solo valore a una risorsa per una determinata chiave.

tags.inherited Booleano

Indica se un binding dei tag è ereditato (Tags Inherited = True) o diretto/non ereditato (Tags Inherited = False). Puoi creare un'associazione tag a una risorsa principale nella gerarchia delle risorse.

tags.namespace Stringa

Rappresenta la gerarchia delle risorse che definisce la chiave e i valori del 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

I prezzi di listino associati a tutte le voci addebitate al tuo account di fatturazione Cloud.

transaction_type Stringa

Il tipo di transazione del venditore. Il tipo di transazione può 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 nel ruolo di agente.
seller_name Stringa

Il nome legale del venditore.

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 pertinenti alle risorse di servizio (come una macchina virtuale o un'unità SSD) che generano l'utilizzo.

resource.global_name Stringa

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

resource.name Stringa

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

price Struct

Campi che descrivono la struttura e il valore relativi ai prezzi addebitati per l'utilizzo.

price.effective_price Numerico

Il prezzo addebitato per l'utilizzo degli SKU di Google Cloud o Google Maps Platform e dei livelli di prezzo. Se il tuo account di fatturazione Cloud ha prezzi personalizzati del contratto, questo è il prezzo specifico dell'account di fatturazione; in caso contrario, questo è il prezzo di listino dello SKU o del livello SKU.

price.tier_start_amount Numerico

Il numero minimo di unità per il livello di prezzo di uno SKU. Ad esempio, uno SKU con tre livelli di prezzo, ad esempio 0-100 unità, 101-1000 unità e 1001+ unità, mostrerà tre righe di prezzo per lo SKU, con 0, 101 e 1001 nel campo price.tier_start_amount che rappresenta la quantità unitaria iniziale per i livelli di prezzo dello SKU.

Scopri di più sui livelli di prezzo.
price.unit Stringa

L'unità di utilizzo in cui viene specificato il prezzo e viene misurato l'utilizzo delle risorse (ad esempio gibibyte, tebibyte, mese, anno, ora di gibibyte, mese di gibibyte o conteggio). Il valore nel campo price.unit corrisponde al valore nel campo usage.pricing_unit.

price.pricing_unit_quantity Numerico

La quantità unitaria del livello di prezzo di SKU. Ad esempio, se il prezzo del livello è $1 per 1.000.000 byte, allora questa colonna visualizza 1.000.000.

subscription Struct

Campi che descrivono gli impegni basati sulla spesa o sulle risorse. Puoi utilizzare questi campi per analizzare le commissioni per impegni specifici.

subscription.instance_id Stringa

L'ID abbonamento collegato a un impegno.

Informazioni sui dati relativi ai costi di utilizzo standard e dettagliati

Le sezioni seguenti descrivono i dati sul costo di utilizzo standard e sul costo di utilizzo dettagliato 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 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 i 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 riservato tramite prenotazioni zonali ma non utilizzato.
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart Lo stato dell'oggetto di archiviazione addebitato.

Differenze tra dati esportati e fatture

I prodottiGoogle Cloud inviano i dati di utilizzo e di costo ai processi di fatturazione Cloud a intervalli variabili. Di conseguenza, potresti notare un ritardo tra l'utilizzo dei servizi Google Cloud e la disponibilità dell'utilizzo e dei costi nella fatturazione Cloud. In genere, i costi sono disponibili entro un giorno, ma a volte può passare più tempo.

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

Quando esegui query sui costi utilizzando i campi timestamp, i dati restituiti potrebbero rilevare l'utilizzo segnalato in ritardo che non era originariamente incluso nella fattura generata per lo stesso mese di utilizzo. Di conseguenza, i dati di fatturazione Cloud restituiti potrebbero non corrispondere direttamente a quella 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 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 una 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'imposta totale da pagare 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 [vuoto] Tasse 10 $

Per i costi registrati dopo il 1° settembre, i 10 $sono 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 una correzione, vengono aggiunti i dati correttivi. Questi aggiustamenti rientrano in una delle due categorie: modifiche o correzioni alla fatturazione.

Modifiche alla fatturazione

Le modifiche alla fatturazione vengono visualizzate come voci separate. Se hai ricevuto una modifica della fatturazione, una nuova voce 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 ulteriori informazioni sulle modifiche alla fatturazione e su come vengono applicate, consulta la pagina Informazioni su note e aggiustamenti.

Correzioni

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

  • cost
  • credit
  • usage.amount
  • export_time

Ad esempio, supponiamo che ti vengano addebitati 10 $per l'utilizzo di SKU A il 1° gennaio. 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 voci aggiuntive:

  • -10 $ per l'utilizzo del 1° gennaio (annullamento dell'addebito originale)
  • 5 $ per l'utilizzo del 1° gennaio (con l'indicazione dell'addebito previsto)

Questi nuovi elementi 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, eventuali correzioni o addebiti per l'utilizzo con monetizzazione tardiva vengono accumulati e non devi preoccuparti di 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 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 con monetizzazione tardiva:

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 è precedente al mese di fatturazione, consulta Esegui query sui dettagli dei costi per visualizzare le correzioni o l'utilizzo con monetizzazione tardiva 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 di 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 sono in genere considerati una forma di pagamento. Se disponibili, i crediti promozionali vengono applicati automaticamente per ridurre l'importo 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 tuoi crediti promozionali si applicano ai costi calcolati al prezzo di listino, nel report Tabella costi è presente un servizio chiamato Invoice, con uno SKU chiamato Contract billing adjustment. Questo SKU regola i tuoi crediti in modo che si applichino 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, controlli e altre analisi di allocazione dei costi. Puoi anche utilizzare i tag e l'applicazione condizionale dei criteri 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 Costi standard e Costi dettagliati per risorse, progetti, cartelle e organizzazioni includono questi campi per i dati dei tag: Chiave tag, Valore tag, Tag ereditati e Spazio dei nomi dei 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 di Secret Manager
  • Istanze Spanner
  • Database Firestore

Limitazioni dei tag

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

Esempi di query sul costo di utilizzo dettagliato

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

Poiché lo schema del costo di utilizzo dettagliato include tutti i campi dello schema del costo 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 del costo di utilizzo dettagliato. Quando crei query per i dati dettagliati, puoi utilizzare un esempio di query standard come modello, aggiornare il nome della tabella e aggiungere uno qualsiasi dei campi disponibili nello schema dei costi di utilizzo dettagliati.

Valori comuni utilizzati nelle query di costo dettagliate di esempio

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 su una fattura

Le seguenti query mostrano due modi per visualizzare i valori di costo e credito a livello di risorsa in 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 costi e i valori del credito in micro prima di sommarli, poi li riconverte in dollari dopo la somma, evitando l'errore di arrotondamento in virgola mobile.

Somma dei costi per ogni risorsa, per fattura

Questa query mostra il totale delle fatture per 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 regolari, tasse, aggiustamenti ed errori di arrotondamento. Tutti i costi non associati a un elemento a livello di risorsa vengono aggregati nel 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 standard 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 €
5 201901 standard backend1 410,998795012082947 $ 411 $
2 201901 rounding_error backend1 –$0,2404900489920378 –0,24 $
3 201901 tax backend1 $4,105840329977189 4,11 $

Visualizzare una suddivisione dei costi del cluster Google Kubernetes Engine (GKE)

Questa sezione fornisce esempi di filtraggio dei costi dei cluster GKE nei report di esportazione BigQuery. Per saperne di più sui costi dei cluster GKE, consulta Visualizzare la suddivisione dei costi dei cluster.

Filtra i costi di GKE

Gli esempi di query riportati di seguito 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 del 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 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 di 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.

Calcolare 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

Visualizzare i costi delle risorse senza tag

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

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

Report su costi e prezzi disponibili nella console Google Cloud