Melaporkan Metrik Penagihan

Halaman ini menjelaskan cara menggunakan Infrastruktur Layanan untuk memungkinkan layanan terkelola 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 serta menentukan unit penyimpanan persediaan (SKU) beserta harganya.

Service Control API menerima metrik, yang mengelompokkan, menggabungkan, dan meneruskannya ke Penagihan Cloud. Penagihan Cloud menyerap metrik ini dan membuat tagihan berdasarkan model harga yang telah ditetapkan. Jika tidak ada model harga standar, Penagihan Cloud hanya 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 harus menentukan tiga bit informasi berbeda dalam konfigurasi layanan:

  • Resource yang dimonitor: 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 Penagihan Cloud.

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 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 mengirim konfigurasi layanan menggunakan Service Management API, Anda dapat memanggil Service Control API untuk melaporkan metrik. Contoh berikut menggunakan perintah gcurl untuk mendemonstrasikan panggilan. Untuk mengetahui informasi 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