All Products
Search

This Product

    Cloud Monitor:PutResourceMetricRule

    Document Center

    Cloud Monitor:PutResourceMetricRule

    Last Updated:Dec 24, 2025

    Mengonfigurasi aturan peringatan.

    Deskripsi operasi

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

    Catatan

    Verifikasi statistik ditambahkan pada 15 Agustus 2024. Hanya nilai statistik dari metrik yang sesuai yang dapat diatur untuk parameter Statistics. Untuk informasi selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Appendix 1: Metrics.

    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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RuleId

    string

    Yes

    ID aturan peringatan.

    Anda dapat menentukan ID baru atau ID aturan peringatan yang sudah ada. Untuk informasi selengkapnya tentang cara menanyakan ID aturan peringatan, lihat DescribeMetricRuleList.

    Catatan

    Jika Anda menentukan ID baru, aturan peringatan yang dipicu berdasarkan ambang batas akan dibuat.

    a151cd6023eacee2f0978e03863cc1697c89508****
    RuleName

    string

    Yes

    Nama aturan peringatan.

    Anda dapat menentukan nama baru atau nama aturan peringatan yang sudah ada. Untuk informasi selengkapnya tentang cara menanyakan nama aturan peringatan, lihat DescribeMetricRuleList.

    Catatan

    Jika Anda menentukan nama baru, aturan peringatan yang dipicu berdasarkan ambang batas akan dibuat.

    test123
    Namespace

    string

    Yes

    Namespace layanan cloud. Untuk informasi selengkapnya tentang cara menanyakan namespace layanan cloud, lihat Appendix 1: Metrics.

    Catatan

    Jika Anda membuat aturan peringatan Prometheus untuk Pemantauan Cloud Hibrida, Anda harus mengatur parameter ini ke acs_prometheus.

    acs_ecs_dashboard
    MetricName

    string

    Yes

    Nama metrik. Untuk informasi selengkapnya tentang cara menanyakan nama metrik, lihat Appendix 1: Metrics.

    Catatan

    Jika Anda membuat aturan peringatan Prometheus untuk Pemantauan Cloud Hibrida, Anda harus mengatur parameter ini ke nama namespace. Untuk informasi selengkapnya tentang cara menanyakan nama namespace, lihat DescribeHybridMonitorNamespaceList.

    cpu_total
    Resources

    string

    No

    Informasi sumber daya. Contoh: [{"instanceId":"i-uf6j91r34rnwawoo****"}] dan [{"userId":"100931896542****"}].

    Untuk informasi selengkapnya tentang dimensi yang didukung untuk menanyakan sumber daya, lihat Appendix 1: Metrics.

    [{"instanceId":"i-uf6j91r34rnwawoo****"}]
    ContactGroups

    string

    Yes

    Kelompok kontak peringatan. Pemberitahuan peringatan dikirim ke kontak peringatan dalam kelompok kontak peringatan.

    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.

    ECS_Group
    Webhook

    string

    No

    URL callback tempat permintaan POST dikirim ketika peringatan dipicu berdasarkan aturan peringatan.

    https://alert.aliyun.com.com:8080/callback
    EffectiveInterval

    string

    No

    Periode waktu saat aturan peringatan berlaku.

    00:00-23:59
    NoEffectiveInterval

    string

    No

    Periode waktu saat aturan peringatan tidak berlaku.

    00:00-06:00
    SilenceTime

    integer

    No

    Periode bisu selama pemberitahuan peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi. Satuan: detik. Nilai default: 86400.

    Catatan

    Jika peringatan belum terselesaikan setelah periode bisu berakhir, CloudMonitor mengirim ulang pemberitahuan peringatan.

    86400
    Period

    string

    No

    Periode statistik metrik. Satuan: detik. Nilai default adalah interval pengumpulan data pemantauan metrik.

    Catatan

    Untuk informasi selengkapnya tentang cara menanyakan periode statistik metrik, lihat Appendix 1: Metrics.

    60
    Interval

    string

    No

    Interval pemicuan peringatan berdasarkan aturan peringatan. Satuan: detik.

    Catatan

    Untuk informasi selengkapnya tentang cara menanyakan periode statistik metrik, lihat Appendix 1: Metrics.

    60
    EmailSubject

    string

    No

    Subjek email pemberitahuan peringatan.

    ECS实例报警
    Escalations.Critical.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Critical.

    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 selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Appendix 1: Metrics.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    Average
    Escalations.Critical.ComparisonOperator

    string

    No

    Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Critical. Nilai 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

    • EqualToThreshold: 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

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    GreaterThanOrEqualToThreshold
    Escalations.Critical.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Critical.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    90
    Escalations.Critical.Times

    integer

    No

    Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Critical dipicu.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    3
    Escalations.Warn.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Warn.

    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 selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Appendix 1: Metrics.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    Average
    Escalations.Warn.ComparisonOperator

    string

    No

    Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Warn. Nilai 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

    • EqualToThreshold: 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

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Warn.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    90
    Escalations.Warn.Times

    integer

    No

    Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Warn dipicu.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    3
    Escalations.Info.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Info.

    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 selengkapnya tentang cara mendapatkan nilai parameter ini, lihat Appendix 1: Metrics.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    Average
    Escalations.Info.ComparisonOperator

    string

    No

    Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas untuk peringatan tingkat Info. Nilai 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

    • EqualToThreshold: 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

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    GreaterThanOrEqualToThreshold
    Escalations.Info.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Info.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    90
    Escalations.Info.Times

    integer

    No

    Jumlah kali berturut-turut nilai metrik memenuhi kondisi peringatan sebelum peringatan tingkat Info dipicu.

    Catatan

    Anda harus memilih minimal satu dari tingkat peringatan Critical, Warn, dan Info serta menentukan parameter Statistics, ComparisonOperator, Threshold, dan Times untuk setiap tingkat peringatan.

    3
    NoDataPolicy

    string

    No

    Metode yang digunakan untuk menangani peringatan ketika tidak ditemukan data pemantauan. Nilai valid:

    • KEEP_LAST_STATE (default): Tidak ada operasi yang dilakukan.

    • INSUFFICIENT_DATA: Peringatan dengan konten "Insufficient data" dipicu.

    • OK: Status dianggap normal.

    KEEP_LAST_STATE
    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<object>

    No

    Kondisi pemicu yang dibuat dalam mode standar.

    object

    No

    Kondisi pemicu yang dibuat dalam mode standar.

    MetricName

    string

    No

    Metrik yang digunakan untuk memantau layanan cloud.

    cpu_total
    Period

    integer

    No

    Periode agregasi metrik.

    Satuan: detik.

    60
    Statistics

    string

    No

    Metode statistik metrik. Nilai valid:

    • $Maximum: nilai maksimum

    • $Minimum: nilai minimum

    • $Average: nilai rata-rata

    • $Availability: laju ketersediaan (biasanya digunakan untuk pemantauan situs)

    Catatan

    $ adalah awalan metrik. Untuk informasi tentang layanan Alibaba Cloud yang didukung oleh CloudMonitor, lihat Appendix 1: Metrics.

    $Maximum
    ComparisonOperator

    string

    No

    Operator yang digunakan untuk membandingkan nilai metrik dengan ambang batas. Nilai 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

    • EqualToThreshold: 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

    GreaterThanOrEqualToThreshold
    Threshold

    string

    No

    Ambang batas peringatan.

    90
    ExpressionListJoin

    string

    No

    Hubungan antara kondisi pemicu untuk beberapa metrik. Nilai 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

    Kondisi pemicu yang dibuat menggunakan ekspresi. Anda dapat menggunakan ekspresi untuk membuat kondisi pemicu dalam skenario berikut:

    • Menetapkan blacklist peringatan untuk sumber daya tertentu. Misalnya, jika Anda menentukan $instanceId != 'i-io8kfvcpp7x5****' ``&&`` $Average > 50, tidak ada peringatan yang dipicu ketika nilai metrik rata-rata dari instans i-io8kfvcpp7x5**** melebihi 50.

    • Menetapkan ambang batas peringatan khusus untuk instans tertentu dalam aturan. Misalnya, jika Anda menentukan $Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50), peringatan dipicu ketika nilai metrik rata-rata dari instans i-io8kfvcpp7x5**** melebihi 80 atau nilai metrik rata-rata dari instans lain melebihi 50.

    • Membatasi jumlah instans yang nilai metriknya melebihi ambang batas. Misalnya, jika Anda menentukan count($Average > 20) > 3, peringatan dipicu hanya ketika nilai metrik rata-rata dari lebih dari tiga instans melebihi 20.

    $Average > ($instanceId == 'i-io8kfvcpp7x5****'? 80: 50)
    Level

    string

    No

    Tingkat peringatan. Nilai valid:

    • Critical

    • Warn

    • Info

    CRITICAL
    Times

    integer

    No

    Jumlah pemicuan berturut-turut. Jika jumlah kali nilai metrik memenuhi kondisi pemicu mencapai nilai parameter ini, CloudMonitor mengirim pemberitahuan peringatan.

    3
    Labels

    array<object>

    No

    Jika metrik memenuhi kondisi yang ditentukan dalam aturan peringatan dan CloudMonitor mengirim pemberitahuan peringatan, tag juga ditulis ke metrik dan ditampilkan dalam pemberitahuan peringatan.

    Catatan

    Parameter ini setara dengan parameter Label pada peringatan Prometheus.

    object

    No

    Kunci tag.

    Key

    string

    No

    Kunci tag.

    tagKey1
    Value

    string

    No

    Nilai tag.

    Catatan

    Anda dapat menggunakan parameter templat untuk menentukan nilai tag. CloudMonitor mengganti nilai parameter templat dengan nilai tag aktual.

    ECS
    Prometheus

    object

    No

    Peringatan Prometheus.

    Catatan

    Parameter ini wajib jika Anda membuat aturan peringatan Prometheus untuk Pemantauan Cloud Hibrida.

    PromQL

    string

    No

    Pernyataan PromQL didukung.

    Catatan

    Data yang diperoleh dengan menggunakan pernyataan kueri PromQL adalah data pemantauan. Anda harus menyertakan ambang batas peringatan dalam pernyataan ini.

    cpuUsage{instanceId="xxxx"}[1m]>90
    Level

    string

    No

    Tingkat peringatan. Nilai valid:

    • Critical

    • Warn

    • Info

    CRITICAL
    Times

    integer

    No

    Jumlah pemicuan berturut-turut. Jika jumlah kali nilai metrik memenuhi kondisi pemicu mencapai nilai parameter ini, CloudMonitor mengirim pemberitahuan peringatan.

    3
    Annotations

    array<object>

    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.

    object

    No

    Anotasi aturan peringatan Prometheus. Saat peringatan Prometheus dipicu, sistem merender kunci dan nilai yang dianotasi untuk membantu Anda memahami metrik dan aturan peringatan.

    Key

    string

    No

    Kunci anotasi.

    summary
    Value

    string

    No

    Nilai anotasi.

    {{ $labels.instance }} CPU usage above 10% {current value: {{ humanizePercentage $value }} }

    Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Common parameters.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Tidak ada.

    Code

    string

    Kode respons.

    Catatan

    Kode status 200 menunjukkan bahwa permintaan berhasil.

    200
    Message

    string

    Pesan yang dikembalikan.

    The request processing has failed due to some unknown error.
    RequestId

    string

    ID permintaan.

    65D50468-ECEF-48F1-A6E1-D952E89D9436
    Success

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai valid:

    • true

    • false

    true

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "65D50468-ECEF-48F1-A6E1-D952E89D9436",
  "Success": true
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 %s %s
    499 %s %s
    500 InternalError The request processing has failed due to some unknown error.
    204 %s %s
    403 %s %s
    206 %s %s
    404 %s %s
    503 %s %s
    406 %s %s
    429 ResourceOverLimit The resource has exceeded the limit. %s

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.