DescribeMetricRuleList - - Alibaba Cloud Dokümantasyon Merkezi

Bu konu, Alibaba Cloud hesabınızdaki tüm uyarı kurallarının nasıl sorgulanacağını gösteren bir örnek sunar. Dönen sonuçta yalnızca bir uyarı kuralı bulunduğunu görürsünüz. Uyarı kuralının adı Rule_01 ve kimliği applyTemplate344cfd42-0f32-4fd6-805a-88d7908a**** şeklindedir.

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeMetricRuleList	Gerçekleştirmek istediğiniz işlem. Değeri DescribeMetricRuleList olarak belirtin.
MetricName	String	No	cpu_total	Ölçüm adı. Bir ölçümün adını edinme hakkında bilgi için bkz. DescribeMetricMetaList veya Ek 1: Ölçümler.
EnableState	Boolean	No	true	Etkin veya devre dışı bırakılmış uyarı kurallarının sorgulanıp sorgulanmayacağını belirtir. Geçerli değerler: true: Etkin uyarı kurallarını sorgular. false: Devre dışı bırakılmış uyarı kurallarını sorgular.
Namespace	String	No	acs_ecs_dashboard	Cloud hizmetinin ad alanı. Bir cloud hizmetinin ad alanını edinme hakkında bilgi için bkz. DescribeMetricMetaList veya Ek 1: Ölçümler.
Page	Integer	No	1	Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.
PageSize	Integer	No	10	Sayfa başına düşen kayıt sayısı. Sayfalar 1'den başlar. Varsayılan değer: 10.
AlertState	String	No	OK	Uyarı kuralının durumu. Geçerli değerler: OK: Uyarı kuralında etkin uyarı bulunmuyor. ALARM: Uyarı kuralında etkin uyarılar mevcut. INSUFFICIENT_DATA: Veri yok.
Dimensions	String	No	{"instanceId":"i-2ze2d6j5uhg20x47****"}	Belirtilen kaynağın izleme boyutları. Değeri `key:value` çiftlerinden oluşan bir koleksiyon olarak belirtin. Örnek: `{"userId":"120886317861"}` veya `{"instanceId":"i-2ze2d6j5uhg20x47"}`.
RuleName	String	No	Rule_01	Uyarı kuralının adı. Bu parametre bulanık eşleşmeyi destekler.
GroupId	String	No	7301****	Uygulama grubunun kimliği. Bir uygulama grubunun kimliğini edinme hakkında bilgi için bkz. DescribeMonitorGroups.
RuleIds	String	No	applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****	Uyarı kuralının kimliği. Aynı anda en fazla 20 kimlik belirtebilirsiniz. Birden çok kimliği virgül (,) ile ayırın.

Ortak istek parametreleri hakkında daha fazla bilgi için bkz. Ortak parametreler.

Yanıt parametreleri

