Gunakan DescribeMetricLast untuk query data pemantauan terbaru - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Deskripsi operasi

Batasan

Total kuota gratis adalah 1 juta panggilan per bulan untuk operasi DescribeMetricLast, DescribeMetricList, DescribeMetricData, dan DescribeMetricTop. Jika kuota gratis habis dan CloudMonitor Basic (pay-as-you-go) tidak diaktifkan, operasi API ini tidak lagi dapat dipanggil seperti yang diharapkan. Jika Anda telah mengaktifkan CloudMonitor Basic (pay-as-you-go), operasi API ini tetap dapat dipanggil meskipun kuota gratis telah habis. Setelah kuota gratis habis, Anda dikenakan biaya untuk penggunaan berlebih berdasarkan metode penagihan pay-as-you-go. Untuk informasi lebih lanjut tentang cara mengaktifkan CloudMonitor Basic (pay-as-you-go), lihat Aktifkan metode penagihan pay-as-you-go.
Setiap operasi API dapat dipanggil hingga 50 kali per detik. Akun Alibaba Cloud dan pengguna Resource Access Management (RAM) dalam akun tersebut berbagi kuota.

Catatan

Jika Throttling.User atau Request was denied due to user flow control dikembalikan saat Anda memanggil operasi API, maka operasi API tersebut dibatasi. Untuk informasi lebih lanjut tentang cara menangani masalah ini, lihat Bagaimana cara menangani throttling pada API kueri?

Tindakan Pencegahan

Durasi penyimpanan data pemantauan dari setiap layanan cloud terkait dengan parameter Period (periode statistik). Nilai parameter Period yang lebih besar menunjukkan bahwa data pemantauan didistribusikan dalam rentang waktu yang lebih besar dan durasi penyimpanan data pemantauan lebih lama. Daftar berikut menjelaskan hubungan spesifiknya:

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 tentang cara mengkueri 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 instance i-abcdefgh12**** dari akun 123456789876**** dikueri pada interval 60 detik. Nilai maksimum, minimum, dan rata-rata dari 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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

cms:QueryMetricLast

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Namespace dari layanan cloud. Untuk informasi lebih lanjut tentang namespace layanan cloud, lihat Lampiran 1: Metrik.	acs_ecs_dashboard
MetricName	string	Yes	Metrik yang digunakan untuk memantau layanan cloud. Untuk informasi lebih lanjut tentang nama metrik, lihat Lampiran 1: Metrik.	CPUUtilization
Period	string	No	Periode statistik data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Satuan: detik. Catatan Jika parameter ini tidak ditentukan, data pemantauan dikueri berdasarkan periode pelaporan nilai metrik. Periode statistik metrik (`MetricName`) berbeda untuk setiap layanan cloud. Periode statistik metrik ditampilkan pada kolom `MinPeriods` di halaman Metrik untuk setiap layanan cloud. Untuk informasi lebih lanjut, lihat Lampiran 1: Metrik.	60
StartTime	string	No	Awal rentang waktu untuk mengkueri data pemantauan.	2019-01-31 10:00:00
EndTime	string	No	Akhir rentang waktu untuk mengkueri data pemantauan. Untuk data tingkat detik, waktu mulai diperoleh dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan 20 menit sebelum waktu yang ditentukan oleh parameter EndTime. Waktu yang lebih awal dari kedua titik waktu yang dibandingkan digunakan sebagai waktu mulai. Untuk data tingkat menit, waktu mulai diperoleh dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan 2 jam sebelum waktu yang ditentukan oleh parameter EndTime. Waktu yang lebih awal dari kedua titik waktu yang dibandingkan digunakan sebagai waktu mulai. Untuk data tingkat jam, waktu mulai diperoleh dengan membandingkan waktu yang ditentukan oleh parameter StartTime dan dua hari sebelum waktu yang ditentukan oleh parameter EndTime. Waktu yang lebih awal dari kedua titik waktu yang dibandingkan digunakan sebagai waktu mulai.	2019-01-31 10:10:00
Dimensions	string	No	Dimensi pemantauan dari resource yang ditentukan. Atur nilai ke kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Anda dapat mengkueri maksimum 50 instance dalam setiap permintaan.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	Token paginasi. Jika jumlah hasil melebihi jumlah maksimum entri yang diizinkan pada satu halaman, token paginasi akan dikembalikan. Token ini dapat digunakan sebagai parameter input untuk memperoleh 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 maksimum 1.000 entri data pemantauan dapat dikembalikan pada 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 lebih lanjut 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. Satuan: 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.