PutResourceMetricRule - - Alibaba Cloud Documentation Center

Membuat aturan peringatan untuk metrik suatu resource.

Topik ini memberikan contoh cara membuat aturan peringatan berdasarkan ambang batas untuk metrik cpu_total dari instance Elastic Compute Service (ECS) dengan ID i-uf6j91r34rnwawoo****. Namespace ECS adalah acs_ecs_dashboard. Kelompok kontak peringatan untuk aturan tersebut adalah ECS_Group, dengan nama aturan peringatan test123 dan ID aturan peringatan a151cd6023eacee2f0978e03863cc1697c89508****. Untuk peringatan tingkat Critical, metode statistik yang digunakan adalah Average, operator perbandingannya adalah GreaterThanOrEqualToThreshold, ambang batasnya adalah 90, dan jumlah kali berturut-turut nilai metrik harus memenuhi kondisi pemicu sebelum peringatan dipicu adalah 3.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	PutResourceMetricRule	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke PutResourceMetricRule.
RuleId	String	Yes	a151cd6023eacee2f0978e03863cc1697c89508****	ID aturan peringatan. Anda dapat menentukan ID baru atau ID aturan peringatan yang sudah ada. Untuk informasi tentang cara menanyakan ID aturan peringatan, lihat DescribeMetricRuleList. Catatan Jika Anda menentukan ID baru, aturan peringatan yang dipicu berdasarkan ambang batas akan dibuat.
RuleName	String	Yes	test123	Nama aturan peringatan. Anda dapat menentukan nama baru atau nama aturan peringatan yang sudah ada. Untuk informasi tentang cara menanyakan nama aturan peringatan, lihat DescribeMetricRuleList. Catatan Jika Anda menentukan nama baru, aturan peringatan yang dipicu berdasarkan ambang batas akan dibuat.
Namespace	String	Yes	acs_ecs_dashboard	Namespace layanan cloud. Untuk informasi tentang cara menanyakan namespace layanan cloud, lihat Appendix 1: Metrics. Catatan Jika Anda membuat aturan peringatan Prometheus untuk Hybrid Cloud Monitoring, Anda harus menetapkan parameter ini ke `acs_prometheus`.
MetricName	String	Yes	cpu_total	Nama metrik. Untuk informasi tentang cara menanyakan nama metrik, lihat Appendix 1: Metrics. Catatan Jika Anda membuat aturan peringatan Prometheus untuk Hybrid Cloud Monitoring, Anda harus menetapkan parameter ini ke nama namespace. Untuk informasi tentang cara memperoleh nama namespace, lihat DescribeHybridMonitorNamespaceList.
Resources	String	Yes	[{"instanceId":"i-uf6j91r34rnwawoo****"}]	Informasi tentang resource. Contoh: `[{"instanceId":"i-uf6j91r34rnwawoo**"}]` dan `[{"userId":"100931896542**"}]`. Untuk informasi tentang dimensi yang didukung untuk menanyakan resource, lihat Appendix 1: Metrics.
ContactGroups	String	Yes	ECS_Group	Kelompok kontak peringatan. Pemberitahuan peringatan dikirim ke kontak yang termasuk dalam kelompok kontak peringatan yang ditentukan. Catatan Satu kelompok kontak peringatan dapat berisi satu atau beberapa kontak peringatan. Untuk informasi tentang cara membuat kontak peringatan dan kelompok kontak peringatan, lihat PutContact dan PutContactGroup.
Webhook	String	No	https://alert.aliyun.com.com:8080/callback	URL callback tempat permintaan POST dikirim ketika peringatan dipicu berdasarkan aturan peringatan.
EffectiveInterval	String	No	00:00-23:59	Periode waktu saat aturan peringatan berlaku.
NoEffectiveInterval	String	No	00:00-06:00	Periode waktu saat aturan peringatan tidak berlaku.
SilenceTime	Integer	No	86400	Periode bisu selama pemberitahuan peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi. Satuan: detik. Nilai default: 86400. Catatan Jika peringatan belum diselesaikan setelah periode bisu berakhir, CloudMonitor mengirim ulang pemberitahuan peringatan.
Period	String	No	60	Periode statistik metrik. Satuan: detik. Nilai default adalah interval pengumpulan data pemantauan metrik. Catatan Untuk informasi tentang cara menanyakan periode statistik metrik, lihat Appendix 1: Metrics.
Interval	String	No	60	Interval pemicuan peringatan. Satuan: detik. Catatan Untuk informasi tentang cara menanyakan periode statistik metrik, lihat Appendix 1: Metrics.
EmailSubject	String	No	Alert for an ECS instance	Subjek email pemberitahuan peringatan.
Escalations.Critical.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Critical. Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan `MetricName` layanan cloud yang ditentukan. Misalnya, nilainya dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara memperoleh nilai parameter ini, lihat Appendix 1: Metrics. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Critical.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Critical. Nilai yang valid: GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas GreaterThanThreshold: lebih besar dari ambang batas LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas LessThanThreshold: lebih kecil dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: lebih kecil dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: lebih kecil dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: lebih kecil dari nilai metrik pada siklus pemantauan sebelumnya Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Critical.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Critical. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Critical.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Critical dipicu. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Warn.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Warn. Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan `MetricName` layanan cloud yang ditentukan. Misalnya, nilainya dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara memperoleh nilai parameter ini, lihat Appendix 1: Metrics. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Warn.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Warn. Nilai yang valid: GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas GreaterThanThreshold: lebih besar dari ambang batas LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas LessThanThreshold: lebih kecil dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: lebih kecil dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: lebih kecil dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: lebih kecil dari nilai metrik pada siklus pemantauan sebelumnya Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Warn.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Warn. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Warn.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Warn dipicu. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Info.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Info. Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan `MetricName` layanan cloud yang ditentukan. Misalnya, nilainya dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara memperoleh nilai parameter ini, lihat Appendix 1: Metrics. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Info.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Info. Nilai yang valid: GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas GreaterThanThreshold: lebih besar dari ambang batas LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas LessThanThreshold: lebih kecil dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: lebih kecil dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: lebih kecil dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: lebih kecil dari nilai metrik pada siklus pemantauan sebelumnya Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Info.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Info. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
Escalations.Info.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Info dipicu. Catatan Anda harus memilih minimal satu tingkat peringatan dari Critical, Warn, atau Info, serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk tingkat peringatan yang dipilih.
NoDataPolicy	String	No	KEEP_LAST_STATE	Metode penanganan peringatan saat tidak ditemukan data pemantauan. Nilai yang valid: KEEP_LAST_STATE (nilai default): Tidak dilakukan apa pun. INSUFFICIENT_DATA: Peringatan dengan isi "Insufficient data" dipicu. OK: Status dianggap normal.
CompositeExpression	Object	No		Kondisi pemicu untuk beberapa metrik. Catatan Kondisi pemicu untuk satu metrik dan beberapa metrik saling eksklusif. Anda tidak dapat menentukan kondisi pemicu untuk satu metrik dan beberapa metrik secara bersamaan.
ExpressionList	Array	No		Kondisi pemicu yang dibuat dalam mode standar.
MetricName	String	No	cpu_total	Metrik yang digunakan untuk memantau layanan cloud.
ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas. Nilai yang valid: GreaterThanOrEqualToThreshold: lebih besar dari atau sama dengan ambang batas GreaterThanThreshold: lebih besar dari ambang batas LessThanOrEqualToThreshold: lebih kecil dari atau sama dengan ambang batas LessThanThreshold: lebih kecil dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: lebih kecil dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: lebih kecil dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: lebih kecil dari nilai metrik pada siklus pemantauan sebelumnya
Period	Long	No	60	Periode agregasi metrik. Satuan: detik.
Statistics	String	No	$Maximum	Metode statistik metrik. Nilai yang valid: $Maximum: nilai maksimum $Minimum: nilai minimum $Average: nilai rata-rata $Availability: laju ketersediaan (biasanya digunakan untuk site monitoring) Catatan `$` adalah awalan metrik. Untuk informasi tentang layanan Alibaba Cloud yang didukung oleh CloudMonitor, lihat Appendix 1: Metrics.
Threshold	String	No	90	Ambang batas peringatan.
ExpressionListJoin	String	No	\|\|	Hubungan antara kondisi pemicu untuk beberapa metrik. Nilai yang valid: `&&`: Peringatan dipicu hanya jika semua metrik memenuhi kondisi pemicu. Peringatan dipicu hanya jika hasil semua ekspresi yang ditentukan dalam parameter ExpressionList bernilai `true`. `\|\|`: Peringatan dipicu jika salah satu metrik memenuhi kondisi pemicu.
ExpressionRaw	String	No	$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)	Kondisi pemicu yang dibuat menggunakan ekspresi. Anda dapat menggunakan ekspresi untuk membuat kondisi pemicu dalam skenario berikut: Menetapkan blacklist peringatan untuk resource tertentu. Misalnya, jika Anda menentukan `$instanceId != 'i-io8kfvcpp7x5**'` `&&` `$Average > 50`, tidak ada peringatan yang dihasilkan meskipun `nilai metrik rata-rata` instance `i-io8kfvcpp7x5` melebihi 50. Menetapkan ambang batas peringatan khusus untuk instance tertentu dalam aturan. Misalnya, jika Anda menentukan `$Average > ($instanceId == 'i-io8kfvcpp7x5'? 80: 50)`, peringatan dipicu ketika `nilai metrik rata-rata` instance `i-io8kfvcpp7x5**` melebihi 80 atau `nilai metrik rata-rata` instance lain melebihi 50. Membatasi jumlah instance yang nilai metriknya melebihi ambang batas. Misalnya, jika Anda menentukan `count($Average > 20) > 3`, peringatan dipicu hanya ketika jumlah instance yang `nilai metrik rata-ratanya` melebihi 20 lebih dari tiga.
Level	String	No	Critical	Tingkat peringatan. Nilai yang valid: Critical Warn Info
Times	Integer	No	3	Jumlah pemicu berturut-turut. Jika jumlah kali nilai metrik memenuhi kondisi pemicu mencapai nilai parameter ini, CloudMonitor mengirim pemberitahuan peringatan.
Labels.N.Key	String	No	tagKey1	Kunci tag.
Labels.N.Value	String	No	ECS	Nilai tag. Catatan Anda dapat menggunakan parameter templat untuk menentukan nilai tag. CloudMonitor mengganti nilai parameter templat dengan nilai tag aktual.
Prometheus	Object	No		Aturan peringatan Prometheus. Catatan Parameter ini wajib hanya saat Anda membuat aturan peringatan Prometheus untuk Hybrid Cloud Monitoring.
PromQL	String	No	cpuUsage{instanceId="xxxx"}[1m]>90	Pernyataan kueri PromQL. Catatan Data yang diperoleh menggunakan pernyataan kueri PromQL adalah data pemantauan. Anda harus menyertakan ambang batas peringatan dalam pernyataan ini.
Level	String	No	Critical	Tingkat peringatan. Nilai yang valid: Critical Warn Info
Times	Integer	No	3	Jumlah pemicu berturut-turut. Jika jumlah kali nilai metrik memenuhi kondisi pemicu mencapai nilai parameter ini, CloudMonitor mengirim pemberitahuan peringatan.
Annotations	Array	No		Anotasi aturan peringatan Prometheus. Saat peringatan Prometheus dipicu, sistem merender kunci dan nilai yang dianotasi untuk membantu Anda memahami metrik dan aturan peringatan. Catatan Parameter ini setara dengan parameter annotations pada Prometheus open source.
Key	String	No	summary	Kunci anotasi.
Value	String	No	{{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }	Nilai anotasi.

Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Common parameters.

Response parameters

Parameter	Type	Example	Description
Code	String	200	Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa panggilan berhasil.
Message	String	The request processing has failed due to some unknown error.	Pesan yang dikembalikan.
RequestId	String	65D50468-ECEF-48F1-A6E1-D952E89D9436	ID permintaan.
Success	Boolean	true	Menunjukkan apakah panggilan berhasil. Nilai yang valid: true: Panggilan berhasil. false: Panggilan gagal.

Examples

Contoh permintaan

http(s)://[Endpoint]/?Action=PutResourceMetricRule
&ContactGroups=ECS_Group
&MetricName=cpu_total
&Namespace=acs_ecs_dashboard
&Resources=[{"instanceId":"i-uf6j91r34rnwawoo****"}]
&RuleId=a151cd6023eacee2f0978e03863cc1697c89508****
&RuleName=test123
&Escalations.Critical.Statistics=Average
&Escalations.Critical.ComparisonOperator=GreaterThanOrEqualToThreshold
&Escalations.Critical.Threshold=90
&Escalations.Critical.Times=3
&<Common request parameters>

Contoh respons sukses

XML format

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

<PutResourceMetricRuleResponse>
	<Code>200</Code>
	<Message></Message>
	<RequestId>65D50468-ECEF-48F1-A6E1-D952E89D9436</RequestId>
	<Success>true</Success>
</PutResourceMetricRuleResponse>

JSON format

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

{
  "Code" : "200",
  "Message" : "",
  "RequestId" : "65D50468-ECEF-48F1-A6E1-D952E89D9436",
  "Success" : true
}

Error codes

HttpCode	Error code	Error message	Description
429	ResourceOverLimit	The resource has exceeded the limit. %s	Pesan kesalahan yang dikembalikan karena jumlah resource melebihi batas atas.

Untuk daftar kode kesalahan, lihat Service error codes.