Struktur ekspor data Mendetail

Dokumen ini memberikan informasi referensi untuk skema data biaya penggunaan mendetail Penagihan Cloud yang diekspor ke setiap tabel di BigQuery.

Data biaya penggunaan mendetail memberikan semua informasi yang disertakan dalam data biaya penggunaan standar, beserta kolom tambahan yang menyediakan data biaya tingkat resource terperinci, seperti virtual machine atau SSD yang menghasilkan penggunaan. Ekspor mendetail mencakup informasi biaya terperinci tentang layanan berikut:

  • AlloyDB untuk PostgreSQL
  • App Engine
  • BigQuery
  • Bigtable
  • Cloud Data Fusion
  • Cloud Deploy
  • Fungsi Cloud Run
  • Cloud Logging
  • Cloud Run
  • Cloud SQL
  • Cloud Storage
  • Compute Engine
  • Dataflow
  • Dataproc Metastore
  • Firestore dan Datastore
  • Google Kubernetes Engine (GKE)
    Untuk melihat perincian biaya cluster GKE dalam ekspor data mendetail, Anda juga harus mengaktifkan alokasi biaya untuk GKE.
  • Microsoft AD Terkelola
  • Memorystore for Redis
  • Secret Manager
  • Spanner

Mengidentifikasi data biaya terperinci berdasarkan layanan

Untuk menganalisis informasi biaya terperinci dalam ekspor mendetail, gunakan tabel berikut untuk mengidentifikasi kolom yang berisi informasi tentang resource tertentu.

Deskripsi layanan Kolom Cara mengidentifikasi resource
AlloyDB untuk PostgreSQL service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

App Engine service.description dan resource.name, atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

BigQuery service.description dan resource.name, atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Bigtable service.description dan resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.global_name berisi ID unik untuk resource.

Cloud Data Fusion service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Cloud Deploy service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Fungsi Cloud Run service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Cloud Logging service.description dan resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.global_name berisi ID unik untuk resource.

Cloud Run service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Cloud SQL service.description dan resource.global_name

Kolom service.description berisi nama layanan, dan kolom resource.global_name berisi ID unik untuk resource.

Cloud Storage service.description dan resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.global_name berisi ID unik untuk resource.

Compute Engine service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Dataflow service.description dan resource.name, atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Dataproc Metastore service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Firestore dan Datastore service.description dan resource.name, atau resource.global_name

Kolom service.description akan menjadi App Engine. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Google Kubernetes Engine (GKE) labels.key

Gunakan kunci label berikut untuk memfilter resource:

  • goog-fleet-project: Memfilter resource cluster berdasarkan project host fleet, jika cluster terdaftar ke fleet.
  • goog-k8s-cluster-location: Memfilter resource GKE berdasarkan lokasi.
  • goog-k8s-cluster-name: Memfilter resource GKE berdasarkan cluster.
  • goog-k8s-node-pool-name: Memfilter resource cluster Anda berdasarkan node pool.
  • k8s-namespace: Memfilter resource GKE berdasarkan namespace.
  • k8s-namespace-labels: Memfilter resource GKE Anda berdasarkan label namespace fleet (khusus pelanggan GKE Enterprise).
  • k8s-label: Melihat semua resource GKE Anda.

Untuk melihat biaya cluster GKE terperinci dalam ekspor data biaya mendetail, Anda juga harus mengaktifkan alokasi biaya untuk GKE.

Lihat contoh kueri untuk memfilter data GKE dalam ekspor BigQuery.

Microsoft AD Terkelola service.description dan resource.name atau resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Memorystore for Redis service.description dan resource.global_name

Kolom service.description berisi nama layanan. Kolom resource.global_name berisi ID unik untuk resource.

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

Kolom service.description berisi nama layanan. Kolom resource.name berisi nama yang diberikan oleh pengguna. Kolom resource.global_name berisi ID unik untuk resource.

Spanner service.description dan resource.global_name

Kolom service.description berisi nama layanan, dan kolom resource.global_name berisi ID unik untuk resource.

Lihat contoh meng-kueri data terperinci untuk resource Anda.

Skema data biaya penggunaan mendetail

Dalam set data BigQuery, data biaya penggunaan Google Cloud mendetail dimuat ke dalam tabel data bernama gcp_billing_export_resource_v1_<BILLING_ACCOUNT_ID>.

