Praktik terbaik untuk pelaporan penggunaan

Untuk produk SaaS berbasis penggunaan, Google Cloud Marketplace mengatribusikan penggunaan ke satu project Google Cloud, yang ditentukan oleh kolom usageReportingId. Dalam beberapa skenario, produk SaaS mungkin dibagikan secara luas dalam organisasi pelanggan dan digunakan di banyak project pelanggan. Untuk memungkinkan dukungan bagi atribusi biaya yang lebih spesifik, sebaiknya produk SaaS berbasis penggunaan menyertakan kolom userLabels opsional pada operasi laporan penggunaannya.

Jika layanan Anda sudah mendukung konsep label resource, sebaiknya teruskan label tersebut dalam laporan penggunaan. Label harus sesuai dengan persyaratan sintaksis.

Label penggunaan

Cloud Marketplace mencadangkan label berikut. Anda dapat menggunakan label ini untuk mengidentifikasi konteks tambahan untuk penggunaan dalam platform layanan Anda. Sebaiknya sertakan label ini dalam laporan penggunaan secara default.

Kunci Label	Nilai Label	Deskripsi>
cloudmarketplace.googleapis.com/resource_name	USER_SUPPLIED	Nama resource yang terkait dengan metrik penggunaan.
cloudmarketplace.googleapis.com/container_name	USER_SUPPLIED	Nama penampung resource.

Label diteruskan ke alat pengelolaan biaya Penagihan Cloud, termasuk laporan biaya dan ekspor penagihan.

Contoh pemberian label penggunaan

Untuk contoh ini, bayangkan organisasi Anda menawarkan produk penyimpanan yang disebut Solusi Penyimpanan SaaS.

Seorang pelanggan, Carl, telah membeli penawaran penyimpanan Anda untuk project Google Cloud-nya, e-commerce-website, untuk menghosting database user_profiles_db dan products_db untuk situs e-commerce-nya:

• user_profiles_db berisi informasi tentang pengguna yang mengunjungi situs Carl.
• products_db berisi informasi tentang produk yang dijual Carl di situsnya.

Jika ingin memberikan perincian biaya penggunaan yang mendetail kepada Carl, Anda dapat menggunakan pasangan nilai kunci userLabels untuk melaporkan biaya penggunaan untuk setiap database secara terpisah.

Misalnya, untuk melaporkan biaya yang diatribusikan ke penggunaan penyimpanan products_db Carl, Anda dapat mengirim laporan berikut, yang menunjukkan bahwa penyimpanan products_db Carl menghabiskan biaya 100 unit:

operation = {
  'operationId': '<UUID>',
  'operationName': 'db-total-storage',
  'consumerId': 'project:carl_website',
  'startTime': '<Timestamp>',
  'endTime': '<Timestamp>',
  'metricValues': [{
      'int64Value': 100,
  }],
  'userLabels': {
    'cloudmarketplace.googleapis.com/container_name': 'e-commerce-website',
    'cloudmarketplace.googleapis.com/resource_name': 'products_db'
  }
}

service.services().report(
  serviceName=service_name, body={
    'operations': [operation]
}).execute()

Dalam contoh ini, service_name adalah Project ID project Google Cloud Carl.

Untuk contoh penggunaan userLabels yang lebih mendetail, lihat codelab SaaS.