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
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
- Header Permintaan
Header Tipe Deskripsi Contoh Authorization String String otorisasi yang berada dalam format AccessKeyID:SignString.- Untuk informasi tentang cara mendapatkan ID AccessKey, lihat Mendapatkan pasangan AccessKey.
- Untuk informasi lebih lanjut tentang cara menandatangani string, lihat Apakah CloudMonitor mendukung algoritma tanda tangan HMAC-SHA1 dan bagaimana cara menggunakannya?
testKey:F86ADF652A6466FCCD860B867D9518D48C24E7F6Content-Length Long Panjang 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.151Content-MD5 String Hash 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.215614AA47799058C009D3E20B19B83AContent-Type String Jenis konten yang dikirim dalam permintaan HTTP. Atur nilainya menjadi application/json.application/jsonDate String Header 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 GMTHost String Nama 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.comx-cms-api-version String Versi API. Atur nilainya menjadi 1.0. 1.0x-cms-signature String Algoritma tanda tangan. CloudMonitor mendukung algoritma tanda tangan HMAC-SHA1. hmac-sha1x-cms-ip String Alamat IP dari host yang melaporkan data pemantauan. 192.168.XX.XXUser-Agent String Deskripsi dari klien. cms-java-sdk-v-1.0 - Parameter Permintaan
Parameter Tipe Diperlukan Deskripsi groupId Long Ya ID grup aplikasi. metricName String Ya Nama metrik. Untuk informasi lebih lanjut, lihat Lampiran 1: Metrik. dimensions Object Ya Dimensi yang menentukan sumber daya yang ingin Anda kueri datanya. Nilainya adalah kumpulan pasangan kunci-nilai. Pasangan tipikal adalah
instanceId:i-abcdefgh12****.time String Ya Timestamp saat metrik dibuat. Nilai valid: - yyyyMMdd'T'HHmmss.SSSZ
Contoh: 20171012T132456.888+0800
- long
Contoh: 1508136760000
type Int Ya 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.
period String Tidak Periode agregasi. Unit: detik.
Jika parameter type diatur ke 1, parameter period diperlukan. Nilai valid:- 60
- 300
values Object Ya Koleksi 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.
- yyyyMMdd'T'HHmmss.SSSZ
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.
}