Saat Anda menggunakan data biaya penggunaan mendetail di BigQuery, perhatikan hal-hal berikut:

  • Saat memilih atau membuat set data BigQuery untuk data biaya penggunaan mendetail, Anda dapat memilih lokasi set data yang didukung untuk digunakan dengan data Penagihan Cloud.
  • Saat Anda mengaktifkan ekspor data biaya penggunaan mendetail untuk pertama kalinya di Penagihan Cloud, jika Anda memilih set data yang dikonfigurasi untuk menggunakan lokasi multi-region (Uni Eropa atau Amerika Serikat), data Penagihan Cloud akan tersedia secara retroaktif dari awal bulan sebelumnya. Data diekspor dalam urutan kronologis. Untuk pengisian ulang awal data yang diekspor, mungkin perlu waktu hingga lima hari agar data Penagihan Cloud berlaku surut Anda selesai diekspor sebelum Anda mulai melihat data penggunaan terbaru.
  • Jika Anda mengaktifkan ekspor data biaya penggunaan mendetail dan memilih set data yang dikonfigurasi untuk menggunakan lokasi region yang didukung, data Penagihan Cloud Anda akan tersedia mulai dari tanggal saat Anda mengaktifkan ekspor.
  • Jika Anda mengaktifkan, menonaktifkan, lalu mengaktifkan kembali ekspor data biaya penggunaan mendetail, data Penagihan Cloud mungkin tidak tersedia selama periode saat ekspor data dinonaktifkan secara eksplisit.
  • Pelajari frekuensi pemuatan data ke tabel BigQuery lebih lanjut.
  • Lihat batasan lain yang mungkin memengaruhi ekspor data penagihan Anda ke BigQuery, seperti set data dengan kunci enkripsi yang dikelola pelanggan (CMEK) diaktifkan.
  • Pertimbangkan volume data tambahan yang mungkin diperlukan tabel BigQuery Anda dan biaya tambahan saat mengaktifkan data biaya penggunaan mendetail, bukan ekspor data biaya penggunaan standar. Peningkatan Perincian informasi tingkat resource dapat meningkatkan jumlah baris, yang digabungkan dalam format biaya penggunaan standar. Sebaiknya tinjau Mengontrol biaya di BigQuery untuk mengetahui praktik terbaik lebih lanjut dalam mengelola biaya BigQuery.
Kolom Jenis Deskripsi
billing_account_id String

ID akun Penagihan Cloud yang terkait dengan penggunaan.

Untuk reseller: Untuk biaya penggunaan yang dihasilkan oleh sub-akun Penagihan Cloud, ini adalah ID sub-akun, bukan ID akun Penagihan Cloud reseller induk.

invoice.month String

Tahun dan bulan (YYYYMM) invoice yang menyertakan item baris biaya. Misalnya: "201901" setara dengan Januari 2019.

Anda dapat menggunakan kolom ini untuk mendapatkan total tagihan di invoice. Lihat Contoh Kueri Ekspor Penagihan Cloud ke BigQuery.

invoice.publisher_type String

Menunjukkan penayang yang terkait dengan transaksi. Kolom ini mendukung pemisahan invoice antara transaksi yang dilakukan langsung dengan Google (pihak pertama), dan transaksi yang dilakukan dengan partner (pihak ketiga), yang juga menunjukkan peraturan yang mungkin berlaku untuk transaksi tersebut.

Nilai yang memungkinkan adalah:
  • GOOGLE: Transaksi pihak pertama yang tidak diatur oleh Google Cloud.
  • PARTNER: Transaksi pihak ketiga, yang diatur atau tidak diatur oleh partner.
cost_type String

Jenis biaya yang dijelaskan dalam item baris ini: reguler, pajak, penyesuaian, atau kesalahan pembulatan.

service.id String ID layanan yang terkait dengan penggunaan.
service.description String Layanan Google Cloud yang melaporkan data Penagihan Cloud.
sku.id String ID resource yang digunakan oleh layanan. Untuk mengetahui daftar lengkap SKU, lihat SKU Google Cloud.
sku.description String Deskripsi jenis resource yang digunakan oleh layanan. Misalnya, jenis resource untuk Cloud Storage adalah Standard Storage AS.
usage_start_time Stempel waktu Waktu mulai periode penggunaan per jam yang menjadi waktu penghitungan biaya tertentu. Penggunaan dan biaya untuk semua layanan ditampilkan dengan tingkat perincian per jam, yang berarti penggunaan layanan yang berjalan lama tersebar di beberapa periode per jam.

Untuk informasi selengkapnya, lihat dokumentasi BigQuery tentang jenis data stempel waktu. Lihat juga, Perbedaan antara data yang diekspor dan invoice.

usage_end_time Stempel waktu Waktu berakhir periode penggunaan per jam yang menjadi waktu penghitungan biaya tertentu. Penggunaan dan biaya untuk semua layanan ditampilkan dengan tingkat perincian per jam, yang berarti penggunaan layanan yang berjalan lama tersebar di beberapa periode per jam.

Untuk informasi selengkapnya, lihat dokumentasi BigQuery tentang jenis data stempel waktu. Lihat juga, Perbedaan antara data yang diekspor dan invoice.

