Gunakan DescribeMetricLast untuk query data pemantauan terbaru - Cloud Monitor

Deskripsi operasi

Batasan

Kuota gratis total mencakup 1 juta panggilan per bulan untuk operasi DescribeMetricLast, DescribeMetricList, DescribeMetricData, dan DescribeMetricTop. Jika kuota gratis telah habis dan CloudMonitor Basic (pay-as-you-go) belum diaktifkan, operasi API ini tidak dapat dipanggil. Namun, jika Anda telah mengaktifkan CloudMonitor Basic (pay-as-you-go), operasi API ini tetap dapat digunakan meskipun kuota gratis telah habis. Penggunaan melebihi kuota akan dikenai biaya berdasarkan metode penagihan bayar sesuai pemakaian. Untuk informasi selengkapnya tentang cara mengaktifkan CloudMonitor Basic (pay-as-you-go), lihat Aktifkan metode penagihan bayar sesuai pemakaian.
Setiap operasi API dapat dipanggil hingga 50 kali per detik. Akun Alibaba Cloud dan pengguna Resource Access Management (RAM) dalam akun tersebut berbagi kuota yang sama.

Catatan

Jika respons Throttling.User atau Request was denied due to user flow control dikembalikan saat memanggil operasi API, berarti permintaan tersebut mengalami pembatasan kecepatan. Untuk informasi selengkapnya tentang penanganannya, lihat Bagaimana cara menangani pembatasan kecepatan pada API kueri?

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 tersebar dan semakin lama durasi penyimpanannya. Hubungan spesifiknya adalah sebagai berikut:

Durasi penyimpanan adalah 7 hari jika nilai parameter Period kurang dari 60 detik.
Durasi penyimpanan adalah 31 hari jika nilai parameter Period adalah 60 detik.
Durasi penyimpanan adalah 91 hari jika nilai parameter Period lebih besar dari atau sama dengan 300 detik.

Deskripsi operasi

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.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Namespace layanan cloud. Untuk informasi selengkapnya tentang namespace layanan cloud, lihat Lampiran 1: Metrik.	acs_ecs_dashboard
MetricName	string	Yes	Metrik yang digunakan untuk memantau layanan cloud. Untuk informasi selengkapnya tentang nama metrik, lihat Lampiran 1: Metrik.	CPUUtilization
Period	string	No	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 metrik (`MetricName`) bervariasi untuk setiap layanan cloud. Periode statistik metrik ditampilkan di kolom `MinPeriods` pada halaman Metrics untuk setiap layanan cloud. Untuk informasi selengkapnya, lihat Lampiran 1: Metrik.	60
StartTime	string	No	Awal rentang waktu untuk menanyakan data pemantauan.	2019-01-31 10:00:00
EndTime	string	No	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.	2019-01-31 10:10:00
Dimensions	string	No	Dimensi pemantauan resource yang ditentukan. Tetapkan nilainya sebagai kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Anda dapat menanyakan maksimal 50 instans dalam satu permintaan.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	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.	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Length	string	No	Jumlah entri per halaman. Nilai default: 1000. Nilai ini menunjukkan bahwa maksimal 1.000 entri data pemantauan dapat dikembalikan dalam setiap halaman. Catatan Nilai maksimum parameter Length untuk setiap permintaan adalah 1440.	1000
Express	string	No	Ekspresi yang digunakan untuk menghitung hasil kueri secara real-time.	{"groupby":["userId","instanceId"]}

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

Elemen respons

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

Contoh

Respons sukses

JSONformat

{
  "NextToken": "xxxxxx",
  "RequestId": "021472A6-25E3-4094-8D00-BA4B6A5486C3",
  "Success": true,
  "Datapoints": "[{\"timestamp\":1548777660000,\"userId\":\"123456789876****\",\"instanceId\":\"i-abcdefgh12****\",\"Minimum\":93.1,\"Average\":99.52,\"Maximum\":100}]",
  "Code": "200",
  "Message": "The specified resource is not found.",
  "Period": "60"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	ParameterInvalid	Illegal parameters.
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.