Melaporkan Metrik Penagihan

Halaman ini menjelaskan cara menggunakan Infrastruktur Layanan untuk mengaktifkan layanan terkelola guna mengirim data penggunaan penagihan sehingga Penagihan Cloud dapat menagih konsumen layanan. Misalnya, Anda dapat menentukan metrik yang disebut library.appspot.com/books/borrowed untuk mengukur jumlah buku yang dipinjam oleh pelanggan dan menentukan unit pengelolaan stok (SKU) serta harganya.

Service Control API menerima metrik, yang dikelompokkan, digabungkan, dan diteruskan ke Cloud Billing. Penagihan Cloud menyerap metrik ini dan membuat tagihan berdasarkan model harga yang telah ditentukan. Jika tidak ada model harga yang telah ditentukan sebelumnya, Penagihan Cloud akan mengabaikan metrik penagihan. Untuk menentukan model harga, hubungi Account Manager partner Google Cloud Anda.

Mengonfigurasi penagihan

Sebelum mengirim data penagihan ke Service Control API, Anda perlu menentukan tiga informasi yang berbeda dalam konfigurasi layanan:

  • Resource yang dipantau: Anda dapat mengumpulkan penggunaan penagihan untuk setiap resource. Resource yang dipantau memerlukan setidaknya satu kunci label cloud.googleapis.com/location untuk menunjukkan lokasi penggunaan penagihan.

  • Metrik: Anda dapat melaporkan satu atau beberapa metrik. Setiap metrik mengukur penggunaan jenis resource tertentu. Hanya metrik DELTA dengan nilai INT64 yang didukung untuk penagihan.

  • Konfigurasi penagihan: Memungkinkan Anda menentukan metrik yang akan dikirim ke Cloud Billing.

Contoh konfigurasi layanan berikut menentukan satu metrik yang mengukur jumlah buku yang dipinjam oleh pelanggan. Klien dapat memanggil metode services.report untuk melaporkan nilai pada metrik. Lihat billing.proto untuk mengetahui detail tentang konfigurasi penagihan.

# library
monitored_resources:
 - type: library.appspot.com/branch
   labels:
   - key: cloud.googleapis.com/location
     description: The cloud location.
   - key: library.appspot.com/city
     description: The city where the library branch is located in.

# The metrics to be used.
metrics:
- name: library.appspot.com/books/borrowed
  metric_kind: DELTA
  value_type: INT64
  unit: '1'

# The billing configuration.
billing:
  consumer_destinations:
  - monitored_resource: library.appspot.com/branch
    metrics:
    - library.appspot.com/books/borrowed

Melaporkan metrik penagihan

Setelah mengonfigurasi pemantauan di konfigurasi layanan dan mendorong konfigurasi layanan menggunakan Service Management API, Anda dapat memanggil Service Control API untuk melaporkan metrik. Contoh berikut menggunakan perintah gcurl untuk mendemonstrasikan panggilan. Untuk informasi tentang cara menyiapkannya, lihat Mulai Menggunakan Service Control API.

$ gcurl -d "{
  'operations': [ {
    'operationId': '8356d3c5-f9b5-4274-b4f9-079a3731e6e5',
    'consumerId': 'project:library-consumer',
    'startTime': '`date +%FT%T%:z`',
    'endTime': '`date +%FT%T%:z`',
    'labels': {
      'cloud.googleapis.com/location': 'us-west1',
      'library.appspot.com/city': 'Kirkland',
    },
    'metricValueSets': [ {
      'metricName': 'library.appspot.com/books/borrowed',
      'metricValues': [ { 'int64Value': '10' } ]
    } ]
  } ]
}" https://servicecontrol.googleapis.com/v1/services/library.appspot.com:report