project Struct project berisi kolom yang mendeskripsikan project Penagihan Cloud, seperti ID, nomor, nama, ancestry_numbers, dan label.
project.id String ID project Google Cloud yang menghasilkan data Penagihan Cloud.
project.number String ID unik yang dibuat secara internal dan anonim untuk project Google Cloud yang membuat data Penagihan Cloud. Dalam kasus dukungan Anda dan komunikasi pelanggan lainnya, Google akan merujuk project Anda dengan nomor project ini.
project.name String Nama project Google Cloud yang menghasilkan data Penagihan Cloud.
project.ancestry_numbers String Ancestor dalam hierarki resource untuk project yang diidentifikasi oleh project.id yang ditentukan (misalnya, my-project-123).

Misalnya: /ParentOrgNumber/ParentFolderNumber/. Pelajari lebih lanjut Hierarki Resource.

project.ancestors Struct

Kolom ini menjelaskan struktur dan nilai hierarki resource dari item baris biaya, termasuk project, folder, dan organisasi. Ancestor diurutkan dari node ke root (project, folder, lalu organisasi).

project.ancestors.resource_name String Nama resource relatif untuk setiap ancestor dalam format 'resourceType/resourceNumber'. Penggunaan project.ancestors.resource_name akan memberikan tampilan project.ancestry_numbers yang lebih lengkap.
project.ancestors.display_name String Nama yang Anda buat untuk resource di konsol Anda.
project.labels.key String Jika ada label, bagian kunci dari pasangan nilai kunci yang meliputi label pada project Google Cloud tempat penggunaan terjadi. Untuk mengetahui informasi cara menggunakan label selengkapnya, lihat Menggunakan Label.
project.labels.value String Jika ada label, bagian nilai dari pasangan nilai kunci yang meliputi label pada project Google Cloud tempat penggunaan terjadi. Untuk informasi cara menggunakan label selengkapnya, lihat Menggunakan Label.
labels.key String Jika ada label, bagian kunci dari pasangan nilai kunci yang meliputi label pada resource Google Cloud tempat penggunaan terjadi. Untuk informasi cara menggunakan label selengkapnya, lihat Menggunakan Label.
labels.value String Jika ada label, bagian nilai dari pasangan nilai kunci yang meliputi label pada resource Google Cloud tempat penggunaan terjadi. Untuk informasi cara menggunakan label selengkapnya, lihat Menggunakan Label.
system_labels.key String Jika ada label sistem, bagian kunci dari pasangan nilai kunci yang meliputi label yang dihasilkan sistem pada resource tempat penggunaan terjadi. Lihat juga Label sistem yang tersedia.
system_labels.value String Jika ada label sistem, bagian nilai dari pasangan nilai kunci yang meliputi label yang dihasilkan sistem pada resource tempat penggunaan terjadi. Lihat juga Label sistem yang tersedia.
location.location String Lokasi penggunaan di level multi-region, negara, region, atau zona; atau global untuk resource tidak memiliki lokasi spesifik. Untuk mengetahui informasi lebih lanjut, lihat Geografi dan region dan lokasi Google Cloud.
location.country String Jika location.location adalah negara, wilayah, atau zona, kolom ini adalah negara penggunaan, misalnya US. Untuk mengetahui informasi lebih lanjut, lihat Geografi dan region dan lokasi Google Cloud.
location.region String Jika location.location adalah region atau zona, kolom ini adalah region penggunaan, misalnya us-central1. Untuk mengetahui informasi lebih lanjut, lihat Geografi dan region dan lokasi Google Cloud.
location.zone String Jika location.location adalah zona, kolom ini adalah zona penggunaan, misalnya us-central1-a. Untuk mengetahui informasi lebih lanjut, lihat Geografi dan region dan lokasi Google Cloud.
cost Float Biaya penggunaan sebelum kredit apa pun, dengan ketepatan hingga enam angka di belakang koma. Untuk mendapatkan total biaya termasuk kredit, setiap credits.amount harus ditambahkan ke biaya. Lihat contoh kueri ini untuk informasi selengkapnya.
currency String Mata uang yang digunakan dalam penagihan biaya. Untuk informasi selengkapnya, lihat Mata Uang Lokal untuk Penagihan dan Pembayaran.
currency_conversion_rate Float Nilai tukar dari dolar AS ke mata uang lokal. Artinya, cost ÷ currency_conversion_rate adalah biaya dalam dolar AS.
usage.amount Float Jumlah usage.unit yang digunakan.
usage.unit String Unit dasar untuk pengukuran penggunaan resource. Misalnya, unit dasar untuk penyimpanan standar adalah byte-detik.
usage.amount_in_pricing_units Float Jumlah usage.pricing_unit yang digunakan.
usage.pricing_unit String Unit untuk pengukuran penggunaan resource, sesuai dengan Cloud Billing Catalog API.
credits Struct credits berisi kolom yang menjelaskan struktur dan nilai kredit yang terkait dengan SKU Google Cloud dan Google Maps Platform.
credits.id String Jika ada, menunjukkan bahwa kredit terkait dengan SKU produk. Nilai credits.id dapat berupa ID unik alfanumerik (misalnya, 12-b34-c56-d78), atau deskripsi jenis kredit (seperti Rekomendasi Diskon Abonemen: CPU).

