Memigrasikan kuota API dari metrik global ke metrik regional


Dokumen ini menjelaskan metrik kuota untuk API regional dan batas untuk setiap metrik. Panduan ini juga menjelaskan cara memperbarui dasbor Cloud Monitoring, serta kebijakan pemberitahuan dan kueri untuk menggunakan metrik regional.

Metrik kuota API Regional

API regional Compute Engine yang menggunakan metrik kuota global dimigrasikan untuk menggunakan metrik regional. API global terus menggunakan metrik global dan batas kuota. Lihat Batas kapasitas API untuk metrik global.

Untuk informasi selengkapnya tentang metode yang menggunakan metrik regional dan batasnya, lihat Batas kapasitas API untuk metrik regional.

Tabel berikut mencantumkan semua metrik yang dimigrasikan dari metrik kuota API global ke metrik regional:

Metrik kuota API global Metrik kuota API regional
compute.googleapis.com/default compute.googleapis.com/default_per_region BETA
compute.googleapis.com/read_requests compute.googleapis.com/read_requests_per_region BETA
compute.googleapis.com/list_requests compute.googleapis.com/list_requests_per_region BETA
compute.googleapis.com/operation_read_requests compute.googleapis.com/operation_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_read_requests compute.googleapis.com/heavy_weight_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_write_requests compute.googleapis.com/heavy_weight_write_requests_per_region BETA
compute.googleapis.com/global_resource_write_requests compute.googleapis.com/global_resource_write_requests_per_region BETA

Metrik berikut tidak memiliki API global. Jika Anda merujuk metrik ini di dasbor, pemberitahuan, atau kueri Cloud Monitoring, Anda harus memigrasikan metrik ini ke metrik regional yang sesuai.

Metrik kuota API global Metrik kuota API regional
compute.googleapis.com/simulate_maintenance_event_requests compute.googleapis.com/simulate_maintenance_event_requests_per_region BETA
compute.googleapis.com/instance_list_referrers_requests compute.googleapis.com/instance_list_referrers_requests_per_region BETA
compute.googleapis.com/get_serial_port_output_requests compute.googleapis.com/get_serial_port_output_requests_per_region BETA
compute.googleapis.com/network_endpoint_write_requests compute.googleapis.com/network_endpoint_write_requests_per_region BETA
compute.googleapis.com/network_endpoint_list_requests compute.googleapis.com/network_endpoint_list_requests_per_region BETA

Metrik berikut tidak memiliki API regional atau zona. Oleh karena itu, tidak ada perubahan yang diperlukan untuk migrasi kuota API regional.

  • compute.googleapis.com/project_set_common_instance_metadata_requests
  • compute.googleapis.com/license_insert_requests

Memigrasikan metrik Cloud Monitoring

Saat bermigrasi dari metrik kuota API yang ada ke metrik kuota API regional, Anda harus memperbarui dasbor, pemberitahuan, dan kueri Cloud Monitoring secara manual untuk menggunakan metrik regional.

Memperbarui dasbor Cloud Monitoring untuk menggunakan metrik regional

Untuk mengubah kebijakan pemberitahuan yang memantau metrik kuota API global ke metrik regional, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, pilih Monitoring:
  2. Di panel navigasi, pilih Dashboard.
  3. Pilih dasbor yang ingin Anda edit untuk menggunakan metrik regional.
  4. Klik Edit dasbor.
  5. Edit filter yang sesuai dengan metrik yang ingin Anda migrasikan:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Comparator, pilih =~.
    3. Di kolom Value, tentukan nama metrik untuk kuota API regional. Misalnya, filter quota_metric =~ compute.googleapis.com/read_requests.* menggunakan ekspresi reguler untuk mencocokkan semua data deret waktu yang menggunakan metrik kuota compute.googleapis.com/read_requests.*.

      Edit nilai filter untuk menggunakan metrik regional.

      Untuk informasi selengkapnya tentang metrik, lihat Batas kapasitas API untuk metrik regional.

    4. Klik Done untuk menyimpan perubahan.

    5. Opsional: Jika Anda ingin melihat penggunaan kuota per region, perluas header Grouped lalu pilih location di kolom Group by.

  6. Klik Close editor.

Memperbarui kebijakan pemberitahuan Cloud Monitoring untuk menggunakan metrik kuota API regional

Untuk mengubah kebijakan pemberitahuan yang memantau metrik kuota API global ke metrik regional, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, pilih Monitoring:
  2. Di panel navigasi, pilih Alerting. Halaman Alerting menampilkan panel yang mencantumkan informasi ringkasan, insiden, dan kebijakan pemberitahuan.
  3. Klik kebijakan pemberitahuan yang ingin Anda edit untuk menggunakan metrik regional.
  4. Klik Edit untuk mengubah kebijakan.
  5. Edit filter yang sesuai dengan metrik yang ingin Anda migrasikan:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Comparator, pilih =~.
    3. Di kolom Value, tentukan nama metrik untuk kuota API regional. Misalnya, filter quota_metric =~ compute.googleapis.com/read_requests.* menggunakan ekspresi reguler untuk mencocokkan semua data deret waktu yang menggunakan metrik kuota compute.googleapis.com/read_requests.*.

      Edit pemberitahuan untuk menggunakan metrik regional.

      Untuk informasi selengkapnya tentang metrik, lihat Batas kapasitas API untuk metrik regional.

    4. Klik Done untuk menyimpan perubahan di filter.

    5. Opsional: Jika Anda menginginkan pemberitahuan per region untuk metrik regional, luaskan header Across time series, lalu pilih location di bagian Time series group by.

  6. Klik Save policy.

Memperbarui kueri Cloud Monitoring untuk menggunakan metrik kuota regional

Untuk mengubah metrik kuota dalam kebijakan pemberitahuan berbasis MQL atau diagram di dasbor, gunakan Query Editor dan edit filter kueri. Lihat Menggunakan Editor Kueri.

Buka Query Editor dan edit filter untuk metrik kueri seperti yang ditunjukkan dalam contoh berikut:

Regular expression untuk metrik kuota regional

Secara opsional, Anda dapat mengelompokkan pemberitahuan berdasarkan lokasi menggunakan operasi group-by:

Pengelompokan menurut lokasi