全部产品
Search
文档中心

Cloud Monitor:Melaporkan data pemantauan dengan mengirimkan permintaan HTTP

更新时间:Jul 06, 2025

Topik ini menjelaskan cara melaporkan data pemantauan dengan mengirimkan permintaan HTTP.

Titik akhir

Untuk informasi lebih lanjut tentang titik akhir untuk melaporkan peristiwa kustom, lihat Lampiran 3: Titik Akhir untuk Melaporkan Data Pemantauan.

Sintaksis permintaan

Kode berikut menunjukkan sintaksis permintaan HTTP yang digunakan untuk melaporkan data pemantauan.
POST /metric/custom/upload HTTP/1.1 
Authorization:<AuthorizationString>
Content-Length:<Content Length>
Content-MD5:<Content MD5>
Content-Type:application/json
Date:<GMT Date>
Host: metrichub-cms-cn-hangzhou.aliyuncs.com
x-cms-signature:hmac-sha1
x-cms-api-version:1.0
x-cms-ip:192.168.XX.XX
User-Agent:cms-java-sdk-v-1.0
[{"dimensions":{"key":"value"},"groupId":12345,"metricName":"TestMetric","period":60,"time":"20210827T143329.213+0800","type":0,"values":{"value":10}}]

Header dan parameter permintaan

Tabel berikut menjelaskan header dan parameter dalam permintaan HTTP yang digunakan untuk melaporkan data pemantauan.
  • Header Permintaan
    HeaderTipeDeskripsiContoh
    AuthorizationStringString otorisasi yang berada dalam format AccessKeyID:SignString. testKey:F86ADF652A6466FCCD860B867D9518D48C24E7F6
    Content-LengthLongPanjang badan permintaan HTTP yang didefinisikan dalam RFC 2616. Badan permintaan diukur oleh jumlah byte yang dikodekan dalam UTF-8.
    Catatan Header ini hanya diperlukan jika permintaan memiliki badan.
    151
    Content-MD5StringHash MD5 dari badan permintaan HTTP. Hash MD5 adalah string yang terdiri dari huruf besar dan digit.
    Catatan Header ini hanya diperlukan jika permintaan memiliki badan.
    215614AA47799058C009D3E20B19B83A
    Content-TypeStringJenis konten yang dikirim dalam permintaan HTTP. Atur nilainya menjadi application/json. application/json
    DateStringHeader timestamp standar dari permintaan HTTP. Header timestamp ini mengikuti format waktu yang didefinisikan dalam RFC 1123 dan menggunakan standar waktu UTC.

    Contoh: Mon, 3 Jan 2010 08:33:47 UTC.

    Fri, 27 Aug 2021 06:33:55 GMT
    HostStringNama host lengkap dari permintaan HTTP. Header ini tidak termasuk header protokol seperti https://.

    Contoh: metrichub-cms-cn-hangzhou.aliyuncs.com.

    metrichub-cms-cn-hangzhou.aliyuncs.com
    x-cms-api-versionStringVersi API. Atur nilainya menjadi 1.0. 1.0
    x-cms-signatureStringAlgoritma tanda tangan. CloudMonitor mendukung algoritma tanda tangan HMAC-SHA1. hmac-sha1
    x-cms-ipStringAlamat IP dari host yang melaporkan data pemantauan. 192.168.XX.XX
    User-AgentStringDeskripsi dari klien. cms-java-sdk-v-1.0
  • Parameter Permintaan
    ParameterTipeDiperlukanDeskripsi
    groupIdLongYaID grup aplikasi.
    metricNameStringYaNama metrik. Untuk informasi lebih lanjut, lihat Lampiran 1: Metrik.
    dimensionsObjectYaDimensi yang menentukan sumber daya yang ingin Anda kueri datanya.

    Nilainya adalah kumpulan pasangan kunci-nilai. Pasangan tipikal adalah instanceId:i-abcdefgh12****.

    timeStringYaTimestamp saat metrik dibuat. Nilai valid:
    • yyyyMMdd'T'HHmmss.SSSZ

      Contoh: 20171012T132456.888+0800

    • long

      Contoh: 1508136760000

    typeIntYa

    Jenis data yang dilaporkan. Nilai valid: 0 dan 1. Nilai 0 menunjukkan data mentah dan nilai 1 menunjukkan data agregat.

    Kami sarankan Anda melaporkan data agregat dalam periode agregasi 60 detik dan 300 detik. Jika tidak, Anda tidak dapat meminta data pemantauan dalam rentang waktu lebih dari tujuh hari.

    periodStringTidak

    Periode agregasi. Unit: detik.

    Jika parameter type diatur ke 1, parameter period diperlukan. Nilai valid:
    • 60
    • 300
    valuesObjectYaKoleksi nilai metrik.

    Jika parameter type diatur ke 0, kunci dalam parameter ini harus diatur ke nilai tertentu. CloudMonitor mengagregasi data mentah dalam setiap periode agregasi untuk menghasilkan beberapa nilai statistik, seperti nilai maksimum, jumlah, dan total nilai.

Contoh respons

Kode berikut menunjukkan contoh respons terhadap permintaan HTTP yang melaporkan data pemantauan.

{
  "code":"200",// Kode status HTTP 200 menunjukkan bahwa permintaan berhasil.
  "msg":""// Nilai kosong jika data pemantauan dilaporkan.
}