Jika kolom credits.id kosong, SKU produk tidak dikaitkan dengan kredit.

credits.full_name String Nama kredit yang terkait dengan SKU produk. Ini adalah deskripsi yang dapat dibaca manusia dari credits.id alfanumerik. Contohnya mencakup Kredit uji coba gratis atau Diskon abonemen berbasis pengeluaran.

Nilai credits.full_name hanya ada untuk SKU dengan credits.id alfanumerik. Jika nilai credits.id adalah deskripsi jenis kredit (seperti Rekomendasi Diskon Abonemen: CPU), maka kolom credits.full_name akan kosong.

credits.type String Kolom ini menjelaskan tujuan atau asal credits.id. Jenis kredit mencakup:
  • COMMITTED_USAGE_DISCOUNT: Kontrak abonemen berbasis resource yang dibeli untuk Compute Engine dengan imbalan harga diskon yang sangat besar untuk penggunaan VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Kontrak abonemen berbasis pengeluaran yang dibeli untuk layanan sebagai imbalan atas komitmen Anda untuk membelanjakan jumlah minimum.
  • DISCOUNT: Jenis kredit diskon digunakan untuk kredit yang diperoleh setelah nilai minimum pengeluaran kontrak tercapai. Perhatikan bahwa dalam laporan Penagihan Cloud yang tersedia di Konsol Google Cloud, jenis kredit diskon tercantum sebagai Diskon berbasis pengeluaran (kontrak).
  • FREE_TIER: Beberapa layanan menawarkan penggunaan resource gratis hingga batas yang ditentukan. Untuk layanan ini, kredit diterapkan pada penggunaan paket gratis.
  • PROMOTION: Jenis kredit promo mencakup Uji Coba Gratis Google Cloud dan kredit kampanye pemasaran, atau hibah lainnya untuk menggunakan Google Cloud. Jika tersedia, kredit promo dianggap sebagai metode pembayaran dan diterapkan secara otomatis untuk mengurangi total tagihan Anda.
  • RESELLER_MARGIN: Jika Anda adalah reseller, jenis kredit margin reseller menunjukkan Diskon Program Reseller yang diperoleh pada setiap item baris yang memenuhi syarat.
  • SUBSCRIPTION_BENEFIT: Kredit yang diperoleh dengan membeli langganan layanan jangka panjang dengan imbalan diskon.
  • SUSTAINED_USAGE_DISCOUNT: Jenis kredit diskon untuk penggunaan berkelanjutan adalah diskon otomatis yang Anda dapatkan jika menjalankan resource Compute Engine tertentu untuk porsi yang signifikan dari bulan penagihan.
credits.name String Deskripsi kredit yang diterapkan pada akun Penagihan Cloud.
credits.amount Float Jumlah kredit yang diterapkan untuk penggunaan.
adjustment_info Struct adjustment_info berisi kolom yang menjelaskan struktur dan nilai penyesuaian terhadap item baris biaya yang dikaitkan dengan Akun Penagihan Cloud.

Nilai adjustment_info hanya ada jika item baris biaya dibuat untuk perubahan Penagihan Cloud. Perubahan dapat terjadi karena alasan koreksi atau non-koreksi. Jenis adjustment_info berisi detail penyesuaian, baik yang dikeluarkan untuk mengoreksi error maupun alasan lainnya.

adjustment_info.id String Jika ada, menunjukkan bahwa penyesuaian terkait dengan item baris biaya. adjustment_info.id adalah ID unik untuk semua penyesuaian yang terkait dengan masalah.
adjustment_info.description String Deskripsi penyesuaian dan penyebabnya.
adjustment_info.type String

Jenis penyesuaian.

Jenisnya meliputi:

  • USAGE_CORRECTION: Koreksi karena penggunaan yang dilaporkan salah.
  • PRICE_CORRECTION: Koreksi karena aturan penetapan harga salah.
  • METADATA_CORRECTION: Koreksi untuk memperbaiki metadata tanpa mengubah biaya.
  • GOODWILL: Kredit yang diberikan kepada pelanggan untuk membangun reputasi.
  • SALES_BASED_GOODWILL: Kredit yang diberikan kepada pelanggan untuk membangun reputasi, sebagai bagian dari kontrak.
  • SLA_VIOLATION: Kredit yang diberikan kepada pelanggan karena pelanggaran tujuan tingkat layanan (SLO).
  • BALANCE_TRANSFER: Penyesuaian untuk mentransfer dana dari satu akun pembayaran ke akun pembayaran lainnya.
  • ACCOUNT_CLOSURE: Penyesuaian untuk memindahkan akun yang ditutup ke saldo nol.
  • GENERAL_ADJUSTMENT: Perubahan akun penagihan umum.
adjustment_info.mode String

Cara penyesuaian tersebut dikeluarkan.

