Cloud Monitor:API hız sınırları için genel bir uyarı oluşturun

Kullanım senaryoları

Yüksek API çağrı hacimleri sık sık kısıtlamalara neden olarak iş sürekliliğini etkileyebilir. API başına ayrı ayrı uyarı kuralları yapılandırmak yerine, genel bir uyarı kuralı ile bir cloud hizmetinin tüm hız sınırlarını izleyerek proaktif kota planlaması yapabilirsiniz.

Genel API kullanımını ve kotalarını konsol veya API işlemleri aracılığıyla izleyebilirsiniz.

Faturalama

API hız sınırı uyarı kuralları CloudMonitor bildirim kotanızı tüketir. Faturalama, bildirim yöntemine göre değişir:

• Telefon araması — Ücretsiz kota sağlanmaz. Kullandıkça öde faturalandırma yöntemini etkinleştirmeniz veya bir kaynak planı satın almanız gerekir. Daha fazla bilgi için bkz. Kullandıkça öde ve Kaynak planları.

• SMS — Aylık 1.000 mesajlık ücretsiz kota sağlanır. Ücretsiz kota aşıldığında kullandıkça öde faturalandırma yöntemini etkinleştirin veya bir kaynak planı satın alın. Daha fazla bilgi için bkz. Ücretsiz kota, Kullandıkça öde ve Kaynak planları.

• E-posta ve uyarı geri arama — Her iki yöntem de ücretsizdir.

Ön koşullar

• Uyarı mesajlarını alabilmek için CloudMonitor konsolunda uyarı kişileri ve bir uyarı kişi grubu oluşturun. Talimatlar için bkz. Uyarı kişisi veya uyarı kişi grubu oluşturma.

• Kota uyarılarını yönetmek için bir Resource Access Management (RAM) kullanıcısı kullanıyorsanız, RAM kullanıcısının Quota Center yönetim iznine (AliyunQuotasFullAccess) ve CloudMonitor'de kota uyarıları oluşturma ve silme izinlerine sahip olması gerekir. Aşağıdaki örnek, özel ilkenin içeriğini göstermektedir. Daha fazla bilgi için bkz. Özel ilke oluşturma ve RAM kullanıcısına izin atama.

Konsolu kullanarak genel bir uyarı oluşturun

Bu örnekte, %80 kullanımda tetiklenen tüm Compute Nest API hız sınırları için bir genel uyarı kuralı oluşturulur. SMS ve e-posta yoluyla uyarı kişi grubuna Uyarı düzeyinde bir bildirim gönderilir.

Quota Center veya CloudMonitor konsolunu kullanabilirsiniz.

API kullanarak genel bir uyarı oluşturun

Bu örnekte, %80 kullanımda tetiklenen tüm Compute Nest API hız sınırları için bir genel uyarı kuralı oluşturulur. SMS ve e-posta yoluyla uyarı kişi grubuna Uyarı düzeyinde bir bildirim gönderilir.

1. Hedef cloud hizmetinin (Compute Nest) API hız sınırları için genel uyarı kurallarını desteklediğini doğrulayın.

   ListProductQuotas API'sini çağırın ve UsageMetric yanıt parametresini kontrol edin. Boş olmayan bir UsageMetric değeri, genel uyarı kurallarının desteklendiğini gösterir.

   • İstek parametreleri: ProductCode değerini computenest ve QuotaCategory değerini FlowControl olarak ayarlayın. Diğer parametreler için varsayılan değerleri koruyun.

   • Yanıt parametreleri: UsageMetric nesnesi, CloudMonitor'dan gelen API hız sınırı izleme bilgilerini içerir. MetricNamespace değeri acs_quotas_flowcontrol olur. Bir API hız sınırı için örnek yanıt:

     {
           "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"
         }

     Not

     metricKey tek bir belirli API hız sınırı için uyarı kuralı oluşturmak amacıyla kullanılır.

