Struktur des detaillierten Datenexports

Diese Seite enthält Referenzinformationen zum Schema der detaillierten Cloud Billing-Nutzungskosten, die in jede Tabelle in BigQuery exportiert werden.

Die detaillierten Nutzungskostendaten enthalten alle Informationen, die in den Standard-Nutzungskosten enthalten sind, sowie zusätzliche Felder, die detaillierte Kostendaten auf Ressourcenebene liefern, wie zum Beispiel eine virtuelle Maschine oder SSD, die die Nutzung erzeugt. Der detaillierte Export enthält genaue Kosteninformationen zu folgenden Diensten:

  • Compute Engine
  • Cloud Storage
  • Google Kubernetes Engine (GKE)

    Wenn Sie sich eine Aufschlüsselung der GKE-Clusterkosten in einem detaillierten Datenexport ansehen möchten, müssen Sie auch die Kostenzuordnung für GKE aktivieren.

  • Cloud Functions

  • Cloud Run

  • Cloud SQL

  • Spanner

  • App Engine

  • Firestore und Datastore

  • Memorystore for Redis

  • Bigtable

Detaillierte Kostendaten nach Dienst identifizieren

Wenn Sie detaillierte Kosteninformationen in einem detaillierten Export analysieren möchten, suchen Sie in der folgenden Tabelle nach der Spalte, die Informationen zu bestimmten Ressourcen enthält.

Dienstbeschreibung Säulendiagramm Ressourcen identifizieren
Compute Engine service.description und resource.name oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Cloud Storage service.description und resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Google Kubernetes Engine (GKE) labels.key

Verwenden Sie die folgenden Labelschlüssel, um die Ressourcen zu filtern:

  • goog-fleet-project: Clusterressourcen nach Flotten-Hostprojekt filtern, wenn der Cluster bei einer Flotte registriert ist.
  • goog-k8s-cluster-location: GKE-Ressourcen nach Standort filtern.
  • goog-k8s-cluster-name: Filtern Sie Ihre GKE-Ressourcen nach Cluster.
  • goog-k8s-node-pool-name: Clusterressourcen nach Knotenpool filtern.
  • k8s-namespace: GKE-Ressourcen nach Namespace filtern.
  • k8s-namespace-labels: GKE-Ressourcen nach Namespace-Label der Flotte filtern (nur GKE Enterprise-Kunden).
  • k8s-label: Alle GKE-Ressourcen ansehen.

Wenn Sie detaillierte Kosten für den GKE-Cluster im detaillierten Kostendatenexport aufrufen möchten, müssen Sie auch die Kostenzuordnung für GKE aktivieren.

Siehe Beispielabfragen zum Filtern von GKE-Daten in BigQuery-Exporten.

Cloud Functions service.description und resource.name oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Cloud Run service.description und resource.name oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Cloud SQL service.description und resource.global_name

Die Spalte service.description enthält den Namen des Dienstes und die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Spanner service.description und resource.global_name

Die Spalte service.description enthält den Namen des Dienstes und die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

App Engine service.description und resource.name, oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Firestore und Datastore service.description und resource.name, oder resource.global_name

Die Spalte service.description ist App Engine. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

BigQuery service.description und resource.name, oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Dataflow service.description und resource.name, oder resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.name enthält den vom Nutzer bereitgestellten Namen. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Memorystore for Redis service.description und resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Bigtable service.description und resource.global_name

Die Spalte service.description enthält den Namen des Dienstes. Die Spalte resource.global_name enthält eine eindeutige Kennzeichnung für die Ressource.

Beispiele für das Abfragen detaillierter Daten für Ihre Ressourcen

Detailliertes Datenschema für Nutzungskosten

In Ihrem BigQuery-Dataset werden detaillierte Google Cloud-Daten zu Nutzungskosten in eine Datentabelle mit dem Namen gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID> geladen.

Beachten Sie bei der Verwendung von detaillierten Nutzungskostendaten in BigQuery Folgendes:

  • Beim Auswählen oder Erstellen eines BigQuery-Datasets für Ihre detaillierten Nutzungskostendaten können Sie einen beliebigen Dataset-Standort auswählen, der für die Verwendung mit Cloud Billing-Daten unterstützt wird.
  • Wenn Sie den Export der detaillierten Nutzungskostendaten in Cloud Billing zum ersten Mal aktivieren und ein Dataset auswählen, das für die Verwendung eines multiregionalen Standorts (EU oder US) konfiguriert ist, sind Cloud Billing-Daten rückwirkend ab dem Beginn des Vormonats verfügbar. Daten werden in chronologischer Reihenfolge exportiert. Beim ersten Backfill exportierter Daten kann es bis zu fünf Tage dauern, bis die reaktiven Cloud Billing-Daten abgeschlossen sind und die neuesten Nutzungsdaten angezeigt werden.
  • Wenn Sie den Export der detaillierten Nutzungskostendaten aktivieren und ein Dataset auswählen, das für die Verwendung eines unterstützten regionalen Standorts konfiguriert ist, sind Ihre Cloud Billing-Daten ab dem Datum verfügbar, an dem Sie den Export aktiviert haben.
  • Wenn Sie den Export der detaillierten Nutzungskosten aktiviert, deaktiviert und anschließend wieder aktiviert haben, sind die Cloud Billing-Daten für den Zeitraum, in dem sie explizit deaktiviert wurden, möglicherweise nicht verfügbar.
  • Weitere Informationen zur Häufigkeit, mit der Daten in Ihre BigQuery-Tabellen geladen werden.
  • Weitere Einschränkungen, die sich auf den Export von Abrechnungsdaten in BigQuery auswirken können, z. B. Datasets mit aktivierten vom Kunden verwalteten Verschlüsselungsschlüsseln (Customer-Managed Encryption Keys, CMEK).
  • Berücksichtigen Sie das zusätzliche Datenvolumen, das Ihre BigQuery-Tabellen möglicherweise benötigen, und die zusätzlichen Kosten, wenn Sie detaillierte Nutzungskostendaten anstelle des Exports der Standardnutzungskosten aktivieren. Der erhöhte Detaillierungsgrad von Informationen auf Ressourcenebene kann die Anzahl der Zeilen erhöhen, die im Format Standardnutzungskosten zusammengefasst werden. Weitere Best Practices für die Verwaltung Ihrer BigQuery-Kosten finden Sie unter Kosten in BigQuery kontrollieren.