Parameter	Type	Example	Description
Code	Integer	200	HTTP durum kodu. Not 200 durum kodu, isteğin başarılı olduğunu gösterir.
Message	String	The specified resource is not found.	Hata mesajı.
RequestId	String	386C6712-335F-5054-930A-CC92B851ECBA	İstek kimliği.
Total	String	1	Toplam kayıt sayısı.
Success	Boolean	true	İsteğin başarılı olup olmadığını gösterir. Geçerli değerler: true false
Alarms	Array of Alarm		Uyarı kurallarının ayrıntıları.
Alarm
SilenceTime	Integer	86400	Tetikleme koşulları karşılanmış olsa bile yeni uyarı bildirimlerinin gönderilmediği sessiz süre. Birim: saniye. Varsayılan değer: 86400. Minimum değer: 3600. Ölçüm değeri art arda birkaç kez uyarı eşiğini aşsa bile her sessiz süre boyunca yalnızca bir uyarı bildirilir.
MetricName	String	cpu_total	Ölçüm adı.
Webhook	String	https://www.aliyun.com	Geri arama URL'si. CloudMonitor, bir HTTP POST isteği göndererek belirtilen geri arama URL'sine bir uyarı bildirimi iletir. Yalnızca HTTP protokolü desteklenir.
ContactGroups	String	ECS_Alarm	Uyarı kişi grupları.
SourceType	String	METRIC	Uyarı kuralı türü. Geçerli değer: METRIC. Bu değer, zaman serisi ölçümleri için bir uyarı kuralını gösterir.
Namespace	String	acs_ecs_dashboard	Cloud hizmetinin ad alanı.
MailSubject	String	"${serviceType}-${metricName}-${levelDescription}Notification (${dimensions})"	Uyarı bildirimi e-postasının konusu.
NoEffectiveInterval	String	00:00-05:30	Uyarı kuralının etkin olmadığı zaman aralığı.
EffectiveInterval	String	05:31-23:59	Uyarı kuralının etkin olduğu zaman aralığı.
RuleName	String	Rule_01	Uyarı kuralının adı.
AlertState	String	OK	Uyarı kuralının durumu. Geçerli değerler: OK: Uyarı kuralında etkin uyarı bulunmuyor. ALARM: Uyarı kuralında etkin uyarılar mevcut. INSUFFICIENT_DATA: Veri yok.
Period	String	60	İstatistiksel dönem.
RuleId	String	applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****	Uyarı kuralının kimliği.
GroupName	String	ECS_Group	Uygulama grubunun adı. Not Uyarı kuralı bir uygulama grubuyla ilişkilendirilmişse, bu parametrede uygulama grubunun adı döndürülür.
GroupId	String	7301****	Uygulama grubunun kimliği.
Dimensions	String	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	Uyarı kuralının boyutları.
EnableState	Boolean	true	Uyarı kuralının etkin olup olmadığını gösterir. Geçerli değerler: true: Uyarı kuralı etkindir. false: Uyarı kuralı devre dışı bırakılmıştır.
Resources	String	[{\"instanceId\":\"i-2ze2d6j5uhg20x47****\"}]	Uyarı kuralıyla ilişkilendirilen kaynaklar.
Escalations	Object		Farklı düzeylerdeki uyarıları tetikleyen koşullar.
Info	Object		Info düzeyindeki uyarıları tetikleyen koşullar.
ComparisonOperator	String	GreaterThanOrEqualToThreshold	Info düzeyindeki uyarılar için ölçüm değerini eşikle karşılaştırmada kullanılan karşılaştırma işleci. Geçerli değerler: GreaterThanOrEqualToThreshold: Eşitten büyük veya eşit GreaterThanThreshold: Eşitten büyük LessThanOrEqualToThreshold: Eşitten küçük veya eşit LessThanThreshold: Eşitten küçük NotEqualToThreshold: Eşite eşit değil GreaterThanYesterday: Dünün aynı saatindeki ölçüm değerinden büyük LessThanYesterday: Dünün aynı saatindeki ölçüm değerinden küçük GreaterThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden büyük LessThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden küçük GreaterThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden büyük LessThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden küçük
PreCondition	String	$Average>80	Info düzeyindeki uyarıları tetiklemek için ek koşullar. ComparisonOperator parametresinin değeri GreaterThanYesterday, LessThanYesterday, GreaterThanLastWeek, LessThanLastWeek, GreaterThanLastPeriod veya LessThanLastPeriod olduğunda ek koşullar geçerli olur. Örneğin, PreCondition, ComparisonOperator ve Threshold parametrelerinin değerleri sırasıyla $Average>80, GreaterThanYesterday ve 10 olarak ayarlanır. Bir uyarı yalnızca ortalama ölçüm değeri 80'den büyük ve dünün aynı saatindeki ortalama ölçüm değerinden %10 fazla olduğunda tetiklenir. Not $Average, `bir dolar işareti ($) ve istatistiksel yöntemden` oluşan bir yer tutucudur. CloudMonitor, değer karşılaştırmasından önce yer tutucuyu toplanmış değer veya orijinal değerle değiştirir.
Times	Integer	3	Info düzeyinde bir uyarı tetiklenmeden önce ölçüm değerinin uyarı koşulunu ardışık olarak kaç kez karşıladığını belirtir.
Threshold	String	90	Info düzeyindeki uyarılar için eşik değeri.
Statistics	String	Average	Info düzeyindeki uyarılar için istatistiksel yöntemler.
Warn	Object		Warn düzeyindeki uyarıları tetikleyen koşullar.
ComparisonOperator	String	GreaterThanOrEqualToThreshold	Warn düzeyindeki uyarılar için ölçüm değerini eşikle karşılaştırmada kullanılan karşılaştırma işleci. Geçerli değerler: GreaterThanOrEqualToThreshold: Eşitten büyük veya eşit GreaterThanThreshold: Eşitten büyük LessThanOrEqualToThreshold: Eşitten küçük veya eşit LessThanThreshold: Eşitten küçük NotEqualToThreshold: Eşite eşit değil GreaterThanYesterday: Dünün aynı saatindeki ölçüm değerinden büyük LessThanYesterday: Dünün aynı saatindeki ölçüm değerinden küçük GreaterThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden büyük LessThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden küçük GreaterThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden büyük LessThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden küçük
PreCondition	String	$Average>80	Warn düzeyindeki uyarıları tetiklemek için ek koşullar. ComparisonOperator parametresinin değeri GreaterThanYesterday, LessThanYesterday, GreaterThanLastWeek, LessThanLastWeek, GreaterThanLastPeriod veya LessThanLastPeriod olduğunda ek koşullar geçerli olur. Örneğin, PreCondition, ComparisonOperator ve Threshold parametrelerinin değerleri sırasıyla $Average>80, GreaterThanYesterday ve 10 olarak ayarlanır. Bir uyarı yalnızca ortalama ölçüm değeri 80'den büyük ve dünün aynı saatindeki ortalama ölçüm değerinden %10 fazla olduğunda tetiklenir. Not $Average, `bir dolar işareti ($) ve istatistiksel yöntemden` oluşan bir yer tutucudur. CloudMonitor, değer karşılaştırmasından önce yer tutucuyu toplanmış değer veya orijinal değerle değiştirir.
Times	Integer	3	Warn düzeyinde bir uyarı tetiklenmeden önce ölçüm değerinin uyarı koşulunu ardışık olarak kaç kez karşıladığını belirtir.
Threshold	String	90	Warn düzeyindeki uyarılar için eşik değeri.
Statistics	String	Average	Warn düzeyindeki uyarılar için istatistiksel yöntemler.
Critical	Object		Critical düzeyindeki uyarıları tetikleyen koşullar.
ComparisonOperator	String	GreaterThanOrEqualToThreshold	Critical düzeyindeki uyarılar için ölçüm değerini eşikle karşılaştırmada kullanılan karşılaştırma işleci. Geçerli değerler: GreaterThanOrEqualToThreshold: Eşitten büyük veya eşit GreaterThanThreshold: Eşitten büyük LessThanOrEqualToThreshold: Eşitten küçük veya eşit LessThanThreshold: Eşitten küçük NotEqualToThreshold: Eşite eşit değil GreaterThanYesterday: Dünün aynı saatindeki ölçüm değerinden büyük LessThanYesterday: Dünün aynı saatindeki ölçüm değerinden küçük GreaterThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden büyük LessThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden küçük GreaterThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden büyük LessThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden küçük
PreCondition	String	$Average>80	Critical düzeyindeki uyarıları tetiklemek için ek koşullar. ComparisonOperator parametresinin değeri GreaterThanYesterday, LessThanYesterday, GreaterThanLastWeek, LessThanLastWeek, GreaterThanLastPeriod veya LessThanLastPeriod olduğunda ek koşullar geçerli olur. Örneğin, PreCondition, ComparisonOperator ve Threshold parametrelerinin değerleri sırasıyla $Average>80, GreaterThanYesterday ve 10 olarak ayarlanır. Bir uyarı yalnızca ortalama ölçüm değeri 80'den büyük ve dünün aynı saatindeki ortalama ölçüm değerinden %10 fazla olduğunda tetiklenir. Not $Average, `bir dolar işareti ($) ve istatistiksel yöntemden` oluşan bir yer tutucudur. CloudMonitor, değer karşılaştırmasından önce yer tutucuyu toplanmış değer veya orijinal değerle değiştirir.
Times	Integer	3	Critical düzeyinde bir uyarı tetiklenmeden önce ölçüm değerinin uyarı koşulunu ardışık olarak kaç kez karşıladığını belirtir.
Threshold	String	90	Critical düzeyindeki uyarılar için eşik değeri.
Statistics	String	Average	Critical düzeyindeki uyarılar için istatistiksel yöntemler.
NoDataPolicy	String	KEEP_LAST_STATE	İzleme verisi bulunamadığında uyarıların nasıl işleneceğine ilişkin yöntem. Geçerli değerler: KEEP_LAST_STATE (varsayılan): İşlem yapılmaz. INSUFFICIENT_DATA: İçeriği "Yetersiz veri" olan bir uyarı tetiklenir. OK: Durum normal kabul edilir.
CompositeExpression	Object		Birden çok ölçüm için tetikleme koşulları. Not Tek bir ölçüm ve birden çok ölçüm için tetikleme koşulları birbirini dışlar. Tek bir ölçüm ve birden çok ölçüm için aynı anda tetikleme koşulları belirtemezsiniz.
Level	String	Critical	Uyarı düzeyi. Geçerli değerler: Critical Warn Info
ExpressionList	Array of ExpressionList		Standart modda oluşturulan tetikleme koşulları.
ExpressionList
MetricName	String	cpu_total	Cloud hizmetini izlemek için kullanılan ölçüm.
ComparisonOperator	String	GreaterThanOrEqualToThreshold	Ölçüm değerini eşikle karşılaştırmada kullanılan karşılaştırma işleci. Geçerli değerler: GreaterThanOrEqualToThreshold: Eşitten büyük veya eşit GreaterThanThreshold: Eşitten büyük LessThanOrEqualToThreshold: Eşitten küçük veya eşit LessThanThreshold: Eşitten küçük NotEqualToThreshold: Eşite eşit değil GreaterThanYesterday: Dünün aynı saatindeki ölçüm değerinden büyük LessThanYesterday: Dünün aynı saatindeki ölçüm değerinden küçük GreaterThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden büyük LessThanLastWeek: Geçen haftanın aynı saatindeki ölçüm değerinden küçük GreaterThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden büyük LessThanLastPeriod: Son izleme döngüsündeki ölçüm değerinden küçük
Statistics	String	$Maximum	Ölçümün istatistiksel yöntemi. Geçerli değerler: $Maximum: Maksimum değer $Minimum: Minimum değer $Average: Ortalama değer $Availability: Kullanılabilirlik oranı (genellikle site izleme için kullanılır) Not `$`, ölçümün ön ekidir. CloudMonitor tarafından desteklenen Alibaba Cloud hizmetleri hakkında bilgi için bkz. Ek 1: Ölçümler.
Threshold	String	90	Uyarı eşiği.
Period	Integer	60	Ölçümün toplama dönemi. Birim: saniye.
ExpressionListJoin	String	\|\|	Birden çok ölçüm için tetikleme koşulları arasındaki ilişki. Geçerli değerler: `&&`: Bir uyarı yalnızca tüm ölçümler tetikleme koşullarını karşıladığında tetiklenir. Bir uyarı yalnızca ExpressionList parametresinde belirtilen tüm ifadelerin sonuçları `true` olduğunda tetiklenir. `\|\|`: Ölçümlerden biri tetikleme koşullarını karşıladığında bir uyarı tetiklenir.
ExpressionRaw	String	$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)	İfadeler kullanılarak oluşturulan tetikleme koşulları. Aşağıdaki senaryolarda ifadeleri kullanarak tetikleme koşulları oluşturabilirsiniz: Belirli kaynaklar için bir uyarı kara listesi ayarlama. Örneğin, `$instanceId != 'i-io8kfvcpp7x5**'` `&&` `$Average > 50` belirtirseniz, `i-io8kfvcpp7x5` örneğinin `ortalama ölçüm değeri` 50'yi aşsa bile uyarı oluşturulmaz. Kuralda belirtilen bir örnek için özel bir uyarı eşiği ayarlama. Örneğin, `$Average > ($instanceId == 'i-io8kfvcpp7x5'? 80: 50)` belirtirseniz, `i-io8kfvcpp7x5**` örneğinin `ortalama ölçüm değeri` 80'i aştığında veya diğer örneklerin `ortalama ölçüm değeri` 50'yi aştığında bir uyarı tetiklenir. Ölçüm değerleri eşiği aşan örnek sayısını sınırlama. Örneğin, `count($Average > 20) > 3` belirtirseniz, `ortalama ölçüm değeri` 20'yi aşan örnek sayısı üçten fazla olduğunda yalnızca bir uyarı tetiklenir.
Times	Integer	3	Ardışık tetikleme sayısı. Ölçüm değerlerinin tetikleme koşullarını karşılama sayısı bu parametrenin değerine ulaştığında CloudMonitor uyarı bildirimleri gönderir.
Labels	Array of Labels		Uyarı kuralının etiketleri.
Labels
Key	String	cmsRuleKey	Uyarı kuralının etiket anahtarı.
Value	String	cmsRuleValue	Uyarı kuralının etiket değeri.
Prometheus	Object		Prometheus uyarı kuralı. Not Bu parametre yalnızca Hybrid Cloud Monitoring için bir Prometheus uyarı kuralı oluşturduğunuzda gereklidir.
PromQL	String	CpuUsage{instanceId="xxxx"}[1m]>90	PromQL sorgu ifadesi. Not PromQL sorgu ifadesi kullanılarak elde edilen veriler izleme verileridir. Bu ifadeye uyarı eşiğini dahil etmeniz gerekir.
Level	String	Critical	Uyarı düzeyi. Geçerli değerler: Critical Warn Info
Times	Long	3	Ardışık tetikleme sayısı. Ölçüm değerlerinin tetikleme koşullarını karşılama sayısı bu parametrenin değerine ulaştığında CloudMonitor uyarı bildirimleri gönderir.
Annotations	Array of Annotations		Prometheus uyarı kuralının açıklamaları. Bir Prometheus uyarısı tetiklendiğinde sistem, ölçümleri ve uyarı kuralını anlamanıza yardımcı olmak için açıklanan anahtarları ve değerleri işler. Not Bu parametre, açık kaynak Prometheus'un annotations parametresine eşdeğerdir.
Annotations
Key	String	summary	Açıklamanın anahtarı.
Value	String	{{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }	Açıklamanın değeri.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeMetricRuleList
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeMetricRuleListResponse>
	<RequestId>386C6712-335F-5054-930A-CC92B851ECBA</RequestId>
	<Total>1</Total>
	<Alarms>
		<Alarm>
			<GroupName>ECS_Group</GroupName>
			<SilenceTime>86400</SilenceTime>
			<ContactGroups>ECS_Alarm</ContactGroups>
			<NoEffectiveInterval>00:00-05:30</NoEffectiveInterval>
			<GroupBy>group</GroupBy>
			<MailSubject>${serviceType}-${metricName}-${levelDescription}Notification(${dimensions})</MailSubject>
			<SourceType>METRIC</SourceType>
			<RuleId>applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****</RuleId>
			<Period>60</Period>
			<Dimensions>
				<instanceId>i-2ze2d6j5uhg20x47****</instanceId>
			</Dimensions>
			<EffectiveInterval>05:31-23:59</EffectiveInterval>
			<Namespace>acs_ecs_dashboard</Namespace>
			<AlertState>OK</AlertState>
			<GroupId>7301****</GroupId>
			<MetricName>cpu_total</MetricName>
			<EnableState>true</EnableState>
			<Escalations>
				<Critical>
					<ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
					<Times>3</Times>
					<Statistics>Average</Statistics>
					<Threshold>90</Threshold>
				</Critical>
				<Info>
					<ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
					<Times>3</Times>
					<Statistics>Average</Statistics>
					<Threshold>90</Threshold>
				</Info>
				<Warn>
					<ComparisonOperator>GreaterThanOrEqualToThreshold</ComparisonOperator>
					<Times>3</Times>
					<Statistics>Average</Statistics>
					<Threshold>90</Threshold>
				</Warn>
			</Escalations>
			<Webhook>https://www.aliyun.com</Webhook>
			<Resources>[{\"instanceId\":\"i-2ze2d6j5uhg20x47****\"}]</Resources>
			<RuleName>Rule_01</RuleName>
		</Alarm>
	</Alarms>
	<Code>200</Code>
	<Success>true</Success>
</DescribeMetricRuleListResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "386C6712-335F-5054-930A-CC92B851ECBA",
  "Total" : 1,
  "Alarms" : {
    "Alarm" : [ {
      "GroupName" : "ECS_Group",
      "SilenceTime" : 86400,
      "ContactGroups" : "ECS_Alarm",
      "NoEffectiveInterval" : "00:00-05:30",
      "GroupBy" : "group",
      "MailSubject": "${serviceType}-${metricName}-${levelDescription}Notification(${dimensions})",
      "SourceType" : "METRIC",
      "RuleId" : "applyTemplate344cfd42-0f32-4fd6-805a-88d7908a****",
      "Period" : 60,
      "Dimensions" : [ {
        "instanceId" : "i-2ze2d6j5uhg20x47****"
      } ],
      "EffectiveInterval" : "05:31-23:59",
      "Namespace" : "acs_ecs_dashboard",
      "AlertState" : "OK",
      "GroupId" : "7301****",
      "MetricName" : "cpu_total",
      "EnableState" : true,
      "Escalations" : {
        "Critical" : {
          "ComparisonOperator" : "GreaterThanOrEqualToThreshold",
          "Times" : 3,
          "Statistics" : "Average",
          "Threshold" : "90"
        },
        "Info" : {
          "ComparisonOperator" : "GreaterThanOrEqualToThreshold",
          "Times" : 3,
          "Statistics" : "Average",
          "Threshold" : "90"
        },
        "Warn" : {
          "ComparisonOperator" : "GreaterThanOrEqualToThreshold",
          "Times" : 3,
          "Statistics" : "Average",
          "Threshold" : "90"
        }
      },
      "Webhook" : "https://www.aliyun.com",
      "Resources" : "[{\"instanceId\":\"i-2ze2d6j5uhg20x47****\"}]",
      "RuleName" : "Rule_01"
    } ]
  },
  "Code" : "200",
  "Success" : true
}

Hata kodları

HTTP status code	Error code	Error message	Description
404	ResourceNotFound	The specified resource is not found.	Belirtilen kaynak bulunamadı.

Hata kodlarının listesi için bkz. Hizmet hata kodları.