Mode meliputi:

  • PARTIAL_CORRECTION: Koreksi sebagian mengabaikan biaya dan penggunaan awal.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: Koreksi sepenuhnya meniadakan penggunaan dan biaya asli, serta masalah item baris yang diperbaiki dengan penggunaan dan biaya yang diperbarui.
  • COMPLETE_NEGATION: Koreksi sepenuhnya meniadakan penggunaan dan biaya asli, dan tidak ada penggunaan lebih lanjut yang dimonetisasi ulang.
  • MANUAL_ADJUSTMENT: Penyesuaian dialokasikan ke biaya dan penggunaan secara manual.
export_time Stempel waktu Waktu pemrosesan yang terkait dengan penambahan data Penagihan Cloud. Waktu tersebut akan selalu meningkat seiring dengan adanya ekspor baru.
Lihat juga, Perbedaan antara data yang diekspor dan invoice di bawah ini.
tags Struct

Kolom yang mendeskripsikan tag, seperti kunci, nilai, dan namespace.

tags.key String

Nama pendek atau nama tampilan kunci yang terkait dengan tag khusus ini.

tags.value String

Resource yang dilampirkan ke tags.key. Pada waktu tertentu, hanya satu nilai yang dapat ditambahkan ke resource untuk kunci tertentu.

tags.inherited Boolean

Menunjukkan apakah binding tag diwariskan (Tag Diwariskan = Benar) atau langsung/tidak diwariskan (Tag Diwariskan = Salah). Anda dapat membuat binding tag ke resource induk dalam hierarki resource.

tags.namespace String

Mewakili hierarki resource yang mendefinisikan nilai dan kunci tag. Namespace dapat digabungkan dengan kunci tag dan nama pendek nilai tag untuk membuat nama unik secara global yang sepenuhnya memenuhi syarat untuk kunci tag atau nilai tag.

cost_at_list Float

Harga jual yang terkait dengan semua item baris yang ditagihkan ke akun Penagihan Cloud Anda.

transaction_type String

Jenis transaksi penjual. Jenis transaksi dapat berupa salah satu dari berikut:

  • GOOGLE = 1: Layanan yang dijual oleh Google Cloud.
  • THIRD_PARTY_RESELLER = 2: Layanan pihak ketiga yang dijual kembali oleh Google Cloud.
  • THIRD_PARTY_AGENCY = 3: Layanan pihak ketiga yang dijual oleh partner, dengan Google Cloud bertindak sebagai agen.
seller_name String

Nama resmi penjual.

Kolom tambahan tersedia untuk ekspor data biaya penggunaan mendetail
resource Struct

Kolom yang menjelaskan struktur dan nilai informasi yang relevan dengan resource layanan (seperti virtual machine atau SSD) yang menghasilkan penggunaan.

resource.global_name String

ID layanan unik global untuk resource yang menghasilkan penggunaan yang relevan.

resource.name String

ID khusus layanan untuk resource yang menghasilkan penggunaan yang relevan. Ini dapat berupa input yang dihasilkan oleh pengguna.

price Struct

Kolom yang mendeskripsikan struktur dan nilai yang terkait dengan harga yang dikenakan untuk penggunaan.

price.effective_price Angka

Harga yang dikenakan untuk penggunaan SKU Google Cloud atau Google Maps Platform dan tingkat harga SKU. Jika akun Penagihan Cloud Anda memiliki harga kontrak kustom, ini adalah harga khusus akun penagihan Anda; jika tidak, ini adalah harga jual SKU atau tingkat SKU.

price.tier_start_amount Angka

Jumlah unit batas bawah untuk tingkat harga SKU. Misalnya, SKU dengan tiga tingkat harga seperti 0-100 unit, 101-1.000 unit, dan 1001+ unit, akan menampilkan tiga baris harga untuk SKU tersebut, dengan 0, 101, dan 1001 di kolom price.tier_start_amount yang menunjukkan jumlah unit awal untuk tingkat harga SKU.

Pelajari tingkat harga lebih lanjut.
price.unit String

Unit penggunaan yang menentukan harga dan penggunaan resource diukur (seperti gibibyte, tebibyte, bulan, tahun, gibibyte jam, gibibyte bulan, atau hitungan). Nilai di kolom price.unit cocok dengan nilai di kolom usage.pricing_unit.

price.pricing_unit_quantity Angka

Jumlah unit tingkat harga SKU. Misalnya, jika harga tingkat per 1.000.000 Byte adalah $1, maka kolom ini akan menampilkan 1.000.000.

subscription Struct

Kolom yang menjelaskan komitmen berbasis pengeluaran atau berbasis resource Anda. Anda dapat menggunakan kolom ini untuk menganalisis biaya untuk komitmen tertentu.

subscription.instance_id String

ID langganan yang ditautkan ke komitmen.

Memahami data biaya penggunaan standar dan mendetail

Bagian berikut menjelaskan data standar dan detail biaya penggunaan yang diekspor ke BigQuery.

Tentang label