Feld Typ Beschreibung
billing_account_id String

Die Cloud-Rechnungskonto-ID, mit der die Nutzung verknüpft ist.

Für Reseller: Dies ist die ID eines Cloud-Rechnungsunterkontos, für das die Nutzungskosten generiert werden, und nicht die ID des übergeordneten Cloud-Rechnungskontos des Resellers.

invoice.month String

Das Jahr und der Monat (JJJJMM) der Rechnung, die die Kostenpositionen enthält. Beispiel: "201901" entspricht Januar 2019.

Mit diesem Feld können Sie die Gesamtkosten der Rechnung abrufen. Cloud Billing-Export in BigQuery – Abfragebeispiele

cost_type String

Die Art der Kosten dieser Position: regelmäßige Kosten, Steuern, Korrekturen oder Rundungsfehler.

service.id String Die ID des Dienstes, mit dem die Nutzung verknüpft ist.
service.description String Der Google Cloud-Dienst, der die Cloud Billing-Daten gemeldet hat.
sku.id String Die ID der vom Dienst verwendeten Ressource. Eine vollständige Liste der SKUs finden Sie unter Google Cloud SKUs.
sku.description String Eine Beschreibung des vom Dienst verwendeten Ressourcentyps. Ein Ressourcentyp für Cloud Storage ist beispielsweise Standard Storage US.
usage_start_time Zeitstempel Die Startzeit des stündlichen Nutzungszeitfensters, in dem die auftretenden Kosten berechnet wurden. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich so auf mehrere Stundenzeitfenster.

Weitere Informationen finden Sie in der BigQuery-Dokumentation im Abschnitt über Zeitstempeldatentypen. Weitere Informationen finden Sie außerdem unten im Abschnitt Unterschiede zwischen exportierten Daten und Rechnungen.

usage_end_time Zeitstempel Die Endzeit des stündlichen Nutzungszeitfensters, in dem die auftretenden Kosten berechnet wurden. Nutzung und Kosten werden für alle Dienste mit stündlicher Genauigkeit angezeigt. Eine lange Dauer der Dienstnutzung verteilt sich so auf mehrere Stundenzeitfenster.

Weitere Informationen finden Sie in der BigQuery-Dokumentation im Abschnitt über Zeitstempeldatentypen. Weitere Informationen finden Sie außerdem unten im Abschnitt Unterschiede zwischen exportierten Daten und Rechnungen.

project Struct project enthält Felder, die das Cloud Billing-Projekt beschreiben, z. B. ID, Nummer, Name, Herkunftszahlen und Labels.
project.id String Die ID des Google Cloud-Projekts, das die Cloud Billing-Daten generiert hat.
project.number String Eine intern generierte, anonymisierte, eindeutige Kennung für das Google Cloud-Projekt, das die Cloud Billing-Daten generiert hat. In Ihren Support-Fällen und anderen Kundenkommunikationen wird Google Ihre Projekte anhand dieser Projektnummer zuordnen.
project.name String Der Name des Google Cloud-Projekts, das die Cloud Billing-Daten generiert hat.
project.ancestry_numbers String Die Ancestors in der Ressourcenhierarchie für das Projekt, das durch die angegebene project.id, z. B. "my-project-123", identifiziert wird.

Beispiel: /ParentOrgNumber/ParentFolderNumber/. Weitere Informationen finden Sie im Artikel zur Ressourcenhierarchie.

project.ancestors Struct

In diesem Feld werden die Struktur und der Wert der Ressourcenhierarchie einer Kostenposition beschrieben, einschließlich Projekten, Ordnern und Organisationen. Ancestors werden vom Knoten zum Stamm sortiert (Projekt, Ordner, dann Organisation).

