Membuat task pemantauan ketersediaan.
Topik ini menjelaskan cara membuat task pemantauan ketersediaan task1 dalam kelompok aplikasi 123456. Parameter TaskType dari task tersebut diatur ke HTTP. Setelah task dijalankan, sistem akan mengirimkan peringatan melalui alamat email dan chatbot DingTalk yang telah ditentukan.
Debugging
Parameter permintaan
| Parameter | Type | Required | Contoh | Deskripsi |
| Action | String | Yes | CreateHostAvailability | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateHostAvailability. |
| GroupId | Long | Yes | 123456 | ID kelompok aplikasi. |
| TaskName | String | Yes | task1 | Nama task pemantauan ketersediaan. Nama harus terdiri dari 4 hingga 100 karakter, dan dapat berisi huruf, angka, serta garis bawah (_). |
| TaskScope | String | No | GROUP | Rentang instans yang dipantau oleh task pemantauan ketersediaan. Nilai yang valid:
|
| TaskType | String | Yes | HTTP | Jenis pemantauan dari task pemantauan ketersediaan. Nilai yang valid:
|
| TaskOption.HttpURI | String | No | https://www.aliyun.com | URI yang ingin Anda pantau. Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi. |
| TaskOption.TelnetOrPingHost | String | No | www.aliyun.com | Nama domain atau alamat IP yang ingin Anda pantau. Catatan Jika parameter TaskType diatur ke PING atau TELNET, parameter ini wajib diisi. |
| TaskOption.HttpResponseCharset | String | No | UTF-8 | Set karakter yang digunakan dalam respons HTTP. Catatan Nilai yang valid: UTF-8. |
| TaskOption.HttpPostContent | String | No | params1=paramsValue1 | Konten permintaan HTTP POST. |
| TaskOption.HttpResponseMatchContent | String | No | ok | Respons terhadap permintaan HTTP. |
| TaskOption.HttpMethod | String | No | GET | Metode permintaan HTTP. Nilai yang valid:
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini wajib diisi. |
| TaskOption.HttpNegative | Boolean | No | true | Metode untuk memicu peringatan. Peringatan dapat dipicu berdasarkan apakah aturan peringatan yang ditentukan termasuk dalam badan respons. Nilai yang valid:
Catatan Jika parameter TaskType diatur ke HTTP, parameter ini berlaku. |
| TaskOption.HttpHeader | String | No | token:testTokenValue | Header permintaan HTTP. Format:
|
| TaskOption.Interval | Integer | No | 60 | Interval pengiriman permintaan deteksi. Satuan: detik. Nilai yang valid: 15, 30, 60, 120, 300, 900, 1800, dan 3600. Catatan Parameter ini hanya tersedia untuk Agen CloudMonitor V3.5.1 atau versi yang lebih baru. |
| AlertConfig.NotifyType | Integer | Yes | 0 | Metode notifikasi peringatan. Nilai yang valid: 0: Notifikasi peringatan dikirim melalui email dan chatbot DingTalk. |
| AlertConfig.StartTime | Integer | No | 0 | Awal periode waktu saat aturan peringatan berlaku. Nilai yang valid: 0 hingga 23. Sebagai contoh, jika parameter Catatan Notifikasi peringatan hanya dikirim berdasarkan ambang batas yang ditentukan jika aturan peringatan sedang berlaku. |
| AlertConfig.EndTime | Integer | No | 22 | Akhir periode waktu saat aturan peringatan berlaku. Nilai yang valid: 0 hingga 23. Sebagai contoh, jika parameter Catatan Notifikasi peringatan hanya dikirim berdasarkan ambang batas yang ditentukan jika aturan peringatan sedang berlaku. |
| AlertConfig.SilenceTime | Integer | No | 86400 | Periode bisu selama notifikasi peringatan baru tidak dikirim meskipun kondisi pemicu terpenuhi. Satuan: detik. Nilai default: 86400. Nilai default ini setara dengan satu hari. |
| AlertConfig.WebHook | String | No | https://www.aliyun.com/webhook.json | URL callback. |
| AlertConfigEscalationList.N.MetricName | String | Yes | HttpStatus | Metrik yang diaktifkan fitur peringatannya. Nilai N yang valid: 1 hingga 21. Nilai yang valid:
|
| AlertConfigEscalationList.N.Value | String | No | 90 | Ambang batas peringatan. Nilai N yang valid: 1 hingga 21. |
| AlertConfigEscalationList.N.Times | Integer | No | 3 | Jumlah kali berturut-turut metrik memenuhi kondisi peringatan sebelum peringatan dipicu. Nilai N yang valid: 1 hingga 21. |
| AlertConfigEscalationList.N.Operator | String | No | > | Operator perbandingan yang digunakan dalam aturan peringatan. Nilai N yang valid: 1 hingga 21. Nilai yang valid:
|
| AlertConfigEscalationList.N.Aggregate | String | No | Value | Metode yang digunakan untuk menghitung nilai metrik yang memicu peringatan. Nilai N yang valid: 1 hingga 21. Nilai yang valid:
Catatan Nilai Value menunjukkan nilai asli dan digunakan untuk metrik seperti kode status. Nilai Average menunjukkan nilai rata-rata dan digunakan untuk metrik seperti latensi dan tingkat kehilangan paket. |
| InstanceList.N | String | No | 2 | Instance ECS yang dipantau. Nilai N yang valid: 1 hingga 21. Catatan Jika parameter TaskScope diatur ke GROUP_SPEC_INSTANCE, parameter ini wajib diisi. |
| AlertConfigTargetList.N.Id | String | No | 1 | ID sumber daya yang memicu peringatan. |
| AlertConfigTargetList.N.Arn | String | No | acs:mns:cn-hangzhou:120886317861****:/queues/test/message | Nama Sumber Daya Alibaba Cloud (ARN) dari sumber daya tersebut. Format:
|
| AlertConfigTargetList.N.Level | String | No | ["INFO", "WARN", "CRITICAL"] | Tingkat peringatan. Nilai yang valid:
|
| AlertConfigTargetList.N.JsonParams | String | No | {"customField1":"value1","customField2":"$.name"} | Parameter callback peringatan. Parameter dalam format JSON. |
Untuk informasi selengkapnya 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 pemanggilan berhasil. |
| Message | String | The specified resource is not found. | Pesan kesalahan. |
| RequestId | String | ACBDBB40-DFB6-4F4C-8957-51FFB233969C | ID permintaan. |
| TaskId | Long | 12345 | ID task pemantauan ketersediaan. |
| Success | Boolean | true | Menunjukkan apakah pemanggilan berhasil. Nilai yang valid:
|
Contoh
Permintaan contoh
http(s)://[Endpoint]/?Action=CreateHostAvailability
&AlertConfig.NotifyType=0
&AlertConfigEscalationList.1.MetricName=HttpStatus
&GroupId=123456
&TaskName=task1
&TaskType=HTTP
&<Common request parameters>
Respons sukses contoh
Format XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateHostAvailabilityResponse>
<TaskId>12345</TaskId>
<RequestId>CDA78493-F10F-485F-98AD-B4C0B40AB225</RequestId>
<Code>200</Code>
<Success>true</Success>
</CreateHostAvailabilityResponse>
Format JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"TaskId" : "12345",
"RequestId" : "CDA78493-F10F-485F-98AD-B4C0B40AB225",
"Code" : 200,
"Success" : true
}
Kode kesalahan
Untuk daftar kode kesalahan, kunjungi API Error Center.