DescribeMetricData - - Alibaba Cloud Documentation Center

Mengkueri data pemantauan suatu metrik untuk layanan cloud tertentu.

Batasan

Setiap operasi API dapat dipanggil hingga 10 kali per detik. Akun Alibaba Cloud dan Pengguna RAM dalam akun tersebut berbagi kuota yang sama.

Perhatian

Durasi penyimpanan data pemantauan setiap layanan cloud bergantung pada parameter Period (periode statistik). Semakin besar nilai parameter Period, semakin luas rentang waktu data pemantauan yang dikueri dan semakin lama durasi penyimpanannya. Hubungan spesifiknya adalah sebagai berikut:

Jika nilai parameter Period kurang dari 60 detik, durasi penyimpanan adalah tujuh hari.
Jika nilai parameter Period adalah 60 detik, durasi penyimpanan adalah 31 hari.
Jika nilai parameter Period adalah 300 detik, durasi penyimpanan adalah 91 hari.

Catatan penggunaan

Catatan Berbeda dengan DescribeMetricList, operasi DescribeMetricData menyediakan fitur statistik. Anda dapat mengatur parameter Dimension menjadi {"instanceId": "i-abcdefgh12****"} untuk mengagregasi seluruh data akun Alibaba Cloud Anda.

Topik ini memberikan contoh cara mengkueri data pemantauan metrik cpu_idle untuk Elastic Compute Service (ECS). Namespace ECS adalah acs_ecs_dashboard.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	DescribeMetricData	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeMetricData.
Namespace	String	Ya	acs_ecs_dashboard	Namespace layanan cloud. Untuk informasi lebih lanjut tentang namespace layanan cloud, lihat Lampiran 1: Metrik.
MetricName	String	Ya	cpu_idle	Metrik yang digunakan untuk memantau layanan cloud. Untuk informasi lebih lanjut tentang metrik layanan cloud, lihat Lampiran 1: Metrik.
Period	String	Tidak	60	Periode statistik data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Unit: detik. Catatan Jika parameter ini tidak ditentukan, data pemantauan dikueri berdasarkan periode pelaporan nilai metrik. Periode statistik bervariasi tergantung pada metrik yang ditentukan oleh `MetricName`. Untuk informasi lebih lanjut, lihat Lampiran 1: Metrik.
StartTime	String	Tidak	1618368900000	Awal rentang waktu untuk mengkueri data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan dikueri. Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan dikueri. Contoh berikut menunjukkan cara menentukan periode data pemantauan yang dikueri: Jika Anda menetapkan parameter `Period` ke 15, rentang waktu yang ditentukan harus kurang dari atau sama dengan 20 menit. Misalnya, jika Anda menetapkan parameter StartTime ke 2021-05-08 08:10:00 dan parameter EndTime ke 2021-05-08 08:30:00, data pemantauan 15 detik terakhir dalam rentang waktu tersebut akan dikueri. Jika Anda menetapkan parameter `Period` ke 60 atau 900, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 jam. Misalnya, jika Anda menetapkan parameter Period ke 60, parameter StartTime ke 2021-05-08 08:00:00, dan parameter EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan dikueri. Jika Anda menetapkan parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan dua hari. Misalnya, jika Anda menetapkan parameter StartTime ke 2021-05-08 08:00:00 dan parameter EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan dikueri. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik sejak 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Anda harus menetapkan parameter `StartTime` ke titik waktu setelah 00:00:00 Kamis, 1 Januari 1970. Jika tidak, parameter ini tidak valid. Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.
EndTime	String	Tidak	1618368960000	Akhir rentang waktu untuk mengkueri data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan dikueri. Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan dikueri. Contoh berikut menunjukkan cara menentukan periode data pemantauan yang dikueri: Jika Anda menetapkan parameter `Period` ke 15, rentang waktu yang ditentukan harus kurang dari atau sama dengan 20 menit. Misalnya, jika Anda menetapkan parameter StartTime ke 2021-05-08 08:10:00 dan parameter EndTime ke 2021-05-08 08:30:00, data pemantauan 15 detik terakhir dalam rentang waktu tersebut akan dikueri. Jika Anda menetapkan parameter `Period` ke 60 atau 900, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 jam. Misalnya, jika Anda menetapkan parameter Period ke 60, parameter StartTime ke 2021-05-08 08:00:00, dan parameter EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan dikueri. Jika Anda menetapkan parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan dua hari. Misalnya, jika Anda menetapkan parameter StartTime ke 2021-05-08 08:00:00 dan parameter EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan dikueri. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik sejak 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.
Dimensions	String	Tidak	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]	Dimensi pemantauan resource yang ditentukan. Tetapkan nilainya ke kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Anda dapat mengkueri maksimal 50 instans dalam satu permintaan.
Express	String	Tidak	{"groupby":["userId","instanceId"]}	Ekspresi yang digunakan untuk menghitung hasil kueri secara real time. Catatan Hanya ekspresi `groupby` yang didukung. Ekspresi ini mirip dengan pernyataan `GROUP BY` yang digunakan dalam database.
Length	String	Tidak	1000	Jumlah entri per halaman. Nilai default: 1000. Catatan Nilai maksimum parameter Length dalam satu permintaan adalah 1440.

Untuk informasi lebih lanjut tentang parameter permintaan umum, lihat Parameter umum.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Code	String	200	Kode status. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.
Message	String	The specified resource is not found.	Pesan kesalahan.
RequestId	String	6A5F022D-AC7C-460E-94AE-B9E75083D027	ID permintaan.
Datapoints	String	[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]	Data pemantauan. Nilainya mencakup bidang-bidang berikut: `timestamp`: stempel waktu saat alert dipicu. `userId`: ID pengguna yang menerima alert. `instanceId`: ID instans yang menerima alert. `Minimum`, `Average`, dan `Maximum`: metode agregasi.
Period	String	60	Periode statistik data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Unit: detik.

Contoh

Permintaan contoh

http(s)://[Endpoint]/?Action=DescribeMetricData
&MetricName=cpu_idle
&Namespace=acs_ecs_dashboard
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeMetricDataResponse>
	<RequestId>7598FEED-3B79-4B4A-AD01-435F34DA8EDC</RequestId>
	<Period>60</Period>	
    <Datapoints>[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]</Datapoints>
	<Code>200</Code>
</DescribeMetricDataResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7598FEED-3B79-4B4A-AD01-435F34DA8EDC",
  "Period" : "60",
  "Datapoints" : "[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]",
  "Code" : "200"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
404	ResourceNotFound	The specified resource is not found.	Resource yang ditentukan tidak ditemukan.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.