全部产品
Search

搜索本产品

    Cloud Monitor：PutResourceMetricRules

    文档中心

    Cloud Monitor：PutResourceMetricRules

    更新时间：Dec 24, 2025

    Membuat beberapa aturan peringatan untuk metrik tertentu dari resource yang ditentukan.

    Deskripsi operasi

    Topik ini memberikan contoh cara membuat aturan peringatan berbasis 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. ID aturan peringatan adalah a151cd6023eacee2f0978e03863cc1697c89508****. Metode statistik untuk peringatan tingkat Critical adalah Average. Operator perbandingan untuk peringatan tingkat Critical adalah GreaterThanOrEqualToThreshold. Ambang batas untuk peringatan tingkat Critical adalah 90. Jumlah kali berturut-turut nilai metrik memenuhi kondisi pemicu sebelum peringatan tingkat Critical 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
    Rules

    array<object>

    Yes

    Aturan peringatan berbasis ambang batas.

    Nilai valid N: 1 hingga 500.

    array<object>

    No

    Metode statistik untuk peringatan tingkat Warn. Nilai valid:

    • Maximum: nilai maksimum

    • Minimum: nilai minimum

    • Average: nilai rata-rata

    • Availability: laju ketersediaan

    Nilai valid N: 1 hingga 500.

    Catatan

    Anda harus mengatur kumpulan parameter Rules.N.Escalations.Critical.Statistics, Rules.N.Escalations.Critical.ComparisonOperator, Rules.N.Escalations.Critical.Threshold, dan Rules.N.Escalations.Critical.Times; atau kumpulan parameter Rules.N.Escalations.Warn.Statistics, Rules.N.Escalations.Warn.ComparisonOperator, Rules.N.Escalations.Warn.Threshold, dan Rules.N.Escalations.Warn.Times; atau kumpulan parameter Rules.N.Escalations.Info.Statistics, Rules.N.Escalations.Info.ComparisonOperator, Rules.N.Escalations.Info.Threshold, dan Rules.N.Escalations.Info.Times.

    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 tersebut.

    90
    MetricName

    string

    No

    Nama metrik.

    Nilai valid N: 1 hingga 500.

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

    cpu_total
    Escalations.Warn.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Warn.

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    90
    EffectiveInterval

    string

    No

    Periode waktu ketika aturan peringatan berlaku.

    Nilai valid N: 1 hingga 500.

    00:00-23:59
    NoEffectiveInterval

    string

    No

    Periode waktu ketika aturan peringatan tidak berlaku.

    Nilai valid N: 1 hingga 500.

    00:00-06:00
    RuleId

    string

    Yes

    ID aturan peringatan.

    Nilai valid N: 1 hingga 500.

    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 berbasis ambang batas akan dibuat.

    a151cd6023eacee2f0978e03863cc1697c89508****
    Escalations.Critical.Times

    integer

    No

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

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    3
    Escalations.Critical.Threshold

    string

    No

    Ambang batas untuk peringatan tingkat Critical.

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    90
    Escalations.Critical.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Critical.

    Nilai valid N: 1 hingga 500.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan parameter MetricName dari 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 tersebut.

    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 dalam siklus pemantauan terakhir

    • LessThanLastPeriod: kurang dari nilai metrik dalam siklus pemantauan terakhir

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    GreaterThanOrEqualToThreshold
    Escalations.Info.Times

    integer

    No

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

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    3
    Resources

    string

    Yes

    Informasi tentang resource. Contoh: [{"instanceId":"i-uf6j91r34rnwawoo****"}] atau [{"userId":"100931896542****"}].

    Nilai valid N: 1 hingga 500.

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

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

    integer

    No

    Periode bisu selama notifikasi peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi.

    Unit: detik. Nilai default: 86400.

    Nilai valid N: 1 hingga 500.

    Catatan

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

    86400
    Webhook

    string

    No

    URL panggilan balik tempat permintaan POST dikirim ketika peringatan dipicu berdasarkan aturan peringatan.

    Nilai valid N: 1 hingga 500.

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

    string

    Yes

    Kelompok kontak peringatan. Notifikasi peringatan dikirim ke kontak peringatan dalam kelompok kontak peringatan tersebut.

    Nilai valid N: 1 hingga 500.

    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
    Namespace

    string

    Yes

    Namespace layanan cloud.

    Nilai valid N: 1 hingga 500.

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

    acs_ecs_dashboard
    EmailSubject

    string

    No

    Subjek email notifikasi peringatan.

    Nilai valid N: 1 hingga 500.

    ECS实例报警
    Period

    string

    No

    Periode statistik metrik.

    Unit: detik. Nilai default adalah interval pengumpulan data pemantauan metrik.

    Nilai valid N: 1 hingga 500.

    Catatan

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

    60
    RuleName

    string

    Yes

    Nama aturan peringatan.

    Nilai valid N: 1 hingga 500.

    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 berbasis ambang batas akan dibuat.

    test123
    Escalations.Info.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Info.

    Nilai valid N: 1 hingga 500.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan parameter MetricName dari 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 tersebut.

    Average
    Escalations.Warn.Times

    integer

    No

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

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    3
    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 dalam siklus pemantauan terakhir

    • LessThanLastPeriod: kurang dari nilai metrik dalam siklus pemantauan terakhir

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    GreaterThanOrEqualToThreshold
    Interval

    string

    No

    Interval pemicuan peringatan berdasarkan aturan peringatan.

    Unit: detik.

    Nilai valid N: 1 hingga 500.

    Catatan

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

    60
    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 dalam siklus pemantauan terakhir

    • LessThanLastPeriod: kurang dari nilai metrik dalam siklus pemantauan terakhir

    Nilai valid N: 1 hingga 500.

    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 tersebut.

    GreaterThanOrEqualToThreshold
    Escalations.Warn.Statistics

    string

    No

    Metode statistik untuk peringatan tingkat Warn.

    Nilai valid N: 1 hingga 500.

    Nilai parameter ini ditentukan oleh kolom Statistics yang sesuai dengan parameter MetricName dari 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 tersebut.

    Average
    NoDataPolicy

    string

    No

    Metode penanganan peringatan saat tidak ditemukan data pemantauan. Nilai valid:

    • KEEP_LAST_STATE (default): Tidak dilakukan operasi apa pun.

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

    • OK: Status dianggap normal.

    Nilai valid N: 1 hingga 500.

    KEEP_LAST_STATE
    Labels

    array<object>

    No

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

    object

    No

    Key

    string

    No

    Kunci tag.

    tagKey1
    Value

    string

    No

    Nilai tag.

    Catatan

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

    ECS

    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 kesalahan yang dikembalikan.

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

    string

    ID permintaan.

    15D1440E-BF24-5A41-93E4-36864635179E
    Success

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai valid:

    • true

    • false

    true
    FailedListResult

    object

    Target

    array<object>

    Aturan peringatan yang gagal dibuat untuk resource tersebut.

    array<object>

    RuleId

    string

    ID aturan peringatan.

    a151cd6023eacee2f0978e03863cc1697c89508****
    Result

    object

    Aturan peringatan yang gagal dibuat.

    Code

    string

    Kode respons.

    404
    Message

    string

    Pesan kesalahan yang dikembalikan.

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

    boolean

    Menunjukkan apakah permintaan berhasil. Nilai valid:

    • true

    • false

    false

    Contoh

    Respons sukses

    JSONformat

    {
  "Code": "200",
  "Message": "The request processing has failed due to some unknown error.",
  "RequestId": "15D1440E-BF24-5A41-93E4-36864635179E",
  "Success": true,
  "FailedListResult": {
    "Target": [
      {
        "RuleId": "a151cd6023eacee2f0978e03863cc1697c89508****",
        "Result": {
          "Code": "404",
          "Message": "The request processing has failed due to some unknown error.",
          "Success": false
        }
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 %s %s
    422 %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

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.