DescribeMetricData - Cloud Monitor

Deskripsi operasi

Batasan

Kuota gratis total mencapai 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 secara otomatis 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 10 kali per detik. Akun Alibaba Cloud dan pengguna Resource Access Management (RAM) dalam akun tersebut berbagi kuota yang sama.

Deskripsi

Catatan

Berbeda dengan DescribeMetricList, operasi DescribeMetricData menyediakan fitur statistik. Anda dapat mengatur parameter Dimension menjadi {"instanceId": "i-abcdefgh12****"} untuk mengagregasi seluruh data akun Alibaba Cloud Anda.

Topik ini memberikan contoh cara mengambil data pemantauan metrik cpu_idle untuk Elastic Compute Service (ECS). Namespace 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

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 metrik layanan cloud, lihat Lampiran 1: Metrik.	cpu_idle
Period	string	No	Periode statistik metrik. Nilai yang valid: 15, 60, 900, dan 3600. Unit: detik. Catatan Jika parameter ini tidak ditentukan, data pemantauan diambil berdasarkan periode pelaporan nilai metrik. Untuk informasi selengkapnya tentang periode statistik metrik yang ditentukan oleh parameter `MetricName`, lihat Lampiran 1: Metrik.	60
StartTime	string	No	Awal rentang waktu untuk menanyakan data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan diambil. Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan diambil. Contoh berikut menunjukkan cara menentukan periode data pemantauan yang diambil: Jika Anda mengatur parameter `Period` ke 15, rentang waktu yang ditentukan harus kurang dari atau sama dengan 20 menit. Misalnya, jika Anda mengatur parameter StartTime ke 2021-05-08 08:10:00 dan parameter EndTime ke 2021-05-08 08:30:00, data pemantauan 15 detik terakhir dalam rentang waktu tersebut akan diambil. Jika Anda mengatur `Period` ke 60 atau 900, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 jam. Misalnya, jika Anda mengatur parameter Period ke 60, StartTime ke 2021-05-08 08:00:00, dan EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan diambil. Jika Anda mengatur parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 hari. Misalnya, jika Anda mengatur StartTime ke 2021-05-08 08:00:00 dan EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan diambil. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak pukul 00:00:00 UTC pada Kamis, 1 Januari 1970. Waktu UTC: waktu UTC dalam format YYYY-MM-DDThh:mm:ssZ. Catatan Anda harus mengatur parameter `StartTime` ke titik waktu setelah pukul 00:00:00 UTC pada Kamis, 1 Januari 1970. Jika tidak, parameter ini tidak valid. Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.	1618368900000
EndTime	string	No	Akhir rentang waktu untuk menanyakan data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan diambil. Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan diambil. Contoh berikut menunjukkan cara menentukan periode data pemantauan yang diambil: Jika Anda mengatur parameter `Period` ke 15, rentang waktu yang ditentukan harus kurang dari atau sama dengan 20 menit. Misalnya, jika Anda mengatur parameter StartTime ke 2021-05-08 08:10:00 dan parameter EndTime ke 2021-05-08 08:30:00, data pemantauan 15 detik terakhir dalam rentang waktu tersebut akan diambil. Jika Anda mengatur `Period` ke 60 atau 900, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 jam. Misalnya, jika Anda mengatur parameter Period ke 60, StartTime ke 2021-05-08 08:00:00, dan EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan diambil. Jika Anda mengatur parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan 2 hari. Misalnya, jika Anda mengatur StartTime ke 2021-05-08 08:00:00 dan EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan diambil. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak pukul 00:00:00 UTC pada Kamis, 1 Januari 1970. Waktu UTC: waktu UTC dalam format YYYY-MM-DDThh:mm:ssZ. Catatan Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.	1618368960000
Dimensions	string	No	Dimensi berdasarkan sumber daya yang ditanyakan. Atur nilainya sebagai kumpulan pasangan kunci-nilai. Contoh pasangan kunci-nilai khas adalah `instanceId:i-2ze2d6j5uhg20x47**`. Catatan** Anda dapat menanyakan maksimal 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 satu 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. Nilainya mencakup bidang-bidang berikut: `timestamp`: waktu saat pemicu alert diaktifkan. `userId`: ID pengguna tempat alert diaktifkan. `instanceId`: ID instans tempat alert diaktifkan. `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 data pemantauan. Nilai yang valid: 15, 60, 900, dan 3600. Unit: 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.