Menggunakan metrik kuota API yang disederhanakan di Cloud Monitoring


Dokumen ini menjelaskan cara menggunakan metrik kuota Compute Engine API yang disederhanakan di dasbor, kebijakan pemberitahuan, dan kueri Cloud Monitoring.

Metrik kuota API yang disederhanakan

Untuk meningkatkan visibilitas dan pengelolaan kuota Compute Engine API, Google Cloud telah mengurangi jumlah metrik kuota dengan menggabungkan metrik ke dalam lebih sedikit grup kuota. Metrik kuota yang disederhanakan ini juga menawarkan batas yang lebih tinggi untuk setiap grup kuota.

Tabel berikut mencantumkan semua metrik kuota API sederhana yang menggabungkan metrik kuota API yang ada:

Metrik kuota API yang ada Metrik kuota API yang disederhanakan
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_readsBETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Metrik kuota yang ada untuk metode yang mencantumkan resource Compute Engine.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Metrik kuota yang ada untuk metode global yang membuat, mengubah, atau menghapus resource Compute Engine.
Mutation requests per minute
compute.googleapis.com/global_writesBETA
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region Read requests per minute per region
compute.googleapis.com/reads_per_regionBETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Metrik kuota yang ada untuk metode regional dan zona yang mencantumkan resource Compute Engine.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region Mutation requests per minute per region
compute.googleapis.com/writes_per_regionBETA
compute.googleapis.com/default_per_region
Metrik kuota yang ada untuk metode regional dan zona yang membuat, mengubah, atau menghapus resource Compute Engine.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region RegionInstances RecommendLocations requests per minute per region
compute.googleapis.com/recommend_locations_per_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

Menggunakan metrik sederhana di Cloud Monitoring

Untuk memantau penggunaan Compute Engine API terhadap metrik API yang disederhanakan, tambahkan filter untuk metrik ini di dasbor, pemberitahuan, dan kueri Cloud Monitoring.

Menggunakan metrik sederhana di dasbor Cloud Monitoring

Untuk menggunakan metrik kuota yang disederhanakan di dasbor, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka Monitoring:

    Buka Monitoring

  2. Di panel navigasi, pilih Dashboard.

  3. Pilih dasbor yang ingin Anda edit untuk menggunakan metrik yang disederhanakan.

  4. Klik Edit dasbor dan tambahkan widget.

  5. Tambahkan filter yang sesuai dengan metrik yang ingin Anda pantau:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Comparator, pilih =.
    3. Di kolom Value, tentukan nama metrik untuk kuota API. Misalnya, filter quota_metric = compute.googleapis.com/global_reads menggunakan ekspresi reguler untuk mencocokkan semua data deret waktu yang menggunakan metrik kuota compute.googleapis.com/global_reads.
  6. Untuk menerapkan perubahan pada dasbor, klik Terapkan di toolbar.

Menggunakan metrik kuota API yang disederhanakan dalam kebijakan pemberitahuan Cloud Monitoring

Untuk membuat kebijakan pemberitahuan guna memantau penggunaan metrik kuota API yang disederhanakan, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka Monitoring:

    Buka Monitoring

  2. Di panel navigasi, pilih Alerting. Halaman Alerting menampilkan panel yang mencantumkan informasi ringkasan, insiden, dan kebijakan pemberitahuan.

  3. Klik Create policy untuk menambahkan kebijakan pemberitahuan.

  4. Pilih filter yang sesuai dengan metrik yang ingin Anda pantau:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Comparator, pilih =.
    3. Di kolom Value, tentukan nama metrik untuk kuota yang disederhanakan. Misalnya, filter quota_metric = compute.googleapis.com/global_reads menggunakan ekspresi reguler untuk mencocokkan semua data deret waktu yang menggunakan metrik kuota compute.googleapis.com/global_reads.
    4. Klik Done untuk menyimpan perubahan di filter.
  5. Klik Save policy.

Anda juga dapat menggunakan Google Cloud Penyedia Terraform untuk membuat kebijakan pemberitahuan di project Google Cloud Anda. Untuk informasi selengkapnya, lihat Membuat kebijakan pemberitahuan dengan Terraform.

Menggunakan metrik kuota yang disederhanakan dalam kueri Cloud Monitoring

Untuk menggunakan metrik kuota yang disederhanakan dalam kebijakan pemberitahuan berbasis MQL atau PromQL atau diagram di dasbor, gunakan Query Editor dan edit filter kueri. Lihat Menggunakan Editor Kueri. Buka Query Editor dan tambahkan filter seperti yang ditunjukkan dalam contoh berikut: MQL:

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]
Catatan: MQL tidak akan digunakan lagi mulai 22 Juli 2025. Gunakan PromQL untuk membuat dasbor. Untuk mengetahui informasi selengkapnya, lihat Penghentian penggunaan MQL. PromQL:
   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 
quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))