Data biaya untuk label tertentu hanya menampilkan penggunaan dari tanggal label diterapkan ke resource. Misalnya, jika Anda menambahkan label environment:dev ke VM Compute Engine pada 15 Januari 2024, analisis apa pun untuk environment:dev hanya akan menyertakan penggunaan untuk VM tersebut sejak 15 Januari.

Anda mungkin juga melihat data label pada waktu yang berbeda untuk berbagai layanan, bergantung kapan setiap layanan menyediakannya.

Label sistem yang tersedia

Label sistem adalah pasangan nilai kunci untuk metadata penting tentang resource yang menghasilkan penggunaan. Label sistem berikut otomatis disertakan pada penggunaan yang berlaku.

system_labels.key Contoh system_labels.value Deskripsi
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Konfigurasi virtual machine. Lihat Jenis Mesin untuk informasi lebih lanjut.
compute.googleapis.com/cores untuk n1-standard-4, ini adalah 4; untuk custom-2-2048 ini adalah 2 Jumlah vCPU yang tersedia untuk virtual machine.
compute.googleapis.com/memory untuk n1-standard-4 adalah 15360 (yaitu 15 GB * 1024 MB/GB); untuk custom-2-2048 nilainya adalah 2048 Jumlah memori (dalam MB) yang tersedia untuk virtual machine.
compute.googleapis.com/is_unused_reservation benar; salah Menunjukkan penggunaan yang direservasi melalui Pemesanan Zona tetapi tidak digunakan.
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart Status objek penyimpanan yang ditagih.

Perbedaan antara data yang diekspor dan invoice

Produk Google Cloud melaporkan data penggunaan dan data biaya ke proses Penagihan Cloud di berbagai interval. Akibatnya, Anda mungkin melihat keterlambatan antara penggunaan layanan Google Cloud, dengan penggunaan dan biaya yang tersedia untuk dilihat di Penagihan Cloud. Biasanya, biaya Anda tersedia dalam satu hari, tetapi terkadang dapat memerlukan waktu lebih dari 24 jam.

Pada akhir bulan kalender, penggunaan yang terlambat dilaporkan mungkin tidak akan disertakan dalam invoice bulan tersebut dan mungkin akan dialihkan ke invoice bulan berikutnya.

Saat Anda membuat kueri biaya menggunakan kolom stempel waktu, data yang ditampilkan dapat mengambil penggunaan yang terakhir dilaporkan, yang awalnya tidak disertakan dalam invoice yang dibuat untuk bulan penggunaan yang sama. Akibatnya, data Penagihan Cloud yang ditampilkan mungkin tidak dipetakan langsung ke invoice tersebut.

Kolom stempel waktu mencakup:

  • usage_start_time
  • usage_end_time
  • export_time

Untuk menampilkan data Penagihan Cloud yang dipetakan langsung ke invoice, buat kueri di invoice.month, bukan kolom stempel waktu.

Pajak

Mulai 1 September 2020, data biaya penggunaan akan menunjukkan kewajiban pajak Anda untuk setiap project, bukan sebagai item baris tunggal. Jika memiliki kueri atau visualisasi yang bergantung pada data pajak, Anda mungkin perlu memperbarui kueri untuk memperhitungkan perubahan ini.

Misalnya, untuk biaya yang dicatat sebelum 1 September, data biaya penggunaan Anda tampak mirip dengan contoh berikut, yang menunjukkan total kewajiban pajak sebesar $10.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Reguler $60
123456-ABCDEF-123456 test_project Reguler $40
123456-ABCDEF-123456 [empty] Pajak $10

Untuk biaya yang dicatat setelah 1 September, $10 dibagi menjadi $6 untuk example-project, dan $4 untuk test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 example-project Reguler $60
123456-ABCDEF-123456 test_project Reguler $40
123456-ABCDEF-123456 example-project Pajak $6
123456-ABCDEF-123456 test_project Pajak $4

Error dan penyesuaian

Jika data Penagihan Cloud Anda berisi error atau memerlukan penyesuaian, data tersebut akan ditambahkan dengan data perbaikan. Penyesuaian ini termasuk dalam salah satu dari dua kategori: perubahan atau koreksi penagihan.

Perubahan penagihan

Modifikasi penagihan akan muncul sebagai item baris terpisah. Jika Anda menerima perubahan penagihan, item baris baru dalam ekspor Penagihan Cloud ke BigQuery akan menampilkan perubahan tersebut. Penyesuaian yang ditampilkan sesuai dengan dokumen invoice, nota kredit, dan nota debit yang tersedia di area Dokumen di bagian Penagihan di konsol Google Cloud.

Untuk mengetahui informasi selengkapnya tentang perubahan penagihan dan cara penerapannya, lihat Memahami nota dan penyesuaian.

Koreksi

Koreksi muncul sebagai data baru yang meniadakan data yang salah pada SKU sumber. Dalam beberapa kasus, data baru akan menggantikan tagihan yang salah. Semua kolom dalam ekspor data penagihan akan cocok dengan data asli, kecuali untuk kolom berikut:

  • cost
  • credit
  • usage.amount
  • export_time