project.ancestors.resource_name String Der relative Ressourcenname für jeden Ancestor im Format "resourceType/resourceNumber". Mit project.ancestors.resource_name erhalten Sie eine ausführlichere Ansicht von project.ancestry_numbers.
project.ancestors.display_name String Der Name, den Sie in der Konsole für Ihre Ressource erstellt haben.
project.labels.key String Wenn Labels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar, das das Label des Google Cloud-Projekts enthält, in dem die Nutzung stattgefunden hat. Weitere Informationen zum Verwenden von Labels finden Sie im Hilfeartikel Labels erstellen und verwalten.
project.labels.value String Wenn Labels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar, das das Label des Google Cloud-Projekts enthält, in dem die Nutzung stattgefunden hat. Weitere Informationen zum Verwenden von Labels finden Sie im Hilfeartikel Labels erstellen und verwalten.
labels.key String Wenn Labels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar, das das Label der Google Cloud-Ressource enthält, in der die Nutzung stattgefunden hat. Weitere Informationen zum Verwenden von Labels finden Sie im Hilfeartikel Labels erstellen und verwalten.
labels.value String Wenn Labels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar, das das Label der Google Cloud-Ressource enthält, in der die Nutzung stattgefunden hat. Weitere Informationen zum Verwenden von Labels finden Sie im Hilfeartikel Labels erstellen und verwalten.
system_labels.key String Wenn Systemlabels vorhanden sind, ist dies der Schlüssel im Schlüssel/Wert-Paar, das das vom System generierte Label der Ressource enthält, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Verfügbare Systemlabels.
system_labels.value String Wenn Systemlabels vorhanden sind, ist dies der Wert im Schlüssel/Wert-Paar, das das vom System generierte Label der Ressource enthält, in der die Nutzung stattgefunden hat. Weitere Informationen finden Sie unter Verfügbare Systemlabels.
location.location String Standort der Nutzung auf der Ebene eines Landes, einer Region oder einer Zone bzw. global für Ressourcen, die keinen festen Standort haben. Weitere Informationen finden Sie unter Geografie und Regionen und Google Cloud-Standorte.
location.country String Wenn location.location ein Land, eine Region oder eine Zone ist, enthält dieses Feld das Land der Nutzung, z. B. US. Weitere Informationen finden Sie unter Geografie und Regionen und Google Cloud-Standorte.
location.region String Wenn location.location eine Region oder Zone ist, enthält dieses Feld die Nutzungsregion, z. B. us-central1. Weitere Informationen finden Sie unter Geografie und Regionen und Google Cloud-Standorte.
location.zone String Wenn location.location eine Zone ist, enthält dieses Feld die Zone der Nutzung, z. B. us-central1-a. Weitere Informationen finden Sie unter Geografie und Regionen und Google Cloud-Standorte.
cost Gleitkommazahl Die Kosten für die Nutzung ohne Gutschriften, mit einer Genauigkeit von bis zu sechs Dezimalstellen. Für Gesamtkosten mit Berücksichtigung von Gutschriften muss den Kosten credits.amount hinzugefügt werden. Weitere Informationen finden Sie in dieser Beispielabfrage.
currency String Die Währung, in der die Kosten abgerechnet werden. Weitere Informationen zur Landeswährung für Abrechnung und Zahlungen
currency_conversion_rate Gleitkommazahl Der Wechselkurs von US-Dollar in die Landeswährung. cost/currency_conversion_rate sind so die Kosten in US-Dollar.
usage.amount Gleitkommazahl Die Menge der verwendeten usage.unit.
usage.unit String Die Basiseinheit, in der die Ressourcennutzung gemessen wird. Die Basiseinheit für Standard Storage ist z. B. Byte-Sekunden.
usage.amount_in_pricing_units Gleitkommazahl Die Menge der verwendeten usage.pricing_unit.
usage.pricing_unit String Die Einheit, in der die Ressourcennutzung gemäß der Cloud Billing Catalog API gemessen wird.
credits Struct credits enthält Felder, die die Struktur und den Wert der Gutschriften beschreiben, die mit Google Cloud- und Google Maps Platform-Artikelnummern verknüpft sind.
credits.id String Falls vorhanden, weist das Attribut auf eine Gutschrift hin zu der Produkt-SKU hin. credits.id-Werte sind entweder eine eindeutige alphanumerische Kennung, (z. B. 12-b34-c56-d78) oder eine Beschreibung des Guthabentyps (z. B. Rabatt für zugesicherte Nutzung: CPU).

Wenn das Feld credits.id leer ist, wird die Produkt-SKU mit keiner Gutschrift verknüpft.

credits.full_name String Der Name der Gutschrift, die mit der Artikelnummer des Produkts verknüpft ist. Dies ist eine für Menschen lesbare Beschreibung eines alpha-numerischen credits.id. Beispiele sind Guthaben für den kostenlosen Testzeitraum oder ausgabenbasierte Rabatte für die zugesicherte Nutzung.

credits.full_name-Werte sind nur für Artikelnummern mit einem alphanumerischen credits.id vorhanden. Wenn der Wert von credits.id eine Beschreibung des Gutschriftstyps ist (z. B. Rabatt für zugesicherte Nutzung: CPU), dann ist das Feld credits.full_name leer.

