PutGroupMetricRule - - Alibaba Cloud Documentation Center

Membuat atau memperbarui aturan peringatan untuk kelompok aplikasi.

Topik ini memberikan contoh cara membuat aturan peringatan untuk metrik cpu_total Elastic Compute Service (ECS) dalam kelompok aplikasi 17285****. ID aturan peringatan adalah 123456, dengan nama Rule_test. Tingkat peringatan ditetapkan sebagai Critical, metode statistik menggunakan Average, dan operator pembanding ambang batas peringatan adalah GreaterThanOrEqualToThreshold. Ambang batas peringatan diatur pada 90, dengan jumlah pengulangan peringatan sebanyak 3. Respons menunjukkan bahwa aturan peringatan berhasil dibuat, dengan ID aturan peringatan 123456.

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.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	PutGroupMetricRule	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke PutGroupMetricRule.
GroupId	String	Yes	17285****	ID kelompok aplikasi. Untuk informasi tentang cara mendapatkan ID kelompok aplikasi, lihat DescribeMonitorGroups.
RuleId	String	Yes	123456	ID aturan peringatan. Saat membuat aturan peringatan untuk kelompok aplikasi, masukkan ID aturan peringatan tersebut. Saat mengubah aturan peringatan tertentu dalam kelompok aplikasi, Anda harus mendapatkan ID aturan peringatan tersebut. Untuk informasi tentang cara mendapatkan ID aturan peringatan, lihat DescribeMetricRuleList.
Category	String	No	ECS	Singkatan nama layanan cloud. Untuk informasi lebih lanjut tentang cara mendapatkan singkatan nama layanan cloud, lihat `metricCategory` pada parameter respons `Labels` dari operasi DescribeProjectMeta.
RuleName	String	Yes	Rule_01	Nama aturan peringatan. Saat membuat aturan peringatan untuk kelompok aplikasi, masukkan nama aturan peringatan tersebut. Saat mengubah aturan peringatan tertentu dalam kelompok aplikasi, Anda harus mendapatkan nama aturan peringatan tersebut. Untuk informasi tentang cara mendapatkan nama aturan peringatan, lihat DescribeMetricRuleList.
Namespace	String	Yes	acs_ecs_dashboard	Namespace layanan cloud. Untuk informasi tentang cara mendapatkan namespace layanan cloud, lihat DescribeMetricMetaList atau Lampiran 1: Metrics.
MetricName	String	Yes	cpu_total	Nama metrik. Untuk informasi tentang cara mendapatkan nama metrik, lihat DescribeMetricMetaList atau Lampiran 1: Metrics.
Dimensions	String	No	[{"instanceId":"i-m5e1qg6uo38rztr4****"}]	Dimensi tingkat pertama aturan peringatan dalam kelompok aplikasi. Tetapkan nilainya sebagai kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-m5e1qg6uo38rztr4**"}`.
ExtraDimensionJson	String	No	{"/dev/xvda":"d-m5e6yphgzn3aprwu****"}	Dimensi tingkat kedua atau ketiga aturan peringatan dalam kelompok aplikasi. Tetapkan nilainya sebagai kumpulan pasangan `key:value`. Contoh: `port:80` atau `/dev/xvda:d-m5e6yphgzn3aprwu**`. Jika dimensi tingkat pertama aturan peringatan adalah `{"instanceId":"i-m5e1qg6uo38rztr4"}`, maka dimensi tingkat keduanya adalah disk `{"/dev/xvda":"d-m5e6yphgzn3aprwu**"}` dalam instans tersebut.
EffectiveInterval	String	No	05:31-23:59	Periode waktu saat aturan peringatan berlaku.
NoEffectiveInterval	String	No	00:00-05:30	Periode waktu saat aturan peringatan tidak berlaku.
SilenceTime	Integer	No	86400	Periode bisu selama notifikasi peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi. Unit: detik. Nilai default: 86400.
Period	String	No	60	Periode agregasi data metrik. Tetapkan parameter `Period` ke kelipatan bulat dari 60. Unit: detik. Nilai default: 300.
Interval	String	No	60	Interval pemeriksaan CloudMonitor untuk mengevaluasi apakah aturan peringatan dipicu. Unit: detik. Catatan Kami menyarankan agar Anda menetapkan interval sama dengan periode agregasi data. Jika interval lebih pendek daripada periode agregasi data, peringatan tidak dapat dipicu karena data tidak mencukupi.
Webhook	String	No	https://www.aliyun.com	URL callback. URL callback harus dapat diakses melalui Internet. CloudMonitor mengirim permintaan POST untuk mendorong notifikasi peringatan ke URL callback yang Anda tentukan. Hanya permintaan HTTP yang didukung.
EmailSubject	String	No	ECS instance	Subjek email notifikasi peringatan.
ContactGroups	String	No	ECS_Group	Kelompok kontak peringatan.
Escalations.Critical.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Critical. Pisahkan beberapa metode statistik dengan koma (,). Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan parameter `MetricName` layanan cloud yang ditentukan. Nilai parameter ini dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara mendapatkan nilai parameter ini, lihat Lampiran 1: Metrics.
Escalations.Critical.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator pembanding 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: kurang dari atau sama dengan ambang batas LessThanThreshold: kurang dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: kurang dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: kurang dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: kurang dari nilai metrik pada siklus pemantauan sebelumnya
Escalations.Critical.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Critical.
Escalations.Critical.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Critical dipicu.
Escalations.Warn.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Warn. Pisahkan beberapa metode statistik dengan koma (,). Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan parameter `MetricName` layanan cloud yang ditentukan. Nilai parameter ini dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara mendapatkan nilai parameter ini, lihat Lampiran 1: Metrics.
Escalations.Warn.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator pembanding 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: kurang dari atau sama dengan ambang batas LessThanThreshold: kurang dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: kurang dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: kurang dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: kurang dari nilai metrik pada siklus pemantauan sebelumnya
Escalations.Warn.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Warn.
Escalations.Warn.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Warn dipicu.
Escalations.Info.Statistics	String	No	Average	Metode statistik untuk peringatan tingkat Info. Pisahkan beberapa metode statistik dengan koma (,). Nilai parameter ini ditentukan oleh kolom `Statistics` yang sesuai dengan parameter `MetricName` layanan cloud yang ditentukan. Nilai parameter ini dapat berupa Maximum, Minimum, atau Average. Untuk informasi lebih lanjut tentang cara mendapatkan nilai parameter ini, lihat Lampiran 1: Metrics.
Escalations.Info.ComparisonOperator	String	No	GreaterThanOrEqualToThreshold	Operator pembanding 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: kurang dari atau sama dengan ambang batas LessThanThreshold: kurang dari ambang batas NotEqualToThreshold: tidak sama dengan ambang batas GreaterThanYesterday: lebih besar dari nilai metrik pada waktu yang sama kemarin LessThanYesterday: kurang dari nilai metrik pada waktu yang sama kemarin GreaterThanLastWeek: lebih besar dari nilai metrik pada waktu yang sama minggu lalu LessThanLastWeek: kurang dari nilai metrik pada waktu yang sama minggu lalu GreaterThanLastPeriod: lebih besar dari nilai metrik pada siklus pemantauan sebelumnya LessThanLastPeriod: kurang dari nilai metrik pada siklus pemantauan sebelumnya
Escalations.Info.Threshold	String	No	90	Ambang batas untuk peringatan tingkat Info.
Escalations.Info.Times	Integer	No	3	Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Info dipicu.
NoDataPolicy	String	No	KEEP_LAST_STATE	Metode penanganan peringatan saat tidak ditemukan data pemantauan. Nilai yang valid: KEEP_LAST_STATE (default): Tidak ada tindakan yang dilakukan. INSUFFICIENT_DATA: Peringatan dengan isi "Insufficient data" dipicu. OK: Status dianggap normal.
Labels.N.Key	String	No	key1	Kunci tag aturan peringatan.
Labels.N.Value	String	No	value1	Nilai tag aturan peringatan.

Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

Parameter respons

Parameter	Type	Contoh	Deskripsi
Code	String	200	Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.
Message	String	The Request is not authorization.	Pesan kesalahan.
RequestId	String	461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D	ID permintaan.
Success	Boolean	true	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true false
Result	Object		Hasil permintaan.
RuleId	String	123456	ID aturan peringatan.

Contoh

Contoh permintaan

http(s)://[Endpoint]/?Action=PutGroupMetricRule
&Category=ECS
&GroupId=17285****
&MetricName=cpu_total
&Namespace=acs_ecs_dashboard
&RuleId=123456
&RuleName=`Rule_test
&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

<PutGroupMetricRuleResponse>
	<Message></Message>
	<RequestId>461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D</RequestId>
	<Code>200</Code>
	<Success>true</Success>
	<Result>
		<RuleId>123456</RuleId>
	</Result>
</PutGroupMetricRuleResponse>

JSON format

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

{
  "Message" : "",
  "RequestId" : "461CF2CD-2FC3-4B26-8645-7BD27E7D0F1D",
  "Code" : 200,
  "Success" : true,
  "Result" : {
    "RuleId" : "123456"
  }
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.