Misalnya, bayangkan Anda dikenai biaya $10 untuk penggunaan SKU A pada 1 Januari. Pada invoice bulan Januari (diterbitkan pada awal Februari), Anda akan melihat tagihan sebesar $10 untuk SKU A. Namun, pada 2 Februari, Google Cloud mengeluarkan koreksi terhadap SKU A, sehingga mengurangi biaya penggunaan menjadi $5. Anda akan menerima dua item baris tambahan di invoice bulan Februari (diterbitkan pada awal Maret):

  • -$10 untuk penggunaan pada 1 Januari (membatalkan tagihan awal)
  • $5 untuk penggunaan pada 1 Januari (mencantumkan tagihan yang dimaksud)

Item baru ini memiliki kolom adjustment_info dalam ekspor data penagihan. Invoice Januari asli, yang menunjukkan kelebihan tagihan, tidak akan disesuaikan. Anda dapat memverifikasi tagihan dalam ekspor data penagihan dengan melihat biaya menurut usage_start_time dan mengelompokkan menurut Day. Dalam tampilan ini, setiap koreksi atau tagihan untuk penggunaan yang dimonetisasi terlambat akan diakumulasikan, dan Anda tidak perlu khawatir tentang data yang salah untuk sementara.

Jika Anda menginginkan informasi yang lebih mendetail tentang koreksi, lihat semua tagihan dalam bulan invoice, dan cari tagihan dengan tanggal penggunaan yang terjadi sebelum bulan invoice. Biaya ini adalah hasil dari koreksi atau penggunaan yang dimonetisasi terlambat.

Contoh kode berikut menunjukkan cara membuat kueri dasar yang menampilkan total biaya koreksi atau penggunaan yang dimonetisasi terlambat:

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

Untuk contoh kueri yang menampilkan perincian biaya menurut layanan, untuk tagihan invoice, dengan tanggal penggunaan terjadi sebelum bulan invoice, lihat Kueri detail biaya untuk melihat koreksi atau penggunaan yang dimonetisasi terlambat menurut layanan untuk bulan invoice yang ditentukan di "Contoh kueri untuk ekspor data Penagihan Cloud".

Tentang kredit promo dalam kontrak harga khusus

Jika memiliki kontrak harga khusus, Anda mungkin menerima kredit promosi untuk digunakan di Google Cloud sebagai bagian dari kontrak. Misalnya, Anda mungkin menerima $1.000 untuk digunakan pada resource Compute Engine. Kredit promo biasanya dianggap sebagai metode pembayaran. Jika tersedia, kredit promo akan otomatis digunakan untuk mengurangi total tagihan Anda

Persyaratan kontrak Anda menentukan apakah kredit promo berlaku untuk biaya Anda yang dihitung pada harga jual SKU, atau harga bersih (setelah diskon).

Jika kredit promo berlaku untuk biaya yang dihitung pada harga daftar, di laporan Tabel biaya, ada layanan yang disebut Invoice, dengan SKU yang disebut Contract billing adjustment. SKU ini menyesuaikan kredit Anda sehingga berlaku untuk biaya sesuai harga jual. Untuk melihat penggunaan yang merupakan penyesuaian, buat kueri kolom system.labels. Kunci dalam system.labels.key adalah cloud-invoice.googleapis.com/sku_id, dan nilai dalam system.labels.value berisi ID SKU tempat kredit dan penyesuaian diterapkan.

Tentang tag

Tag adalah resource dalam bentuk key-value pair yang dapat dilampirkan ke resource secara langsung atau melalui pewarisan. Anda dapat menggunakan tag untuk melakukan penagihan balik, audit, dan analisis alokasi biaya lainnya. Anda juga dapat menggunakan tag dan penerapan kebijakan bersyarat untuk mendapatkan kontrol yang terperinci di seluruh hierarki resource.

Tag memiliki model izin yang andal dan dapat mendukung pewarisan, pengelolaan terpusat, standardisasi tata nama, dan integrasi mesin kebijakan, sedangkan label adalah alat terpisah yang memungkinkan Anda menganotasi resource.

Data tag muncul di BigQuery Export untuk Resource, Project, Folder, dan Organisasi.

Tag tersedia

Ekspor Biaya standar dan Biaya terperinci untuk Resource, Project, Folder, dan Organisasi mencakup kolom berikut untuk data tag: Kunci Tag, Nilai Tag, Tag Diwariskan, dan Namespace Tag.

Tag tingkat resource dalam ekspor data Penagihan Cloud tersedia untuk resource berikut:

  • Cluster, instance, dan pencadangan AlloyDB untuk PostgreSQL
  • Repositori Artifact Registry
  • Layanan dan tugas Cloud Run
  • Bucket Cloud Storage
  • Instance Compute Engine
  • Instance Memorystore for Redis
  • Secret Manager secrets
  • Instance Spanner