credits.type String Dieses Feld beschreibt den Zweck oder Ursprung des credits.id. Es gibt folgende Gutschriftentypen:
  • COMMITTED_USAGE_DISCOUNT: Ressourcenbasierte Verträge für zugesicherte Nutzung, die für Compute Engine erworben werden und im Gegenzug erhebliche Rabatte auf die VM-Nutzung erhalten.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Ausgabenbasierte Verträge mit Nutzungszusage, die für Dienstleistungen im Austausch gegen Ihre Zusage, einen Mindestbetrag auszugeben, erworben werden.
  • DISCOUNT: Der Rabatttyp wird für Gutschriften verwendet, die Sie nach Erreichen eines vertraglich festgelegten Ausgabenbetrags erhalten haben. In den Cloud Billing-Berichten, die in der Google Cloud Console verfügbar sind, wird der Rabatttyp als Ausgabenbasierte Rabatte (vertraglich) aufgeführt.
  • FREE_TIER: Einige Dienste bieten kostenlose Ressourcennutzung bis zu einem bestimmten Limit. Bei diesen Diensten wird mit Gutschriften die Nutzung der kostenlosen Stufe implementiert.
  • PROMOTION: Der Gutschriftentyp „Promotion“ umfasst einen kostenlosen Testzeitraum von Google Cloud, Gutschriften für Marketingkampagnen oder andere Zuwendungen zur Nutzung von Google Cloud. Angebotsgutschriften werden als Zahlungsart betrachtet und automatisch angewendet, um die Gesamtkosten zu reduzieren.
  • RESELLER_MARGIN: Wenn Sie Reseller sind, zeigt der Gutschriftentyp Reseller_Margin die Rabatte für das Reseller-Programm für jede infrage kommende Position an.
  • SUBSCRIPTION_BENEFIT: Gutschriften, die Sie durch den Kauf eines langfristigen Abos für Dienste erhalten.
  • SUSTAINED_USAGE_DISCOUNT: Der Gutschriftentyp „Rabatte für kontinuierliche Nutzung“ ist ein automatischer Rabatt, den Sie erhalten, wenn Sie bestimmte Compute Engine-Ressourcen für einen erheblichen Teil des Abrechnungsmonats nutzen.
credits.name String Eine Beschreibung der Gutschrift, die auf das Cloud-Rechnungskonto angewendet wurde.
credits.amount Gleitkommazahl Der Betrag der Gutschrift, die auf die Nutzung angerechnet wird.
adjustment_info Struct adjustment_info enthält Felder, die die Struktur und den Wert einer Korrektur an Kostenpositionen beschreiben, die einem Cloud-Rechnungskonto zugeordnet sind.

Werte von adjustment_info sind nur vorhanden, wenn die Kostenposition für eine Cloud Billing-Änderung generiert wurde. Die Änderung kann als Korrektur oder aus anderen Gründen vorgenommen werden. Der Typ adjustment_info enthält Details zur Korrektur, unabhängig davon, ob sie zur Behebung eines Fehlers oder aus anderen Gründen vorgenommen wurde.

adjustment_info.id String Falls vorhanden, weist dies auf eine Anpassung an eine Kostenposition hin. adjustment_info.id ist die eindeutige ID für alle Anpassungen, die durch ein Problem verursacht werden.
adjustment_info.description String Eine Beschreibung der Korrektur und ihre Ursache.
adjustment_info.type String

Die Art der Anpassung.

Zu den Typen gehören:

  • USAGE_CORRECTION: Eine Korrektur aufgrund einer falschen Nutzung.
  • PRICE_CORRECTION: Eine Korrektur aufgrund falscher Preismodellregeln.
  • METADATA_CORRECTION: Eine Korrektur, um Metadaten zu korrigieren, ohne die Kosten zu ändern.
  • GOODWILL: Ein Guthaben, das dem Kunden gutgeschrieben wird.
  • SALES_BASED_GOODWILL: Ein Guthaben, das dem Kunden als Dritter für einen Vertrag ausgestellt wird.
  • SLA_VIOLATION: Ein Guthaben, das dem Kunden aufgrund eines Verstoßes gegen das Service Level Objective (SLO) ausgestellt wird.
  • BALANCE_TRANSFER: Eine Korrektur, um Geld von einem Zahlungskonto auf ein anderes zu übertragen.
  • ACCOUNT_CLOSURE: Eine Korrektur, um ein geschlossenes Konto auf null zu bringen.
  • GENERAL_ADJUSTMENT: Eine allgemeine Abrechnungskontoänderung
adjustment_info.mode String

Art der Korrektur.

Zu den Modi gehören:

  • PARTIAL_CORRECTION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten teilweise negiert.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten vollständig geschätzt und die korrigierten Werbebuchungen mit aktualisierter Nutzung und Kosten korrigiert.
  • COMPLETE_NEGATION: Bei der Korrektur werden die ursprüngliche Nutzung und die Kosten vollständig geschätzt. Weitere Informationen werden nicht wieder monetarisiert.
  • MANUAL_ADJUSTMENT: Die Anpassung wird manuell Kosten und Nutzung zugeordnet.
export_time Zeitstempel Die mit neu angehängten Cloud Billing-Daten verbundene Verarbeitungszeit. Dieser Zeitraum verlängert sich mit jedem neuen Export.
Weitere Informationen finden Sie außerdem unten im Abschnitt Unterschiede zwischen exportierten Daten und Rechnungen.
tags Struct

Felder, die das Tag beschreiben, z. B. Schlüssel, Wert und Namespace.

