DescribeMetricLast - - Alibaba Cloud Documentation Center

Mengambil data pemantauan terbaru dari suatu metrik.

Batasan

Setiap operasi API dapat dipanggil hingga 50 kali per detik. Kuota ini dibagi bersama oleh Akun Alibaba Cloud dan Pengguna RAM dalam akun tersebut.

Perhatian

Durasi penyimpanan data pemantauan setiap layanan cloud bergantung pada parameter Period (periode statistik). Nilai parameter Period yang lebih besar menunjukkan bahwa data pemantauan yang diminta mencakup rentang waktu yang lebih luas dan memiliki durasi penyimpanan lebih lama. Hubungan spesifiknya adalah sebagai berikut:

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

Catatan penggunaan

Topik ini memberikan contoh cara mengambil data pemantauan terbaru dari metrik CPUUtilization untuk Elastic Compute Service (ECS). Namespace ECS adalah acs_ecs_dashboard. Hasil yang dikembalikan menunjukkan bahwa data pemantauan untuk instans i-abcdefgh12**** dari akun 123456789876**** diambil dengan interval 60 detik. Nilai maksimum, minimum, dan rata-rata metrik tersebut masing-masing adalah 100, 93,1, dan 99,52.

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	DescribeMetricLast	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeMetricLast.
Namespace	String	Ya	acs_ecs_dashboard	Namespace layanan cloud. Untuk informasi selengkapnya tentang namespace layanan cloud, lihat Lampiran 1: Metrik.
MetricName	String	Ya	CPUUtilization	Metrik yang digunakan untuk memantau layanan cloud. Untuk informasi selengkapnya tentang nama metrik, 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 ditanyakan berdasarkan periode pelaporan nilai metrik. Periode statistik bervariasi tergantung pada metrik yang ditentukan oleh `MetricName`. Untuk informasi selengkapnya, lihat Lampiran 1: Metrik.
StartTime	String	Tidak	2019-01-31 10:00:00	Awal rentang waktu untuk menanyakan data pemantauan.
EndTime	String	Tidak	2019-01-31 10:10:00	Akhir rentang waktu untuk menanyakan data pemantauan. Untuk data tingkat detik, waktu mulai ditentukan dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan waktu 20 menit sebelum waktu yang ditentukan oleh parameter EndTime. Titik waktu yang lebih awal digunakan sebagai waktu mulai. Untuk data tingkat menit, waktu mulai ditentukan dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan waktu 2 jam sebelum waktu yang ditentukan oleh parameter EndTime. Titik waktu yang lebih awal digunakan sebagai waktu mulai. Untuk data tingkat jam, waktu mulai ditentukan dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan waktu dua hari sebelum waktu yang ditentukan oleh parameter EndTime. Titik waktu yang lebih awal digunakan sebagai waktu mulai.
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 menanyakan maksimal 50 instans dalam satu permintaan.
NextToken	String	Tidak	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****	Token paginasi. Jika jumlah hasil melebihi jumlah maksimum entri yang diizinkan dalam satu halaman, token paginasi akan dikembalikan. Token ini dapat digunakan sebagai parameter input untuk mendapatkan halaman hasil berikutnya. Jika semua hasil telah diperoleh, tidak ada token yang dikembalikan.
Length	String	Tidak	1000	Jumlah entri per halaman. Nilai default: 1000. Nilai ini menunjukkan bahwa maksimal 1.000 entri data pemantauan dapat dikembalikan pada setiap halaman. Catatan Nilai maksimum parameter Length dalam satu permintaan adalah 1440.
Express	String	Tidak	{"groupby":["userId","instanceId"]}	Ekspresi yang digunakan untuk menghitung hasil kueri secara real time.

Untuk informasi selengkapnya tentang parameter permintaan umum, lihat Parameter umum.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
NextToken	String	xxxxxx	Token paginasi.
RequestId	String	021472A6-25E3-4094-8D00-BA4B6A5486C3	ID permintaan.
Success	Boolean	true	Menunjukkan apakah permintaan berhasil. Nilai yang valid: true false
Datapoints	String	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]	Data pemantauan.
Code	String	200	Kode status. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.
Message	String	The specified resource is not found.	Pesan kesalahan.
Period	String	60	Interval waktu. Unit: detik.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

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

<QueryMetricListResponse>
	<Period>60</Period>
	<Datapoints>
		<timestamp>1548777660000</timestamp>
		<Maximum>100</Maximum>
		<userId>123456789876****</userId>
		<Minimum>93.1</Minimum>
		<instanceId>i-abcdefgh12****</instanceId>
		<Average>99.52</Average>
	</Datapoints>
	<RequestId>6A5F022D-AC7C-460E-94AE-B9E75083D027</RequestId>
	<Success>true</Success>
	<Code>200</Code>
</QueryMetricListResponse>

JSON format

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

{
  "Period" : "60",
  "Datapoints" : [ {
    "timestamp" : 1548777660000,
    "Maximum" : 100,
    "userId" : "123456789876****",
    "Minimum" : 93.1,
    "instanceId" : "i-abcdefgh12****",
    "Average" : 99.52
  } ],
  "RequestId" : "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Success" : true,
  "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.