Batasan tag

  • Tag mungkin memerlukan waktu hingga satu jam untuk diterapkan ke ekspor BigQuery. Jika tag telah ditambahkan atau dihapus dalam waktu satu jam, atau jika resource telah ada selama kurang dari satu jam, resource tersebut mungkin tidak muncul di ekspor.

Contoh kueri biaya penggunaan mendetail

Bagian ini memberikan contoh cara meng-kueri data biaya penggunaan mendetail Penagihan Cloud yang diekspor ke BigQuery.

Karena skema biaya penggunaan mendetail mencakup semua kolom dari skema biaya penggunaan standar, contoh kueri yang diberikan untuk data standar yang diekspor ke BigQuery juga berfungsi dengan data mendetail yang diekspor. Contoh kueri standar tidak ditulis untuk mengambil informasi level resource yang disediakan dengan opsi ekspor biaya penggunaan mendetail. Saat membuat kueri untuk data mendetail, Anda dapat menggunakan contoh kueri standar sebagai template, memperbaruiNama tabel, dan menambahkan salah satu kolom yang tersedia diskema biaya penggunaan mendetail.

Nilai umum yang digunakan dalam contoh kueri biaya mendetail

Contoh kueri di bagian ini menggunakan nilai berikut untuk Nama tabel: project.dataset.gcp_billing_export_resource_v1_XXXXXX_XXXXXX_XXXXXX

Menampilkan biaya tingkat resource pada invoice

Kueri berikut menunjukkan dua cara untuk melihat biaya tingkat resource dan nilai kredit di invoice menggunakan data penagihan yang diekspor.

  • Kolom total menjumlahkan biaya floating point dan nilai kredit secara langsung, yang dapat menyebabkan error pembulatan floating point.
  • Kolom total_exact mengonversi biaya dan nilai kredit menjadi mikro sebelum dijumlahkan, lalu dikonversi kembali ke dolar setelah penjumlahan, untuk menghindari error pembulatan floating point.

Menjumlahkan biaya untuk setiap resource, per invoice

Kueri ini menampilkan total invoice untuk setiap resource.name per bulan, sebagai jumlah biaya reguler, pajak, penyesuaian, dan error pembulatan. Semua biaya yang tidak terkait dengan item tingkat resource digabungkan dalam nama null untuk bulan tersebut.

SQL Standar

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
;

Misalnya, hasil kueri sebelumnya mungkin adalah:

Baris bulan name total 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

Menampilkan detail menurut jenis biaya untuk setiap resource, per bulan invoice

Kueri ini menampilkan total setiap cost_type untuk setiap resource.name per bulan. Jenis biaya mencakup biaya reguler, pajak, penyesuaian, dan error pembulatan. Semua biaya yang tidak terkait dengan item tingkat resource digabungkan berdasarkan nama null untuk bulan tersebut.

SQL Standar

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
;

Misalnya, hasil kueri sebelumnya mungkin adalah:

Baris bulan cost_type name total total_exact
1 201901 reguler null $1000,501209987994782 $1000,50
2 201901 rounding_error null –$0,500489920049387 –$0,50
3 201901 pajak null $10,000329958477891 $10,00
4 201901 penyesuaian null –$5,002572999387045 –$5,00
5 201901 reguler backend1 $410,998795012082947 $411,00
2 201901 rounding_error backend1 –$0,2404900489920378 –$0,24
3 201901 pajak backend1 $4,105840329977189 $4,11

Mendapatkan perincian biaya cluster Google Kubernetes Engine (GKE)

Bagian ini memberikan contoh pemfilteran biaya cluster GKE dalam laporan BigQuery Export Anda. Untuk mempelajari biaya cluster GKE lebih lanjut, buka Melihat perincian biaya cluster.

Memfilter biaya GKE

Contoh kueri berikut menunjukkan cara memfilter dan mengelompokkan biaya GKE untuk jenis resource yang didukung berdasarkan nama cluster, namespace, dan label.

Biaya cluster GKE sebelum kredit

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
;

Biaya GKE setelah kredit berdasarkan 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-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "k8s-namespace"
GROUP BY namespace
;

Biaya GKE berdasarkan 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
;

Contoh kueri dengan tag

Contoh berikut menggambarkan cara meng-kueri data dengan tag.

Menghitung biaya berdasarkan bulan invoice dengan tag

Kueri berikut menunjukkan cara menggunakan biaya pengembalian berdasarkan bulan invoice untuk 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;

Misalnya, hasil kueri sebelumnya mungkin adalah:

Baris 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 personalisasi 16,08

Melihat biaya resource yang tidak diberi tag

Kueri ini menampilkan total invoice untuk resource yang tidak diberi tag, yang dikelompokkan menurut bulan invoice.

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;

Misalnya, hasil kueri sebelumnya mungkin adalah:

Baris 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

Laporan biaya dan harga tersedia di konsol Google Cloud