tags.key String

Der Kurz- oder Anzeigename des Schlüssels, der mit diesem Tag verknüpft ist.

tags.value String

Die mit einem tags.key verknüpften Ressourcen. Für einen bestimmten Schlüssel kann jeweils immer genau ein Wert an eine Ressource angehängt werden.

tags.inherited Boolesch

Gibt an, ob eine Tag-Bindung übernommen wurde (Tags „übernommen = wahr“) oder direkt/nicht übernommen (Tags „übernommen = falsch“). Sie können eine Tag-Bindung für eine übergeordnete Ressource in der Ressourcenhierarchie erstellen.

tags.namespace String

Stellt die Ressourcenhierarchie dar, in der Tag-Schlüssel und -Werte definiert werden. Namespace kann mit den Tag-Schlüssel- und Tag-Wert-Kurznamen kombiniert werden, um einen global eindeutigen und voll qualifizierten Namen für den Tag-Schlüssel oder den Tag-Wert zu erstellen.

cost_at_list Gleitkommazahl

Die Listenpreise, die allen Positionen zugeordnet sind, die Ihrem Cloud-Rechnungskonto in Rechnung gestellt werden.

transaction_type String

Der Transaktionstyp des Verkäufers. Folgende Transaktionstypen sind möglich:

  • GOOGLE = 1: Von Google Cloud verkaufte Dienste.
  • THIRD_PARTY_RESELLER = 2: Drittanbieterdienste, die von Google Cloud weiterverkauft werden.
  • THIRD_PARTY_AGENCY = 3: Drittanbieterdienste, die von einem Partner verkauft werden, wobei Google Cloud als Agent fungiert.
seller_name String

Der rechtliche Name des Verkäufers.

Zusätzliche Felder, die für den Export detaillierter Nutzungskostendaten verfügbar sind
resource Struct

Felder, in denen die Struktur und der Wert von Informationen beschrieben werden, die für Dienstressourcen (z. B. virtuelle Maschinen oder SSDs) relevant sind, die eine Nutzung generieren.

resource.global_name String

Eine global eindeutige Dienstkennung für die Ressource, die eine relevante Nutzung generiert hat.

resource.name String

Eine dienstspezifische Kennung für die Ressource, die eine relevante Nutzung generiert hat. Das kann eine vom Nutzer generierte Eingabe sein.

price Struct

Felder, die Struktur und Wert im Bezug auf Nutzungskosten beschreiben.

price.effective_price Numerisch

Der Preis für die Nutzung der Google Cloud- oder Google Maps Platform-SKUs und die SKU-Preisstufen. Wenn Ihr Cloud-Rechnungskonto benutzerdefinierte Vertragspreise enthält, ist dies Ihr kontospezifischer Preis. Andernfalls ist dies der Listenpreis der SKU oder SKU-Stufe.

price.tier_start_amount Numerisch

Die Untergrenze für Einheiten für die Preisstufe einer Artikelnummer. Beispiel: Eine SKU mit drei Preisstufen (1 bis 100 Einheiten, 101 bis 1.000 Einheiten und mehr als 1.001 Einheiten) zeigt drei Preiszeilen für die SKU (0, 101 und 1.001) im price.tier_start_amount-Feld an, das die Starteinheitsmenge für die SKU-Preisstufen darstellt.

Weitere Informationen zu Preisstufen.
price.unit String

Die Nutzungseinheit, in der die Preise angegeben und die Ressourcennutzung gemessen wird (z. B. Gibibyte, Tebibyte, Monat, Jahr, Gibibyte-Stunde, Gibibyte pro Monat oder Anzahl). Der Wert im price.unit-Feld entspricht dem Wert im usage.pricing_unit-Feld.

price.pricing_unit_quantity Numerisch

Die Einheitsmenge der Preisstufe für die SKU. Wenn z. B. der Stufenpreis 1 $ pro 1.000.000 Byte ist, wird in dieser Spalte 1000000 angezeigt.

subscription Struct

Felder, die Ihre ausgaben- oder ressourcenbasierten Zusicherungen beschreiben. Mit diesen Feldern können Sie Ihre Gebühren für bestimmte Zusicherungen analysieren.

subscription.instance_id String

Die Abo-ID, die mit einer Nutzungszusicherung verknüpft ist.

Standardnutzungskosten und detaillierte Nutzungskosten

In den folgenden Abschnitten werden die Standardnutzungskosten und die detaillierten Nutzungskostendaten beschrieben, die nach BigQuery exportiert werden.

Über Labels

Die Kostendaten für ein bestimmtes Label zeigen nur die Nutzung ab dem Datum, ab dem das Label auf eine Ressource angewendet wurde. Wenn Sie beispielsweise einer Compute Engine-VM am 15. Januar 2024 das Label environment:dev hinzufügen, enthält die Analyse für environment:dev nur die Nutzung für diese VM seit dem 15. Januar 2024.

Es können auch Labeldaten zu unterschiedlichen Zeiten für verschiedene Dienste angezeigt werden, je nachdem, wann der jeweilige Dienst sie bereitstellt.

Verfügbare Systemlabels

