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

Deskripsi operasi

Sebelum Anda memulai

Pemanggilan DescribeMetricLast, DescribeMetricList, DescribeMetricData, dan DescribeMetricTop berbagi kuota gratis gabungan sebesar 1.000.000 panggilan per bulan. Setelah kuota gratis habis, jika Anda belum mengaktifkan metode penagihan pay-as-you-go CloudMonitor Basic, Anda tidak dapat menggunakan API ini secara normal. Jika Anda telah mengaktifkan metode penagihan pay-as-you-go CloudMonitor Basic, API akan terus berfungsi setelah kuota gratis habis, dan penggunaan di luar kuota gratis akan ditagih secara otomatis. Untuk metode mengaktifkan penagihan pay-as-you-go, lihat Mengaktifkan penagihan pay-as-you-go.
Batas laju untuk satu operasi API adalah 50 panggilan per detik. Batas ini dibagi oleh akun Alibaba Cloud dan semua pengguna Resource Access Management (RAM) di bawah akun tersebut.

Catatan

Saat Anda memanggil operasi API, jika tanggapan berisi Throttling.User atau Request was denied due to user flow control, API sedang dibatasi kecepatannya. Untuk metode handle, lihat Bagaimana cara menangani pembatasan kecepatan API kueri.

Catatan

Durasi penyimpanan data pemantauan layanan cloud bergantung pada Period (periode statistik). Nilai Period yang lebih besar menghasilkan data pemantauan yang lebih jarang dan durasi penyimpanan yang lebih lama. Hubungannya adalah sebagai berikut:

Jika Period kurang dari 60 detik, durasi penyimpanan adalah 7 hari.
Jika Period sama dengan 60 detik, durasi penyimpanan adalah 31 hari.
Jika Period lebih besar atau sama dengan 300 detik, durasi penyimpanan adalah 91 hari.

Deskripsi operasi

Topik ini menyediakan contoh tentang cara mengkueri data pemantauan terbaru dari metrik CPUUtilization untuk layanan cloud acs_ecs_dashboard. Tanggapan menunjukkan bahwa untuk instans i-abcdefgh12**** di bawah akun 123456789876****, nilai maksimum adalah 100, nilai minimum adalah 93,1, dan nilai rata-rata adalah 99,52 pada interval 60 detik.

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

*Semua Sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Namespace layanan cloud. Untuk informasi tentang namespace layanan cloud, lihat Metrik pemantauan layanan cloud.	acs_ecs_dashboard.
MetricName	string	Yes	Nama metrik layanan cloud. Untuk informasi tentang nama metrik, lihat Metrik pemantauan layanan cloud.	CPUUtilization.
Period	string	No	Periode statistik data pemantauan. Nilai valid: 15, 60, 900, dan 3600. Unit: detik. Catatan Jika Anda tidak mengatur periode statistik, data pemantauan dikueri berdasarkan periode pelaporan yang ditentukan saat metrik didaftarkan. - Periode statistik bervariasi berdasarkan metrik (`MetricName`) untuk setiap layanan cloud. Untuk informasi lebih lanjut, lihat kolom `Min Periods` pada halaman daftar metrik dari layanan cloud target di Metrik pemantauan layanan cloud.	60
StartTime	string	No	Waktu mulai. Dua format didukung: 1. String stempel waktu UNIX dalam milidetik (ms), yang mewakili jumlah milidetik yang berlalu sejak 1970-01-01 00:00:00 UTC. 2. String waktu dalam format ISO 8601 YYYY-MM-DDThh:mm:ssZ dalam UTC. Catatan Rentang kueri menggunakan mode eksklusif kiri dan inklusif kanan. StartTime tidak boleh sama dengan atau lebih besar dari EndTime, dan interval di antara keduanya harus kurang dari atau sama dengan 31 hari.	2019-01-31 10:00:00
EndTime	string	No	Waktu akhir untuk mengkueri metrik. Sistem secara otomatis membatasi waktu mulai kueri (ukuran jendela kueri) berdasarkan granularitas data: Data tingkat detik: Rentang kueri maksimum adalah 20 menit (waktu mulai = Max(startTime, EndTime - 20menit)). Data tingkat menit: Rentang kueri maksimum adalah 2 jam (waktu mulai = Max(startTime, EndTime - 2jam)). Data tingkat jam: Rentang kueri maksimum adalah 2 hari (waktu mulai = Max(startTime, EndTime - 2hari)). Catatan Jika startTime yang ditentukan lebih awal dari batas, sistem secara otomatis menggunakan batas tersebut sebagai waktu mulai kueri aktual.	2019-01-31 10:10:00
Dimensions	string	No	Dimensi pemantauan dari Sumber daya yang ditentukan. Format: kumpulan pasangan `kunci:nilai`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Maksimum 50 instans dapat dikueri dalam satu permintaan.	[{"instanceId":"i-2ze2d6j5uhg20x47****"}]
NextToken	string	No	Kursor paginasi. Jika hasil kueri yang cocok dengan kondisi filter melebihi ukuran halaman, kursor paginasi dikembalikan. Untuk mengambil halaman data berikutnya, gunakan nilai kursor yang dikembalikan sebagai parameter permintaan hingga tidak ada nilai kursor yang dikembalikan, yang menunjukkan bahwa semua data telah diambil.	15761432850009dd70bb64cff1f0fff6c0b08ffff073be5fb1e785e2b020f7fed9b5e137bd810a6d6cff5ae****
Length	string	No	Jumlah entri per halaman untuk data pemantauan. Parameter ini digunakan untuk kueri berhalaman. Nilai default: 1000, yang menunjukkan 1000 entri data pemantauan per halaman. Catatan Nilai maksimum Length dalam satu permintaan adalah 1440.	1000
Express	string	No	Ekspresi untuk komputasi real-time pada hasil kueri yang ada.	{"groupby":["userId","instanceId"]}

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

Elemen respons

Element	Type	Description	Example
	object
NextToken	string	Kursor paginasi.	xxxxxx.
RequestId	string	ID permintaan.	021472A6-25E3-4094-8D00-BA4B6A5486C3
Success	boolean	Apakah operasi berhasil. Nilai valid: true: Berhasil. false: Gagal.	true.
Datapoints	string	Daftar data pemantauan.	[{"timestamp":1548777660000,"userId":"123456789876**","instanceId":"i-abcdefgh12**","Minimum":93.1,"Average":99.52,"Maximum":100}]
Code	string	Kode status. Catatan Nilai 200 menunjukkan keberhasilan.	200
Message	string	Paket error.	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	Description
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.	Sumber daya %s yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.