Cloud Monitor:Buat peringatan global untuk batas tingkat API

Kasus penggunaan

Otomatisasi manajemen layanan melalui operasi API dapat menyebabkan pembatasan kecepatan API (throttling) yang sering terjadi saat volume panggilan tinggi, sehingga berdampak pada stabilitas bisnis. Mengonfigurasi aturan peringatan secara individual untuk setiap API tidak praktis. Aturan peringatan global memantau seluruh batas tingkat API suatu layanan cloud, memungkinkan perencanaan kuota secara proaktif.

Anda dapat memantau penggunaan dan kuota API global baik melalui Konsol maupun dengan memanggil operasi API.

Penagihan

Aturan peringatan untuk batas tingkat API menggunakan kuota notifikasi CloudMonitor Anda. Penagihan bervariasi berdasarkan metode notifikasi:

• Panggilan telepon: Tidak tersedia kuota gratis. Anda harus mengaktifkan pay-as-you-go atau membeli paket sumber daya. Untuk informasi selengkapnya, lihat Pay-as-you-go dan Paket sumber daya.

• Pesan SMS: Kuota gratis sebanyak 1.000 pesan per bulan disediakan. Jika Anda melebihi kuota gratis tersebut, Anda harus mengaktifkan pay-as-you-go atau membeli paket sumber daya. Untuk informasi selengkapnya, lihat Kuota gratis, Pay-as-you-go, dan Paket sumber daya.

• Email dan alert callback: Keduanya gratis.

Prasyarat

• Buat kontak peringatan dan kelompok kontak peringatan di Konsol CloudMonitor untuk menerima pemberitahuan peringatan. Untuk informasi selengkapnya, lihat Buat kontak peringatan atau kelompok kontak peringatan.

• Jika Anda menggunakan RAM user untuk mengelola peringatan kuota, RAM user tersebut harus memiliki izin administrator Quota Center (AliyunQuotasFullAccess) serta izin untuk membuat dan menghapus peringatan kuota di CloudMonitor.

  Kode berikut menyediakan contoh kebijakan izin. Untuk informasi selengkapnya, lihat Buat kebijakan izin kustom dan Kelola izin untuk RAM user.

  {
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "cms:PutMetricRuleTargets",
          "cms:PutResourceMetricRules",
          "cms:DeleteMetricRules",
          "cms:DeleteMetricRuleTargets"
        ],
        "Resource": "*"
      }
    ],
    "Version": "1"
  }

Buat peringatan global menggunakan Konsol

Contoh ini membuat aturan peringatan global untuk seluruh batas tingkat API Compute Nest, yang dipicu ketika penggunaan mencapai 80%. Notifikasi tingkat Warning dikirim melalui SMS dan email ke kelompok kontak peringatan.

Anda dapat menggunakan Konsol Quota Center atau Konsol CloudMonitor.

Buat peringatan global menggunakan API

Contoh ini membuat aturan peringatan global untuk seluruh batas tingkat API Compute Nest, yang dipicu ketika penggunaan mencapai 80%. Notifikasi tingkat Warning dikirim melalui SMS dan email ke kelompok kontak peringatan.

1. Konfirmasi bahwa layanan cloud target (Compute Nest) mendukung aturan peringatan global untuk batas tingkat API.

   Panggil API ListProductQuotas Quota Center dan periksa parameter respons UsageMetric. Nilai UsageMetric yang tidak kosong menunjukkan bahwa Compute Nest mendukung aturan peringatan global untuk batas tingkat API.

   • Parameter permintaan: Atur ProductCode menjadi computenest dan QuotaCategory menjadi FlowControl. Gunakan nilai default untuk parameter lainnya.

   • Parameter respons: Objek UsageMetric berisi informasi pemantauan untuk batas tingkat API dari CloudMonitor. Nilai MetricNamespace adalah acs_quotas_flowcontrol. Informasi berikut dikembalikan untuk setiap batas tingkat API:

     {
           "QuotaDescription": "GetServiceTemplateParameterConstraints",
           "Consumable": false,
           "ProductCode": "computenest",
           "UsageMetric": {
             "MetricName": "Usage",
             "MetricDimensions": {
               "productCode": "computenest",
               "metricKey": "GetServiceTemplateParameterConstraints/2021-06-01",
               "regionId": "ap-southeast-1",
               "label": "none"
             },
             "MetricNamespace": "acs_quotas_flowcontrol"
           },
           "Dimensions": {
             "apiName": "GetServiceTemplateParameterConstraints",
             "apiVersion": "2021-06-01",
             "regionId": "ap-southeast-1"
           },
           "GlobalQuota": false,
           "Period": {
             "PeriodValue": 1,
             "PeriodUnit": "second"
           },
           "Adjustable": true,
           "QuotaActionCode": "f_4w8uhd",
           "QuotaName": "GetServiceTemplateParameterConstraints",
           "QuotaArn": "acs:quotas:ap-southeast-1:14133977********:quota/computenest/f_4w8uhd",
           "TotalQuota": 50,
           "QuotaCategory": "FlowControl"
         }

     Catatan

     metricKey digunakan untuk membuat aturan peringatan untuk batas tingkat API tertentu.

