Melaporkan data pemantauan.
Debugging
OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan memanggil operasi ini di OpenAPI Explorer. Layanan tersebut secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.
Parameter permintaan
| Parameter | Type | Required | Contoh | Deskripsi |
| Action | String | Yes | PutCustomMetric | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke PutCustomMetric. |
| MetricList.N.Type | String | Yes | 0 | Jenis data yang dilaporkan. Nilai valid untuk N: 1 hingga 21. Nilai valid:
Catatan Kami menyarankan Anda melaporkan data agregat dalam periode agregasi 60 detik dan 300 detik. Jika tidak, Anda tidak dapat mengkueri data pemantauan dalam rentang waktu lebih dari tujuh hari. |
| MetricList.N.MetricName | String | Yes | cpu_total | Nama metrik. Nilai valid untuk N: 1 hingga 21. Untuk informasi selengkapnya, lihat Lampiran 1: Metrik. |
| MetricList.N.Time | String | No | 1508136760000 | Stempel waktu saat data metrik dihasilkan. Nilai valid untuk N: 1 hingga 21. Stempel waktu dapat dalam salah satu format berikut:
|
| MetricList.N.GroupId | String | Yes | 12345 | ID kelompok aplikasi. Nilai valid untuk N: 1 hingga 21. Catatan Jika metrik tidak termasuk dalam kelompok aplikasi apa pun, masukkan 0. |
| MetricList.N.Values | String | Yes | {"value":10.5} | Kumpulan nilai metrik. Nilai valid untuk N: 1 hingga 21. Catatan Jika parameter MetricList.N.Type diatur ke 0, kunci dalam parameter ini harus diatur ke nilai yang ditentukan. CloudMonitor mengagregasi data mentah dalam setiap periode agregasi untuk menghasilkan beberapa nilai statistik, seperti nilai maksimum, jumlah, dan nilai total. |
| MetricList.N.Dimensions | String | Yes | {"sampleName1":"value1","sampleName2":"value2"} | Dimensi yang menentukan sumber daya yang data pemantauannya ingin Anda kueri. Nilai valid untuk N: 1 hingga 21. Tetapkan nilainya sebagai kumpulan pasangan kunci-nilai. Format: Panjang kunci atau nilai harus antara 1 hingga 64 byte. Karakter berlebih akan dipotong. Kunci atau nilai dapat berisi huruf, angka, titik (.), tanda hubung (-), garis bawah (_), garis miring (/), dan garis miring terbalik (\). Catatan Dimensions harus diformat sebagai string JSON dalam urutan tertentu. |
| MetricList.N.Period | String | No | 60 | Periode agregasi. Nilai valid untuk N: 1 hingga 21. Satuan: detik. Nilai valid: 60 dan 300. Catatan Jika parameter MetricList.N.Type diatur ke 1, parameter MetricList.N.Period wajib diisi. |
Parameter respons
| Parameter | Type | Contoh | Deskripsi |
| Code | String | 200 | Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa panggilan berhasil. |
| Message | String | The request has failed due to a temporary failure of the server. | Pesan kesalahan. |
| RequestId | String | 05B36C2C-5F6E-48D5-8B41-CE36DD7EE8E0 | ID permintaan. |
Contoh
Contoh permintaan
http(s)://[Endpoint]/?Action=PutCustomMetric
&MetricList.1.Dimensions={"sampleName1":"value1","sampleName2":"value2"}
&MetricList.1.GroupId=12345
&MetricList.1.MetricName=cpu_total
&MetricList.1.Type=0
&MetricList.1.Values={"value":10.5}
&<Common request parameters>
Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<PutCustomMetricResponse>
<RequestId>75D115CE-5DA8-4647-9073-8F72BB85B6F7</RequestId>
<Message>success</Message>
<Code>200</Code>
</PutCustomMetricResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "75D115CE-5DA8-4647-9073-8F72BB85B6F7",
"Message" : "success",
"Code" : "200"
}
Kode kesalahan
Untuk daftar kode kesalahan, lihat Service error codes.