Kueri resource yang secara aktif memicu peringatan dengan menggunakan DescribeAlertingMetricRuleResources - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Mengkueri daftar Sumber daya yang menjadi Pemicu peringatan untuk aturan peringatan tertentu.

Deskripsi operasi

Topik ini menyediakan contoh cara mengatur aturan peringatan berbasis ambang batas untuk metrik cpu_total dari Instans ECS i-uf6j91r34rnwawoo**** di namespace acs_ecs_dashboard. Kelompok kontak peringatan adalah ECS_Group, nama aturan peringatan adalah test123, ID aturan peringatan adalah a151cd6023eacee2f0978e03863cc1697c89508****, metode statistik untuk level Critical adalah Average, operator perbandingan untuk level Critical adalah GreaterThanOrEqualToThreshold, ambang batas untuk level Critical adalah 90, dan jumlah percobaan ulang untuk level Critical adalah 3.

Catatan

Pada 15 Agustus 2024, validasi Statistik ditingkatkan. Nilai statistik harus sesuai dengan Statistics metrik. Untuk informasi lebih lanjut tentang cara mendapatkan nilai parameter ini, lihat Metrik pemantauan layanan Alibaba Cloud.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cms:DescribeAlertingMetricRuleResources

get

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RuleId	string	No	ID aturan peringatan. Untuk informasi lebih lanjut tentang cara mengkueri ID aturan peringatan, lihat DescribeMetricRuleList.	putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****
GroupId	string	No	ID kelompok aplikasi. Untuk informasi lebih lanjut tentang cara mengkueri ID kelompok aplikasi, lihat DescribeMonitorGroups.	7671****
Page	integer	No	Nomor halaman. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai default: 10.	10
Namespace	string	No	Namespace data layanan Alibaba Cloud. Untuk informasi lebih lanjut tentang cara mendapatkan namespace data layanan Alibaba Cloud, lihat Metrik pemantauan layanan Alibaba Cloud.	acs_mns_new.
Dimensions	string	No	Peta dimensi yang digunakan untuk mengkueri data pemantauan Sumber daya tertentu.	{\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}
AlertBeforeTime	string	No	Mengkueri peringatan yang terjadi sebelum pengatur waktu ini. Nilainya adalah timestamp tingkat milidetik.	1698827400000

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

Elemen respons

Element	Type	Description	Example
	object	Tidak ada.
Code	integer	Kode status. Catatan Nilai 200 menunjukkan keberhasilan.	200
Message	string	Paket error.	The request processing has failed due to some unknown error.
RequestId	string	ID permintaan.	0724011B-D9E0-4B2F-8C51-F17A894CC42C
Total	integer	Jumlah total rekaman.	2
Success	boolean	Apakah operasi berhasil. Nilai valid: true: Operasi berhasil. false: Operasi gagal.	true.
Resources	object
Resource	array<object>	Daftar Sumber daya yang terkait dengan aturan peringatan.
	array<object>	Tidak ada.