Systemlabels sind Schlüssel/Wert-Paare für wichtige Metadaten zu der Ressource, mit der die Nutzung generiert wurde. Die folgenden Systemlabels sind bei der jeweiligen Nutzung automatisch enthalten.

system_labels.key system_labels.value-Beispiel Beschreibung
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Konfiguration der virtuellen Maschine. Weitere Informationen finden Sie unter Maschinentypen.
compute.googleapis.com/cores Für n1-Standard-4 ist dies 4; für custom-2-2048 ist dies 2 Die Anzahl der vCPUs, die der virtuellen Maschine zur Verfügung stehen.
compute.googleapis.com/memory Für n1-Standard-4 ist dies 15.360 (15 GB * 1.024 MB/GB); für custom-2-2048 ist dies 2.048 Die Speicherkapazität (in MB), die der virtuellen Maschine zur Verfügung steht.
compute.googleapis.com/is_unused_reservation true; false Gibt die Nutzung an, die über zonale Reservierungen reserviert wurde, aber nicht verwendet wurde.

Unterschiede zwischen exportierten Daten und Rechnungen

Google Cloud-Produkte melden Nutzungs- und Kostendaten in unterschiedlichen Intervallen an Cloud Billing-Vorgänge. Deshalb kann es zu einer Verzögerung zwischen der Nutzung von Google Cloud-Diensten und der Nutzung und Kosten kommen, die in Cloud Billing angezeigt werden. In der Regel sind Ihre Kosten innerhalb eines Tages verfügbar, manchmal kann es aber auch mehr als 24 Stunden dauern.

Am Ende eines Kalendermonats kann es daher sein, dass eine spät gemeldete Nutzung möglicherweise nicht auf die Rechnung des betreffenden Monats kommt, sondern möglicherweise erst auf der Rechnung des nächsten Monats zu finden ist.

Wenn Sie Ihre Kosten mithilfe von Zeitstempelfeldern abfragen, können die zurückgegebenen Daten eine nach dem Abrechnungszyklus gemeldete Nutzung enthalten, die nicht in der Rechnung für den jeweiligen Nutzungsmonat enthalten war. In diesem Fall werden die zurückgegebenen Cloud Billing-Daten möglicherweise nicht direkt dieser Rechnung zugeordnet.

Zu den Zeitstempelfeldern gehören:

  • usage_start_time
  • usage_end_time
  • export_time

Zur Rückgabe von Cloud Billing-Daten, die direkt einer Rechnung zugeordnet sind, führen Sie eine Abfrage für invoice.month anstelle von Zeitstempelfeldern aus.

Steuern

Ab dem 1. September 2020 wird Ihre Steuerpflicht in den Nutzungskosten nicht mehr als einzelne Position, sondern für jedes einzelne Projekt angezeigt. Wenn Sie Abfragen oder Visualisierungen haben, die von Steuerdaten abhängen, müssen Sie möglicherweise die Abfragen aktualisieren, damit diese Änderungen berücksichtigt werden.

Zum Beispiel sahen bei Kosten, die vor dem 1. September erfasst wurden, die Nutzungskostendaten ähnlich wie im folgenden Beispiel aus. Dabei beträgt die Steuerschuld 10 $.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Regulär 60 $
123456-ABCDEF-123456 test-project Regulär 40 $
123456-ABCDEF-123456 [empty] Steuer 10 $

Bei Kosten, die nach dem 1. September erfasst werden, wird der Betrag über 10 $ in 6 $ für example-project und 4 $ fürtest-project aufgeteilt:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Regulär 60 $
123456-ABCDEF-123456 test-project Regulär 40 $
123456-ABCDEF-123456 example-project Steuer 6 $
123456-ABCDEF-123456 test-project Steuer 4 $

Fehler und Korrekturen

In dem seltenen Fall, dass Ihre Cloud Billing-Daten einen Fehler enthalten oder angepasst werden müssen, werden den Daten Korrekturdaten hinzugefügt. Solche Anpassungen fallen in eine von zwei Kategorien: Änderungen oder Korrekturen der Abrechnung.

Änderungen an der Abrechnung

Änderungen an Abrechnungen werden als separate Positionen angezeigt. Wenn Sie eine Abrechnungsänderung erhalten haben, wird diese in einer neuen Position in Ihrem Cloud Billing-Export nach BigQuery angezeigt. Die angezeigten Korrekturen entsprechen den Rechnungen, Gutschriften und Lastschriften, die in der Google Cloud Console im Bereich Abrechnung unter Dokumente verfügbar sind.

Weitere Informationen zu Abrechnungsänderungen und zu deren Anwendung finden Sie unter Gut-/Lastschriften und Anpassungen verstehen.

Korrekturen

Korrekturen werden als neue Daten angezeigt, durch die falsche Daten in den Quell-SKUs negiert werden. In einigen Fällen werden falsche Gebühren durch neue Daten ersetzt. Alle Spalten im Abrechnungsdatenexport entsprechen den Originaldaten, mit Ausnahme der folgenden Spalten:

  • cost
  • credit
  • usage.amount
  • export_time

