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:

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.

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.

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.

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 $.

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

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.

• Restituisci i costi a livello di risorsa su una fattura
  • Somma dei costi per ogni risorsa, per fattura
  • Restituisce i dettagli per tipo di costo per ogni risorsa, per mese di fatturazione

• Visualizza la suddivisione dei costi del cluster Google Kubernetes Engine (GKE)
  • Filtra la suddivisione dei costi di GKE

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:

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:

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:

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:

Argomenti correlati

Argomenti correlati ai dati di fatturazione Cloud esportati

• Configurare l'esportazione dei dati di fatturazione Cloud in BigQuery
• Query di esempio per l'esportazione dei dati di fatturazione Cloud in BigQuery
• Visualizzare la spesa nel tempo con Looker Studio

Report su costi e prezzi disponibili nella console Google Cloud

• Visualizzare i report di fatturazione Cloud e le tendenze dei costi
• Visualizzare e scaricare i dettagli dei costi di fatture o estratti conto
• Visualizzare e scaricare i prezzi dei servizi cloud di Google
• Informazioni sui risparmi con i report di dettaglio dei costi
• Analizzare l'efficacia degli sconti per impegno di utilizzo
• Visualizzare la cronologia di costi e pagamenti