2. API hız sınırları için izleme verilerini sorgulamak üzere DescribeMetricList API'sini çağırın. Kullanım eğilimlerini değerlendirerek uyarı eşiklerini belirleyin.

   • İstek parametreleri: Namespace değerini acs_quotas_flowcontrol, MetricName değerini UsagePercentage ve Dimensions değerini [{"productCode":"computenest"}] olarak ayarlayın. Diğer parametreler için varsayılan değerleri koruyun.

     Not

     Quota Center'daki MetricName şunları içerir: Quota (kota değeri), Usage (kota kullanımı), UsagePercentage (kota kullanım yüzdesi) ve AvailablePercentage (kalan kota yüzdesi).

   • Dönüş parametreleri: Value alanı Datapoints içinde, uyarı eşiği için referans olabilir. Örnek yanıt:

     {
       "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. API hız sınırları için genel bir uyarı kuralı oluşturmak üzere PutResourceMetricRules API'sini çağırın.

   • İstek parametreleri: Aşağıdaki tabloda gerekli parametreler ve örnek değerler listelenmiştir.

     Parametre	Açıklama	Örnek
     MetricName	Ölçüm adı. Geçerli değerler: Quota: kota değeri Usage: kota kullanımı UsagePercentage: kullanım yüzdesi AvailablePercentage: kalan yüzde Not Genel uyarı kuralları yalnızca UsagePercentage ve AvailablePercentage kullanabilir.	UsagePercentage
     Escalations.Warn.Threshold	Uyarı düzeyi uyarıları için eşik değeri.	80
     EffectiveInterval	Uyarı kuralının geçerlilik süresi.	00:00-23:59 +0800 dayofweek 1,2,3,4,5,6,7
     RuleId	Uyarı kuralının kimliği.	quota-computenest-ruleid-test
     Escalations.Warn.ComparisonOperator	Uyarı düzeyi eşiği için karşılaştırma operatörü. Geçerli değerler: GreaterThanOrEqualToThreshold: büyük veya eşit GreaterThanThreshold: büyük LessThanOrEqualToThreshold: küçük veya eşit LessThanThreshold: küçük NotEqualToThreshold: eşit değil GreaterThanYesterday: dün aynı saate göre yüzde artış LessThanYesterday: dün aynı saate göre yüzde azalış GreaterThanLastWeek: geçen hafta aynı saate göre yüzde artış LessThanLastWeek: geçen hafta aynı saate göre yüzde azalış GreaterThanLastPeriod: önceki döneme göre yüzde artış LessThanLastPeriod: önceki döneme göre yüzde azalış	GreaterThanOrEqualToThreshold
     Resources	Kaynak bilgileri. Not Tek bir API için uyarı oluşturmak üzere Resources parametresini şu şekilde belirtin: [{"productCode":"computenest","metricKey":"GetServiceTemplateParameterConstraints/2021-06-01"}].	[{"productCode":"computenest"}]
     ContactGroups	Uyarı kişi grubu.	CloudMonitor
     Namespace	Cloud hizmetinin veri ad alanı.	acs_quotas_flowcontrol
     RuleName	Uyarı kuralının adı.	quota-computenest-rulename-test
     Escalations.Warn.Times	Uyarı düzeyi uyarısını tetiklemek için koşulun karşılanması gereken ardışık dönem sayısı.	3
     Escalations.Warn.Statistics	Uyarı düzeyi uyarısı için istatistiksel yöntem.	Value

   • Başarılı bir yanıt, kuralın oluşturulduğunu gösterir.

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

4. Uyarı kuralını RuleName veya RuleId ile doğrulamak için DescribeMetricRuleList API'sini çağırın.

İlgili belgeler

• Tek bir API hız sınırı için uyarı oluşturma: Kota için uyarı kuralı oluşturma

• Uyarı sonrası kota artışı talebi: Kota artırma başvurusu oluşturma

• Uyarı kuralı ayrıntılarını görüntüleme: Uyarı kurallarının listesini ve ayrıntılarını görüntüleme

• Uyarı geçmişini görüntüleme: Kota uyarı geçmişini görüntüleme