Menggunakan metrik kuota API yang disederhanakan di Cloud Monitoring

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

Metrik kuota API yang disederhanakan

Untuk meningkatkan kemampuan penemuan 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.

Metrik kuota API lama dan yang disederhanakan

Tabel berikut mencantumkan metrik kuota API lama dan metrik sederhananya yang setara:

Metrik kuota API lama Metrik kuota API yang disederhanakan
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
Permintaan baca per menit
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Metrik kuota lama 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 lama untuk metode global yang membuat, mengubah, atau menghapus resource Compute Engine.		 compute.googleapis.com/global_writes
Permintaan mutasi per menit
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 compute.googleapis.com/reads_per_region
Permintaan baca per menit per region
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Metrik kuota lama 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 compute.googleapis.com/writes_per_region
Permintaan mutasi per menit per region
compute.googleapis.com/default_per_region
Metrik kuota lama 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 compute.googleapis.com/recommend_locations_per_region
Permintaan RegionInstances RecommendLocations per menit per region
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
Permintaan invalidasi cache per menit

Menggunakan metrik yang disederhanakan di dasbor 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 Anda.

Membuat dasbor yang menggunakan metrik kuota API yang disederhanakan

Untuk membuat dasbor yang menggunakan metrik yang disederhanakan, lakukan tindakan berikut:

  1. Di konsol Google Cloud , buka Monitoring:

    Buka Monitoring

  2. Di panel navigasi, pilih Dashboards.

  3. Klik Create Custom Dashboard.

  4. Di toolbar dasbor, klik Tambahkan widget dan pilih jenis widget (misalnya, Diagram garis). Halaman Konfigurasi widget akan terbuka.

  5. Di bagian Pilih metrik, lakukan tindakan berikut:

    1. Pilih Consumer Quota untuk resource.
    2. Pilih Quota untuk kategori metrik.
    3. Pilih Rate quota usage untuk metrik, lalu klik Apply.

  6. Di bagian Tambahkan filter, gunakan filter quota_metric dan pilih metrik kuota API yang disederhanakan yang sesuai. Untuk menemukan metrik yang disederhanakan, lihat Metrik kuota API lama dan yang disederhanakan.

  7. Klik Terapkan untuk menambahkan widget ke dasbor.

  8. Di toolbar, klik Simpan untuk menyimpan dasbor.

Mengubah dasbor yang menggunakan metrik kuota lama

Untuk memperbarui dasbor yang berisi metrik lama, lakukan tindakan berikut:

  1. Di konsol Google Cloud , buka Monitoring:

    Buka Monitoring

  2. Di panel navigasi, pilih Dashboards.

  3. Buka dasbor yang berisi diagram yang perlu diperbarui.

  4. Klik Edit.

  5. Temukan widget yang ingin Anda perbarui dan edit.

  6. Di bagian Select a metric, perbarui filter yang berisi metrik lama:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Value, perbarui nilai saat ini ke metrik kuota API yang disederhanakan yang sesuai. Untuk menemukan pengganti metrik lama Anda, lihat Metrik kuota API lama dan yang disederhanakan. Misalnya, ubah compute.googleapis.com/read_requests menjadi compute.googleapis.com/global_reads.

  7. Untuk menerapkan perubahan, klik Terapkan.

Menggunakan metrik kuota API yang disederhanakan dalam kebijakan pemberitahuan Cloud Monitoring

Untuk memantau penggunaan Compute Engine API terhadap metrik API yang disederhanakan, tambahkan filter untuk metrik ini dalam kebijakan pemberitahuan Cloud Monitoring Anda.

Membuat kebijakan pemberitahuan yang menggunakan metrik kuota API yang disederhanakan

Untuk membuat kebijakan pemberitahuan yang menggunakan metrik yang disederhanakan, lakukan hal berikut:

  1. Di konsol Google Cloud , buka Monitoring:

    Buka Monitoring

  2. Di panel navigasi, pilih Alerting.

  3. Klik Create policy.

  4. Di bagian Pilih metrik, lakukan tindakan berikut:

    1. Pilih Consumer Quota untuk resource.
    2. Pilih Quota untuk kategori metrik.
    3. Pilih Rate quota usage untuk metrik, lalu klik Apply.

  5. Di bagian Tambahkan filter, gunakan filter quota_metric dan pilih metrik kuota API yang disederhanakan yang sesuai. Untuk menemukan metrik yang disederhanakan, lihat Metrik kuota API lama dan yang disederhanakan.

  6. Konfigurasi kondisi, saluran notifikasi, dan dokumentasi sesuai kebutuhan.

  7. Klik Save policy.

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

Mengubah kebijakan pemberitahuan yang menggunakan metrik kuota lama

Untuk memperbarui kebijakan pemberitahuan yang ada yang menggunakan metrik kuota lama, lakukan hal 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. Untuk mengedit kebijakan yang ada, klik nama kebijakan di bagian Kebijakan.

  4. Di bagian Select a metric, perbarui filter yang berisi metrik lama:

    1. Di kolom Filter, pilih quota_metric.
    2. Di kolom Value, perbarui nilai ke metrik kuota API yang disederhanakan yang sesuai. Untuk menemukan pengganti metrik lama Anda, lihat Metrik kuota API lama dan yang disederhanakan. Misalnya, ubah compute.googleapis.com/read_requests menjadi compute.googleapis.com/global_reads.

  5. Klik Done untuk menyimpan perubahan di filter.

  6. Klik Save policy.

Menggunakan metrik kuota yang disederhanakan dalam kueri Cloud Monitoring

Untuk memperbarui kebijakan pemberitahuan berbasis PromQL atau diagram di dasbor, gunakan Query Editor dan edit filter kueri. Untuk mengetahui informasi selengkapnya, lihat Menggunakan editor kode untuk PromQL.

Untuk memperbarui kueri, ganti nama metrik lama dalam filter quota_metric dengan nama metrik sederhana yang sesuai.

Contoh 1:

Kueri yang menggunakan metrik lama:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/read_requests"}[1m])

Kueri yang diubah menggunakan metrik yang disederhanakan:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/global_reads"}[1m])

Contoh 2:

Kueri yang menggunakan metrik lama:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/heavy_weight_write_requests_per_region"}[1m])

Kueri yang diubah menggunakan metrik yang disederhanakan:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/writes_per_region"}[1m])