MetricName	string	Nama metrik.	ActiveMessages
RetryTimes	string	Jumlah percobaan ulang peringatan.	3
MetricValues	string	Nilai metrik saat peringatan dipicu. Nilainya adalah string JSON.	{\"timestamp\":1623727500000,\"Sum\":926,\"value\":463,\"Maximum\":463,\"Minimum\":463,\"Average\":463,\"SampleCount\":2,\"userId\":\"120886317861****\",\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\"}
Namespace	string	Namespace layanan cloud.	acs_mns_new
RuleName	string	Nama aturan peringatan.	test123456789
RuleId	string	ID aturan peringatan.	putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****
ProductCategory	string	Tipe layanan cloud.	mns
StartTime	string	Timestamp saat Sumber daya dikaitkan dengan aturan peringatan. Unit: milidetik.	1622427900000
Resource	string	Sumber daya yang memicu peringatan.	userId=120886317861****,region=cn-huhehaote,queue=test-0128
LastModifyTime	string	Timestamp saat aturan peringatan terakhir diubah. Unit: milidetik.	1622827900000
GroupId	string	ID kelompok aplikasi. Catatan Jika aturan peringatan dikaitkan dengan kelompok aplikasi tertentu, ID kelompok aplikasi ini akan ditampilkan.	7671****
Dimensions	string	Peta dimensi yang digunakan untuk mengkueri data pemantauan untuk Sumber daya tertentu.	{\"region\":\"cn-huhehaote\",\"queue\":\"test-0128\",\"userId\":\"120886317861****\"}
LastAlertTime	string	Timestamp saat peringatan terakhir dipicu. Unit: milidetik.	1622427900000
Level	integer	Tingkat peringatan dan metode Notifikasi. Nilai valid: 4: email + chatbot DingTalk. OK: tidak ada peringatan.	3
Threshold	string	Ambang batas peringatan.	10
Statistics	string	Metode statistik untuk peringatan.	Average
Enable	string	Apakah aturan peringatan diaktifkan. Nilai valid: true: Aturan peringatan diaktifkan. false: Aturan peringatan dinonaktifkan.	true
Escalation	object
Resource	array<object>	Aturan yang memicu peringatan.
	array<object>	Tidak ada.
ComparisonOperator	string	Operator perbandingan ambang batas. Nilai valid: GreaterThanOrEqualToThreshold: lebih besar atau sama dengan GreaterThanThreshold: lebih besar dari LessThanOrEqualToThreshold: lebih kecil atau sama dengan LessThanThreshold: lebih kecil dari NotEqualToThreshold: tidak sama dengan GreaterThanYesterday: meningkat pengatur waktu yang sama kemarin LessThanYesterday: menurun pengatur waktu yang sama kemarin GreaterThanLastWeek: meningkat pengatur waktu yang sama minggu lalu LessThanLastWeek: menurun pengatur waktu yang sama minggu lalu GreaterThanLastPeriod: meningkat dibandingkan periode sebelumnya LessThanLastPeriod: menurun dibandingkan periode sebelumnya	GreaterThanOrEqualToThreshold
PreCondition	string	Simbol perbandingan ambang batas. Nilai valid: `>=` `=` `<=` `>` `<` `!=`	>=
Expression	string	Deskripsi aturan yang memicu peringatan. Catatan Ini adalah isi aturan peringatan. Ketika data pemantauan memenuhi kondisi peringatan, aturan peringatan akan dipicu.	$Average>=10
Times	integer	Jumlah percobaan ulang peringatan.	1
Tag	string	Parameter ini sudah tidak digunakan lagi dan dapat diabaikan.	Deprecated: true
Threshold	string	Ambang batas peringatan.	10
Level	integer	Tingkat peringatan dan metode Notifikasi. Nilai valid: 4: email + chatbot DingTalk. OK: tidak ada peringatan.	3
ExpressionListJoin	string	Hubungan antara beberapa metrik. Nilai valid: &&: Pemberitahuan peringatan dikirim hanya ketika semua metrik memenuhi kondisi peringatan. \|\|: Pemberitahuan peringatan dikirim ketika salah satu metrik memenuhi kondisi peringatan.	&&
ExpressionList	object
ExpressionList	array<object>	Deskripsi aturan peringatan multi-metrik.
	object	Tidak ada.
ComparisonOperator	string	Operator perbandingan ambang batas untuk tingkat peringatan. Nilai valid: GreaterThanOrEqualToThreshold: lebih besar atau sama dengan GreaterThanThreshold: lebih besar dari LessThanOrEqualToThreshold: lebih kecil atau sama dengan LessThanThreshold: lebih kecil dari NotEqualToThreshold: tidak sama dengan GreaterThanYesterday: meningkat pengatur waktu yang sama kemarin LessThanYesterday: menurun pengatur waktu yang sama kemarin GreaterThanLastWeek: meningkat pengatur waktu yang sama minggu lalu LessThanLastWeek: menurun pengatur waktu yang sama minggu lalu GreaterThanLastPeriod: meningkat dibandingkan periode sebelumnya LessThanLastPeriod: menurun dibandingkan periode sebelumnya	GreaterThanOrEqualToThreshold
MetricName	string	Nama metrik.	cpu_total
Period	string	Periode statistik metrik. Unit: detik. Nilai default adalah periode pelaporan asli metrik.	60
Statistics	string	Metode statistik untuk tingkat peringatan. Nilai valid: Maximum: nilai maksimum Minimum: nilai minimum Average: nilai rata-rata	Average
Threshold	string	Ambang batas peringatan.	90
ExpressionRaw	string	Kondisi peringatan yang dibuat menggunakan ekspresi. Skenario berikut didukung namun tidak terbatas pada: Menetapkan blacklist peringatan untuk Sumber daya tertentu. Misalnya, $instanceId != 'i-io8kfvcpp7x5**' ``&&`` $Average > 50 menentukan bahwa tidak ada peringatan yang dipicu untuk instans `i-io8kfvcpp7x5` meskipun `Average`-nya melebihi 50. Menetapkan ambang batas peringatan khusus untuk instans tertentu dalam aturan. Misalnya, `$Average > ($instanceId == 'i-io8kfvcpp7x5'? 80: 50)` menentukan bahwa peringatan dipicu untuk instans `i-io8kfvcpp7x5**` hanya ketika `Average`-nya melebihi 80, sedangkan peringatan dipicu untuk instans lain ketika `Average`-nya melebihi 50. Membatasi jumlah instans yang melebihi ambang batas. Misalnya, `count($Average > 20) > 3` menentukan bahwa peringatan dipicu hanya ketika lebih dari tiga instans dalam aturan peringatan memiliki `Average` lebih besar dari 20.	$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)

Contoh

Respons sukses

JSONformat

{
  "Code": 200,
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "0724011B-D9E0-4B2F-8C51-F17A894CC42C",
  "Total": 2,
  "Success": true,
  "Resources": {
    "Resource": [
      {
        "MetricName": "ActiveMessages",
        "RetryTimes": "3",
        "MetricValues": "{\\\"timestamp\\\":1623727500000,\\\"Sum\\\":926,\\\"value\\\":463,\\\"Maximum\\\":463,\\\"Minimum\\\":463,\\\"Average\\\":463,\\\"SampleCount\\\":2,\\\"userId\\\":\\\"120886317861****\\\",\\\"region\\\":\\\"cn-huhehaote\\\",\\\"queue\\\":\\\"test-0128\\\"}",
        "Namespace": "acs_mns_new",
        "RuleName": "test123456789",
        "RuleId": "putNewAlarm_user_7e78d765-0e3e-4671-ba6d-7ce39108****",
        "ProductCategory": "mns",
        "StartTime": "1622427900000",
        "Resource": "userId=120886317861****,region=cn-huhehaote,queue=test-0128",
        "LastModifyTime": "1622827900000",
        "GroupId": "7671****",
        "Dimensions": "{\\\"region\\\":\\\"cn-huhehaote\\\",\\\"queue\\\":\\\"test-0128\\\",\\\"userId\\\":\\\"120886317861****\\\"}",
        "LastAlertTime": "1622427900000",
        "Level": 3,
        "Threshold": "10",
        "Statistics": "Average",
        "Enable": "true",
        "Escalation": {
          "Resource": [
            {
              "ComparisonOperator": "GreaterThanOrEqualToThreshold",
              "PreCondition": ">=",
              "Expression": "$Average>=10",
              "Times": 1,
              "Tag": "Deprecated: true",
              "Threshold": "10",
              "Level": 3,
              "ExpressionListJoin": "&&",
              "ExpressionList": {
                "ExpressionList": [
                  {
                    "ComparisonOperator": "GreaterThanOrEqualToThreshold",
                    "MetricName": "cpu_total",
                    "Period": "60",
                    "Statistics": "Average",
                    "Threshold": "90"
                  }
                ]
              },
              "ExpressionRaw": "$Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	%s	%s
500	%s	%s
500	InternalError	The request processing has failed due to some unknown error.
403	%s	%s
404	%s	%s
503	%s	%s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.