UpdatePrometheusAlertRule - Application Real-Time Monitoring Service

Memperbarui aturan peringatan Prometheus dengan memanggil operasi UpdatePrometheusAlertRule.

Deskripsi operasi

Operasi UpdatePrometheusAlertRule tidak lagi dipelihara. Gunakan operasi CreateOrUpdateAlertRule untuk membuat atau memperbarui aturan peringatan.

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

arms:UpdatePrometheusAlertRule

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
AlertName	string	Yes	Nama aturan peringatan.	Prometheus_Alert
ClusterId	string	Yes	ID kluster.	c0bad479465464e1d8c1e641b0afb****
Type	string	No	Tipe aturan peringatan kustom.	Kubernetes组件告警
NotifyType	string	No	Tipe notifikasi. Nilai valid: `ALERT_MANAGER`: Notifikasi dikirim melalui pusat operasi peringatan. `DISPATCH_RULE`: Notifikasi dikirim berdasarkan kebijakan notifikasi yang ditentukan.	ALERT_MANAGER
DispatchRuleId	integer	No	ID kebijakan notifikasi. Parameter ini wajib diisi ketika NotifyType diatur ke `DISPATCH_RULE`.	10282
Expression	string	Yes	Ekspresi peringatan, yang harus berupa pernyataan PromQL.	100 * (sum(rate(container_cpu_usage_seconds_total[1m])) by (pod_name) / sum(label_replace(kube_pod_container_resource_limits_cpu_cores, \"pod_name\", \"$1\", \"pod\", \"(.*)\")) by (pod_name))>75
Duration	string	Yes	Durasi. Nilai valid: 1m hingga 1440m. Unit: menit.	1
Message	string	Yes	Paket peringatan. Tag dapat direferensikan dalam format {{$labels.xxx}}.	${{$labels.pod_name}}CPU使用率大于80%，当前值{{$value}}%
Labels	string	No	String JSON label. Atur Name dan Value label.	[{"Value": "critical","Name": "severity"}]
Annotations	string	No	String JSON anotasi. Atur Name dan Value anotasi.	[{"Value": "xxx","Name": "description"}]
AlertId	integer	Yes	ID aturan peringatan. Anda dapat memperoleh ID dari data tanggapan operasi API ListPrometheusAlertRules.	3888704
Tags	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag.	TestKey
Value	string	No	Nilai tag.	TestValue

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	9FEA6D00-317F-45E3-9004-7FB8B0B7****
PrometheusAlertRule	object	Struct tanggapan.
Status	integer	Status aturan peringatan. Nilai valid: `1`: diaktifkan `0`: dinonaktifkan.	1
Type	string	Tipe aturan peringatan.	Kubernetes组件告警
NotifyType	string	Tipe notifikasi. Nilai valid: `ALERT_MANAGER`: Notifikasi dikirim melalui pusat operasi peringatan. `DISPATCH_RULE`: Notifikasi dikirim berdasarkan kebijakan notifikasi yang ditentukan.	ALERT_MANAGER
Expression	string	Ekspresi peringatan.	100 * (sum(rate(container_cpu_usage_seconds_total[1m])) by (pod_name) / sum(label_replace(kube_pod_container_resource_limits_cpu_cores, \"pod_name\", \"$1\", \"pod\", \"(.*)\")) by (pod_name))>75
Message	string	Paket notifikasi peringatan. Tag dapat direferensikan dalam format {{$labels.xxx}}.	${{$labels.pod_name}}CPU使用率大于80%，当前值{{$value}}%
Duration	string	Durasi. Nilai valid: 1m hingga 1440m. Unit: menit.	1
DispatchRuleId	integer	ID kebijakan notifikasi.	10282
AlertName	string	Nama aturan peringatan.	Prometheus_Alert
AlertId	integer	ID aturan peringatan.	3888704
ClusterId	string	ID kluster.	c0bad479465464e1d8c1e641b0afb****
Labels	array<object>	Label aturan peringatan.
	object
Name	string	The name of the tag.	severity
Value	string	The value of the tag.	critical
Annotations	array<object>	Anotasi aturan peringatan.
	object
Name	string	The name of the annotation.	message
Value	string	The value of the annotation.	${{$labels.pod_name}}CPU使用率大于80%，当前值{{$value}}%
Code	integer	Kode status. Nilai 200 menunjukkan keberhasilan. Nilai lain menunjukkan error.	200
Message	string	Paket yang dikembalikan.	success
Success	boolean	Apakah operasi berhasil. Nilai valid: `true`: Operasi berhasil. `false`: Operasi gagal.	True

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9FEA6D00-317F-45E3-9004-7FB8B0B7****",
  "PrometheusAlertRule": {
    "Status": 1,
    "Type": "Kubernetes组件告警",
    "NotifyType": "ALERT_MANAGER",
    "Expression": "100 * (sum(rate(container_cpu_usage_seconds_total[1m])) by (pod_name) / sum(label_replace(kube_pod_container_resource_limits_cpu_cores, \\\"pod_name\\\", \\\"$1\\\", \\\"pod\\\", \\\"(.*)\\\")) by (pod_name))>75",
    "Message": "${{$labels.pod_name}}CPU使用率大于80%，当前值{{$value}}%",
    "Duration": "1",
    "DispatchRuleId": 10282,
    "AlertName": "Prometheus_Alert",
    "AlertId": 3888704,
    "ClusterId": "c0bad479465464e1d8c1e641b0afb****",
    "Labels": [
      {
        "Name": "severity",
        "Value": "critical"
      }
    ],
    "Annotations": [
      {
        "Name": "message",
        "Value": "${{$labels.pod_name}}CPU使用率大于80%，当前值{{$value}}%"
      }
    ]
  },
  "Code": 200,
  "Message": "success",
  "Success": true
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.