All Products
Search
Document Center

:PutCustomMetric

Last Updated:May 27, 2026

Melaporkan data pemantauan.

Catatan Kami menyarankan Anda memanggil operasi PutHybridMonitorMetricData dari Hybrid Cloud Monitoring untuk 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:

  • 0: melaporkan data mentah
  • 1: melaporkan data agregat
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:

  • Stempel waktu UTC dalam format YYYY-MM-DDThh:mm:ssZ. Contoh: 20171012T132456.888+0800.
  • Stempel waktu UNIX bertipe LONG. Contoh: 1508136760000.
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:{"Key":"Value"}.

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.