Angenommen, Ihnen wurden am 1. Januar 10 $ für die Nutzung von SKU A in Rechnung gestellt. Auf Ihrer Rechnung für Januar (Anfang Februar ausgestellt) sehen Sie eine Belastung von 10 $ für SKU A. Am 2. Februar hat Google Cloud eine Korrektur in Bezug auf SKU A vorgenommen, wodurch die Nutzungskosten auf 5 $ reduziert wurden. Ihre Rechnung für Februar (Anfang März ausgestellt) enthält zwei zusätzliche Positionen:

  • -10 $ für die Nutzung am 1. Januar (Rücknahme der ursprünglichen Gebühr)
  • 5 $ für die Nutzung am 1. Januar (Angabe der korrekten Gebühr)

Diese neuen Elemente haben im Export der Abrechnungsdaten die Spalte adjustment_info. Die ursprüngliche Rechnung für Januar, auf der die Überbelastung aufgeführt ist, wird nicht angepasst. Sie können Ihre Gebühren im Export der Abrechnungsdaten prüfen, wozu Sie die Kosten nach usage_start_time aufrufen und nach Day gruppieren. In diesen Ansichten werden Korrekturen oder Gebühren für die verspätet monetarisierte Nutzung erfasst. Über vorübergehend falsche Daten müssen Sie sich keine Gedanken machen.

Wenn Sie genauere Informationen zu Ihren Korrekturen benötigen, rufen Sie alle Gebühren eines Rechnungsmonats auf und suchen Sie nach den Gebühren, bei denen das Nutzungsdatum vor dem Rechnungsmonat liegt. Diese Gebühren sind das Ergebnis von Korrekturen oder einer verspäteten Monetarisierung.

Im folgenden Codebeispiel wird gezeigt, wie Sie eine Abfrage zu diesem Zweck erstellen:

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';

Startguthaben in benutzerdefinierten Verträgen

Wenn Sie einen benutzerdefinierten Preisvertrag haben, erhalten Sie möglicherweise Startguthaben, die im Rahmen des Vertrags in Google Cloud angewendet werden können. Beispielsweise können Sie 1.000 USD Guthaben für die Verwendung von Compute Engine-Ressourcen erhalten. Startguthaben gelten in der Regel als Zahlungsmittel. Vorhandenes Startguthaben wird automatisch zur Reduzierung Ihres Rechnungsbetrages verwendet.

Ihr Vertrag gibt an, ob das Startguthaben auf Ihre Kosten angerechnet wird, die zum Listenpreis einer Artikelnummer berechnet werden, oder auf den Nettopreis (nach Rabatten).

Das Startguthaben wird auf Kosten angerechnet, die zum Listenpreis berechnet werden. Im Kostentabellenbericht ist dazu ein Service namens Invoice mit einer Artikelnummer namens Contract billing adjustment aufgeführt. Mit dieser Artikelnummer werden Ihr Gutschriften angepasst, sodass sie auf die Kosten zum Listenpreis angerechnet werden können. Fragen Sie die system.labels-Spalten ab, um die Nutzung zu sehen, für die die Anpassung gilt. Der Schlüssel in system.labels.key ist cloud-invoice.googleapis.com/sku_id und der Wert in system.labels.value enthält die SKU-ID, der die Gutschrift und die Anpassung zugeordnet wurden.

Tags

Tags sind Ressourcen in Form von Schlüssel/Wert-Paaren, die direkt oder durch Übernahmen an Ressourcen angehängt werden können. Sie können Tags verwenden, um Rückbuchungen, Audits und andere Analysen zur Kostenzuordnung durchzuführen. Tags und die bedingte Erzwingung von Richtlinien ermöglichen es Ihnen auch, die Ressourcenhierarchie genau zu steuern.

Tags haben ein robustes Berechtigungsmodell und können die Übernahme, die zentralisierte Verwaltung, die Nomenklaturstandardisierung und die Einbindung von Richtlinien-Engines unterstützen. Labels sind dagegen ein separates Tool, mit dem Sie Ressourcen annotieren können.

Tag-Daten werden in BigQuery-Exporten für Ressourcen, Projekte, Ordner und Organisationen angezeigt.

Verfügbare Tags

Die Exporte für Standardkosten und detaillierte Kosten für Ressourcen, Projekte, Ordner und Organisationen enthalten folgende Felder für Tag-Daten: Tag-Schlüssel, Tag-Wert, übernommene Tags und Tag-Namespace.

Tags auf Ressourcenebene im Cloud Billing-Datenexport sind für die folgenden Ressourcen verfügbar:

  • Compute Engine-Instanzen
  • Cloud Storage-Buckets
  • Cloud Spanner-Instanzen
  • Cloud Run-Dienste und -Jobs
  • Artifact Registry-Repositories
  • Memorystore for Redis-Instanzen

Tag-Beschränkungen

  • Es kann bis zu einer Stunde dauern, bis Tags an BigQuery-Exporte übertragen werden. Wenn ein Tag innerhalb einer Stunde hinzugefügt oder entfernt wurde oder eine Ressource weniger als eine Stunde lang existiert, wird sie möglicherweise nicht im Export angezeigt.

Abfragebeispiele zu detaillierten Nutzungskosten

Dieser Abschnitt enthält Beispiele für die Abfrage von detaillierten Cloud Billing-Nutzungskosten, die nach BigQuery exportiert werden.

