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

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 Period lebih besar dari atau sama dengan 300 detik.

Deskripsi operasi

Topik ini memberikan contoh cara mengambil data pemantauan metrik cpu_idle dalam 60 detik terakhir untuk Elastic Compute Service (ECS). Namespace ECS adalah acs_ecs_dashboard. Data pemantauan diurutkan secara menurun berdasarkan bidang Average.

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
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 bervariasi tergantung pada metrik yang ditentukan oleh `MetricName`. Untuk informasi selengkapnya, lihat Lampiran 1: Metrik.	60
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.	cpu_idle
StartTime	string	No	Awal rentang waktu untuk menanyakan data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan ditanyakan.`` Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan ditanyakan.```` 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 ditanyakan. Jika Anda mengatur parameter `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, parameter StartTime ke 2021-05-08 08:00:00, dan parameter EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan ditanyakan. Jika Anda mengatur parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan dua hari. Misalnya, jika Anda mengatur parameter StartTime ke 2021-05-08 08:00:00 dan parameter EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan ditanyakan. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak pukul 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Anda harus mengatur parameter `StartTime` ke titik waktu setelah pukul 00:00:00 Kamis, 1 Januari 1970. Jika tidak, parameter ini tidak valid. Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.	2021-05-08 08:00:00
EndTime	string	No	Akhir rentang waktu untuk menanyakan data pemantauan. Jika parameter `StartTime` dan `EndTime` tidak ditentukan, data pemantauan periode statistik terakhir akan ditanyakan.`` Jika parameter `StartTime` dan `EndTime` ditentukan, data pemantauan periode statistik terakhir dalam rentang waktu yang ditentukan akan ditanyakan.```` 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 ditanyakan. Jika Anda mengatur parameter `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, parameter StartTime ke 2021-05-08 08:00:00, dan parameter EndTime ke 2021-05-08 10:00:00, data pemantauan 60 detik terakhir dalam rentang waktu tersebut akan ditanyakan. Jika Anda mengatur parameter `Period` ke 3600, rentang waktu yang ditentukan harus kurang dari atau sama dengan dua hari. Misalnya, jika Anda mengatur parameter StartTime ke 2021-05-08 08:00:00 dan parameter EndTime ke 2021-05-10 08:00:00, data pemantauan 3.600 detik terakhir dalam rentang waktu tersebut akan ditanyakan. Format berikut didukung: Stempel waktu UNIX: jumlah milidetik yang telah berlalu sejak pukul 00:00:00 Kamis, 1 Januari 1970 Format waktu: YYYY-MM-DDThh:mm:ssZ Catatan Kami menyarankan Anda menggunakan stempel waktu UNIX untuk menghindari masalah terkait zona waktu.	2021-05-08 10:00:00
Dimensions	string	No	Dimensi pemantauan resource yang ditentukan. Atur nilainya menjadi kumpulan pasangan `key:value`. Contoh: `{"userId":"120886317861**"}` atau `{"instanceId":"i-2ze2d6j5uhg20x47"}`. Catatan** Anda dapat menanyakan maksimal 50 instans dalam setiap permintaan.	[{"instanceId": "i-2ze2d6j5uhg20x47****"}]
Orderby	string	Yes	Bidang yang digunakan sebagai dasar pengurutan data. Nilai yang valid: Average Minimum Maximum	Average
OrderDesc	string	No	Urutan pengurutan data. Nilai yang valid: True: mengurutkan data secara menaik. False (default): mengurutkan data secara menurun.	false
Length	string	No	Jumlah entri per halaman. Nilai default: 10. Catatan Nilai maksimum parameter Length dalam satu permintaan adalah 1440.	10
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"]}

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

Elemen respons

Element	Type	Description	Example
	object
Code	string	Kode status HTTP. Catatan Kode status 200 menunjukkan bahwa permintaan berhasil.	200
Message	string	Pesan error.	The specified resource is not found.
RequestId	string	ID permintaan.	3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42
Datapoints	string	Data pemantauan.	[{\"order\":1,\"timestamp\":1620287520000,\"userId\":\"120886317861**\",\"instanceId\":\"i-j6ccf7d5fn335qpo\",\"Average\":99.92,\"Minimum\":99.5,\"Maximum\":100.0,\"_count\":1.0},{\"order\":2,\"timestamp\":1620287520000,\"userId\":\"120886317861\",\"instanceId\":\"i-0xii2bvf42iqvxbp**\",\"Average\":99.91,\"Minimum\":99.0,\"Maximum\":100.0,\"_count\":1.0}]
Period	string	Periode statistik data pemantauan. Unit: detik. Nilai yang valid: 15, 60, 900, dan 3600.	60

Contoh

Respons sukses

JSONformat

{
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42",
  "Datapoints": "[{\\\"order\\\":1,\\\"timestamp\\\":1620287520000,\\\"userId\\\":\\\"120886317861****\\\",\\\"instanceId\\\":\\\"i-j6ccf7d5fn335qpo****\\\",\\\"Average\\\":99.92,\\\"Minimum\\\":99.5,\\\"Maximum\\\":100.0,\\\"_count\\\":1.0},{\\\"order\\\":2,\\\"timestamp\\\":1620287520000,\\\"userId\\\":\\\"120886317861****\\\",\\\"instanceId\\\":\\\"i-0xii2bvf42iqvxbp****\\\",\\\"Average\\\":99.91,\\\"Minimum\\\":99.0,\\\"Maximum\\\":100.0,\\\"_count\\\":1.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.