Gunakan DescribeMetricData untuk mengkueri data monitoring metrik - Cloud Monitor - Alibaba Cloud - Cloud Monitor

Deskripsi operasi

Batasan

Kuota gratis total adalah 1 juta panggilan per bulan untuk operasi DescribeMetricLast, DescribeMetricList, DescribeMetricData, dan DescribeMetricTop. Jika kuota gratis habis dan CloudMonitor Basic (bayar sesuai pemakaian) tidak diaktifkan, operasi API ini tidak dapat lagi dipanggil seperti yang diharapkan. Jika Anda telah mengaktifkan CloudMonitor Basic (bayar sesuai pemakaian), operasi API ini tetap dapat dipanggil meskipun kuota gratis habis. Jika kuota gratis habis, Anda secara otomatis dikenakan biaya untuk penggunaan yang melebihi kuota berdasarkan metode penagihan bayar sesuai pemakaian. Untuk informasi selengkapnya tentang cara mengaktifkan CloudMonitor Basic (bayar sesuai pemakaian), lihat Aktifkan metode penagihan bayar sesuai pemakaian.
Setiap operasi API dapat dipanggil hingga 10 kali per detik. Akun Alibaba Cloud dan pengguna Resource Access Management (RAM) dalam akun tersebut berbagi kuota.

Deskripsi

Catatan

Berbeda dari DescribeMetricList, operasi DescribeMetricData menyediakan fitur statistik. Anda dapat menetapkan parameter Dimension ke {"instanceId": "i-abcdefgh12****"} untuk mengagregasi semua data dari akun Alibaba Cloud Anda.

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

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:QueryMetricData

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Namespace	string	Yes	Namespace dari 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 metrik layanan cloud, lihat Lampiran 1: Metrik.	cpu_idle
Period	string	No	Periode statistik dari metrik. Nilai yang valid: 15, 60, 900, dan 3600. Satuan: detik. Catatan Jika parameter ini tidak ditentukan, data pemantauan dikueri berdasarkan periode di mana nilai metrik dilaporkan. Untuk informasi selengkapnya tentang periode statistik dari metrik yang ditentukan oleh parameter `MetricName`, lihat Lampiran 1: Metrik.	60
StartTime	string	No	Awal dari rentang waktu untuk mengkueri data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan dari periode statistik terakhir akan dikueri.`` Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan dari periode statistik terakhir dalam rentang waktu yang ditentukan akan dikueri.```` Contoh berikut menunjukkan cara menentukan periode di mana data pemantauan 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 dari 15 detik terakhir dalam rentang waktu akan dikueri. Jika Anda menetapkan `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 dari 60 detik terakhir dalam rentang waktu akan dikueri. Jika Anda menetapkan parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 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 dari 3.600 detik terakhir dalam rentang waktu akan dikueri. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak 00:00:00 UTC pada hari Kamis, 1 Januari 1970. Waktu UTC: waktu UTC yang mengikuti format YYYY-MM-DDThh:mm:ssZ. Catatan Anda harus menetapkan parameter `StartTime` ke titik waktu yang lebih baru dari 00:00:00 UTC pada hari Kamis, 1 Januari 1970. Jika tidak, parameter ini tidak valid. Kami merekomendasikan agar Anda menggunakan stempel waktu UNIX untuk mencegah masalah terkait zona waktu.	1618368900000
EndTime	string	No	Akhir dari rentang waktu untuk mengkueri data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan dari periode statistik terakhir akan dikueri.`` Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan dari periode statistik terakhir dalam rentang waktu yang ditentukan akan dikueri.```` Contoh berikut menunjukkan cara menentukan periode di mana data pemantauan 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 dari 15 detik terakhir dalam rentang waktu akan dikueri. Jika Anda menetapkan `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 dari 60 detik terakhir dalam rentang waktu akan dikueri. Jika Anda menetapkan parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 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 dari 3.600 detik terakhir dalam rentang waktu akan dikueri. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak 00:00:00 UTC pada hari Kamis, 1 Januari 1970. Waktu UTC: waktu UTC yang mengikuti format YYYY-MM-DDThh:mm:ssZ. Catatan Kami merekomendasikan agar Anda menggunakan stempel waktu UNIX untuk mencegah masalah terkait zona waktu.	1618368960000
Dimensions	string	No	Dimensi yang menjadi dasar pengkueriian sumber daya. Tetapkan nilainya ke kumpulan pasangan kunci-nilai. Pasangan kunci-nilai yang umum adalah `instanceId:i-2ze2d6j5uhg20x47**`. Catatan** Anda dapat mengkueri maksimum 50 instans dalam satu permintaan.	[{"instanceId": "i-abcdefgh12****"}]
Express	string	No	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.	{"groupby":["userId","instanceId"]}
Length	string	No	Jumlah entri per halaman. Nilai default: 1000. Catatan Nilai maksimum parameter Length dalam suatu permintaan adalah 1440.	1000

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

Elemen respons

Element	Type	Description	Example
	object	Tidak ada.
Code	string	Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.	200
Message	string	Pesan yang dikembalikan.	The specified resource is not found.
RequestId	string	ID permintaan.	6A5F022D-AC7C-460E-94AE-B9E75083D027
Datapoints	string	Data pemantauan. Nilai mencakup bidang-bidang berikut: `timestamp`: waktu ketika peringatan dipicu. `userId`: ID pengguna yang peringatannya dipicu. `instanceId`: ID instans yang peringatannya dipicu. `Minimum`, `Average`, dan `Maximum`: metode agregasi.	[{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]
Period	string	Periode statistik dari data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Satuan: detik.	60

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Datapoints": "[{\\\"timestamp\\\":1618368900000,\\\"Average\\\":95.8291666666667,\\\"Minimum\\\":65.48,\\\"Maximum\\\":100.0},{\\\"timestamp\\\":1618368960000,\\\"Average\\\":95.8683333333333,\\\"Minimum\\\":67.84,\\\"Maximum\\\":100.0}]",
  "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.