2. Panggil operasi API DescribeMetricList CloudMonitor untuk mengkueri data pemantauan batas tingkat API. Gunakan tren penggunaan untuk menentukan ambang batas peringatan.

   • Parameter permintaan: Atur Namespace menjadi acs_quotas_flowcontrol, MetricName menjadi UsagePercentage, dan Dimensions menjadi [{"productCode":"computenest"}]. Gunakan nilai default untuk parameter lainnya.

     Catatan

     MetricName di Quota Center mencakup: Quota (nilai kuota), Usage (penggunaan kuota), UsagePercentage (persentase penggunaan kuota), dan AvailablePercentage (persentase kuota yang tersedia).

   • Parameter pengembalian: Di Datapoints, Anda dapat memperoleh nilai Value, yang dapat digunakan sebagai referensi untuk ambang batas peringatan. Informasi yang dikembalikan adalah sebagai berikut:

     {
       "RequestId": "2A7DB5BF-825C-51BB-AD91-D728857792F9",
       "Period": "60",
       "Datapoints": "[{\"timestamp\":1727337180000,\"productCode\":\"computenest\",\"metricKey\":\"GetServiceTemplateParameterConstraints/2021-05-21\",\"regionId\":\"cn-hangzhou\",\"label\":\"none\",\"userId\":\"14133977********\",\"Value\":2.0}]",
       "Code": "200",
       "Success": true
     }

3. Panggil operasi API PutResourceMetricRules CloudMonitor untuk membuat aturan peringatan global untuk batas tingkat API.

   • Parameter permintaan: Tabel berikut menjelaskan parameter yang diperlukan dan memberikan contoh nilainya.

     Parameter	Deskripsi	Contoh
     MetricName	Nama metrik. Nilai yang valid: Quota: nilai kuota Usage: penggunaan kuota UsagePercentage: persentase penggunaan AvailablePercentage: persentase yang tersedia Catatan Aturan peringatan global hanya dapat menggunakan UsagePercentage dan AvailablePercentage.	UsagePercentage
     Escalations.Warn.Threshold	Ambang batas untuk peringatan tingkat Warning.	80
     EffectiveInterval	Periode efektif aturan peringatan.	00:00-23:59 +0800 dayofweek 1,2,3,4,5,6,7
     RuleId	ID aturan peringatan.	quota-computenest-ruleid-test
     Escalations.Warn.ComparisonOperator	Operator perbandingan untuk ambang batas tingkat Warning. Nilai yang valid: GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan GreaterThanThreshold: lebih besar dari LessThanOrEqualToThreshold: kurang dari atau sama dengan LessThanThreshold: kurang dari NotEqualToThreshold: tidak sama dengan GreaterThanYesterday: peningkatan persentase dari waktu yang sama kemarin LessThanYesterday: penurunan persentase dari waktu yang sama kemarin GreaterThanLastWeek: peningkatan persentase dari waktu yang sama minggu lalu LessThanLastWeek: penurunan persentase dari waktu yang sama minggu lalu GreaterThanLastPeriod: peningkatan persentase dari periode sebelumnya LessThanLastPeriod: penurunan persentase dari periode sebelumnya	GreaterThanOrEqualToThreshold
     Resources	Informasi resource. Catatan Saat Anda membuat alarm terpisah untuk item kuota suatu API, contoh input Resources adalah: [{"productCode":"computenest","metricKey":"GetServiceTemplateParameterConstraints/2021-06-01"}].	[{"productCode":"computenest"}]
     ContactGroups	Kelompok kontak peringatan.	CloudMonitor
     Namespace	Namespace data layanan cloud.	acs_quotas_flowcontrol
     RuleName	Nama aturan peringatan.	quota-computenest-rulename-test
     Escalations.Warn.Times	Jumlah periode berturut-turut yang kondisinya harus terpenuhi untuk memicu peringatan tingkat Warning.	3
     Escalations.Warn.Statistics	Metode statistik untuk peringatan tingkat Warning.	Value

   • Respons sukses menunjukkan bahwa aturan peringatan telah dibuat.

     {
       "Message": "",
       "RequestId": "BE4CAC0F-A134-55BA-909B-FF62568FE884",
       "FailedListResult": {
         "Target": []
       },
       "Code": "200",
       "Success": true
     }

4. Panggil API CloudMonitor DescribeMetricRuleList untuk memverifikasi aturan peringatan berdasarkan RuleName atau RuleId.

Dokumen terkait

• Buat aturan peringatan untuk batas tingkat API tunggal: Buat aturan peringatan untuk kuota.

• Ajukan peningkatan kuota setelah menerima peringatan: Buat aplikasi peningkatan kuota.

• Lihat detail aturan peringatan: Lihat daftar dan detail aturan peringatan.

• Lihat riwayat peringatan: Lihat riwayat peringatan kuota.