Da das Schema der detaillierten Nutzungskosten alle Felder aus dem Schema der Standardnutzungskosten umfasst, funktionieren die nach BigQuery exportierten Standarddaten auch mit den exportierten detaillierten Daten. Beachten Sie, dass die Abfragebeispiele für Standardnutzungskosten nicht zum Abrufen von Informationen auf Ressourcenebene geschrieben sind, die mit der Exportoption für detaillierte Nutzungskosten bereitgestellt werden. Beim Erstellen von Abfragen für die detaillierten Daten können Sie ein Standardabfragebeispiel als Vorlage verwenden, den Tabellennamen aktualisieren und alle Felder hinzufügen, die im Schema der detaillierten Nutzungskosten verfügbar sind.

Allgemeine Werte, die in den Abfragebeispielen zu detaillierten Nutzungskosten verwendet werden

In den Abfragebeispielen in diesem Abschnitt wird als Tabellenname der folgende Wert verwendet: project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX

Kosten auf Ressourcenebene einer Rechnung zurückgeben

Die folgenden Abfragen zeigen zwei Möglichkeiten, wie Sie sich Kosten und Gutschriften auf Ressourcenebene in einer Rechnung mithilfe von exportierten Abrechnungsdaten anzeigen lassen können.

  • Im Feld total werden die Gleitkommawerte für Kosten und Gutschriften direkt summiert. Dadurch kann es zu Rundungsfehlern kommen.
  • Das Feld total_exact wandelt die Kosten- und Gutschriftswerte vor dem Summieren in "Micros" um. Nach dem Summieren werden diese wieder in Dollar umgewandelt und so Rundungsfehler mit Gleitkommazahlen vermieden.

Summe der Kosten für jede Ressource pro Rechnung

Diese Abfrage zeigt die Rechnungssumme für jeden resource.name pro Monat als Summe der regelmäßigen Kosten, Steuern, Korrekturen und Rundungsfehler. Alle Kosten, die keinem Element auf Ressourcenebene zugeordnet sind, werden unter dem Namen null für den Monat zusammengefasst.

Standard-SQL

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
;

Das Ergebnis der vorherigen Abfrage kann beispielsweise so aussehen:

Zeile Monat name Summe Summe (genau)
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 $

Details zu den zurückgegebenen Daten nach Kostenart für jede Ressource und pro Rechnungsmonat

Diese Abfrage ergibt die Gesamtsummen für jeden cost_type für jeden resource.name pro Monat. Kostenarten umfassen regelmäßige Kosten, Steuern, Korrekturen und Rundungsfehler. Alle Kosten, die keinem Element auf Ressourcenebene zugeordnet sind, werden unter dem Namen null für den Monat zusammengefasst.

Standard-SQL

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
;

Das Ergebnis der vorherigen Abfrage kann beispielsweise so aussehen:

Zeile Monat Kostenart name Summe Summe (genau)
1 201901 Regelmäßige Kosten Null 1000,501209987994782 $ 1000,50 $
2 201901 Rundungsfehler Null -0,500489920049387 $ -0,50 $
3 201901 Steuer Null 10,000329958477891 $ 10,00 $
4 201901 Korrektur Null -5,002572999387045 $ -5,00 $
5 201901 Regelmäßige Kosten backend1 410.998795012082947 $ 411.00 $
2 201901 Rundungsfehler backend1 –0,2404900489920378 $ –0,24 $
3 201901 Steuer backend1 4,105840329977189 $ 4,11 $

Aufschlüsselung der GKE-Clusterkosten (Google Kubernetes Engine) abrufen

Dieser Abschnitt enthält Beispiele zum Filtern von GKE-Clusterkosten in Ihren BigQuery-Exportberichten. Weitere Informationen zu den GKE-Clusterkosten finden Sie unter Aufschlüsselung der Clusterkosten ansehen.

GKE-Kosten filtern

Die folgenden Beispielabfragen zeigen, wie Sie Ihre GKE-Kosten für unterstützte Ressourcentypen nach Clustername, Namespace und Label filtern und gruppieren können.

Kosten für GKE-Cluster vor Gutschriften

SELECT
  SUM(cost) AS cost_before_credits,
  labels.value AS cluster_name
FROM  `project.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
;

GKE-Kosten nach Gutschriften nach Namespace

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

GKE-Kosten nach 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.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
;

Abfragebeispiele mit Tags

Die folgenden Beispiele zeigen Möglichkeiten zum Abfragen von Daten mit Tags.

Kosten nach Rechnungsmonat mit Tags berechnen

Die folgende Abfrage zeigt, wie Sie die Rücksendekosten nach Rechnungsmonat für das Tag cost_center verwenden können.

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 `ivory-vim-309221.billing_export_dataset.gcp_billing_export_resource_v1_018ADD_3CEBBB_A4DF22`, 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;

Das Ergebnis der vorherigen Abfrage kann beispielsweise so aussehen:

Row 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 Personalisierung 16,08

Kosten für nicht getaggte Ressourcen aufrufen

Diese Abfrage zeigt die Rechnungssumme für nicht getaggte Ressourcen, gruppiert nach Rechnungsmonat.

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

Das Ergebnis der vorherigen Abfrage kann beispielsweise so aussehen:

Row 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

Kosten- und Preisberichte in der Google Cloud Console