DescribeHistoryMonitorValues - Tair (Redis® OSS-Compatible)

Deskripsi operasi

Untuk operasi konsol yang sesuai dengan API ini, lihat Pemantauan kinerja.

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

kvstore:DescribeHistoryMonitorValues

get

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

kvstore:ResourceTag
kvstore:ResourceTag
kvstore:ResourceTag
kvstore:ResourceTag

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	r-bp1zxszhcgatnx******
StartTime	string	Yes	Waktu mulai kueri untuk data pemantauan historis. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-11-06T00:00:00Z
EndTime	string	Yes	Waktu akhir kueri untuk data pemantauan historis. Waktu akhir harus lebih lambat daripada waktu mulai. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC). Catatan Anda dapat mengkueri data pemantauan dari bulan terakhir, dan rentang kueri maksimum tidak boleh melebihi 7 hari.	2022-11-06T00:30:00Z
IntervalForHistory	string	Yes	[Deprecated] Parameter ini sudah tidak digunakan lagi dan memiliki nilai tetap `01m`. Sistem secara otomatis menentukan interval kueri berdasarkan waktu mulai dan waktu akhir. Misalnya, jika rentang waktu kueri kurang dari atau sama dengan 10 menit, frekuensi agregasi data adalah 5 detik, dan hasil kueri dikembalikan dengan frekuensi 5 detik. Catatan Hasil kueri diselaraskan dengan frekuensi agregasi data instans. Jika StartTime yang Anda tentukan tidak jatuh pada pengatur waktu agregasi data, pengatur waktu pertama yang dikembalikan oleh sistem adalah pengatur waktu agregasi data terdekat. Misalnya, jika StartTime yang Anda tentukan adalah 2022-01-20T12:01:48Z, pengatur waktu pertama yang dikembalikan oleh sistem adalah 2022-01-20T12:01:45Z. Jika jumlah shard data instans lebih besar dari atau sama dengan 32, frekuensi agregasi data minimum adalah 1 menit.	01m
MonitorKeys	string	No	Data deret waktu pemantauan. Untuk menentukan beberapa data deret waktu pemantauan, pisahkan dengan koma (,). Menggunakan CpuUsage sebagai contoh: Arsitektur kluster atau read/write splitting: Untuk mengkueri penggunaan CPU keseluruhan dari semua node data (DB), tentukan CpuUsage$db. Untuk mengkueri penggunaan CPU dari node tunggal data, tentukan CpuUsage dan setel parameter NodeId ke node DB. Arsitektur Jenis Penyimpanan Standar (primer/sekunder): Tentukan CpuUsage. Untuk data deret waktu pemantauan lainnya dan deskripsi terperinci, lihat Referensi parameter MonitorKeys. Catatan Nilai defaultnya kosong, yang mengembalikan data deret waktu UsedMemory dan quotaMemory. Untuk memastikan efisiensi kueri, saat mengkueri data deret waktu pemantauan untuk node tunggal, tentukan tidak lebih dari 5 data deret waktu pemantauan per permintaan. Saat mengkueri data deret waktu pemantauan teragregasi, tentukan tidak lebih dari 1 data deret waktu pemantauan per permintaan.	CpuUsage
NodeId	string	No	ID node dalam instans. Tentukan parameter ini untuk mengkueri informasi pemantauan dari node tertentu. Catatan Parameter ini hanya tersedia ketika arsitektur instans adalah read/write splitting atau kluster. Panggil operasi DescribeLogicInstanceTopology untuk mengkueri ID node.	r-bp1zxszhcgatnx**-db-0#1679**
NodeRole	string	No	Untuk mengkueri data deret waktu node baca-saja dalam instans arsitektur read/write splitting cloud-native, tentukan NodeId spesifik dan setel parameter ini ke READONLY. Catatan Dalam kasus lain, Anda tidak perlu menentukan parameter ini (atau tentukan MASTER).	READONLY
Type	string	No

Referensi parameter MonitorKeys

Saat memanggil OpenAPI, tentukan parameter di kolom MonitorKeys dalam tabel berikut. Sistem mengembalikan sub-data deret waktu. Instans mendukung data deret waktu pemantauan umum dan data deret waktu pemantauan statistik perintah.

Data deret waktu pemantauan umum

Berikut ini menjelaskan cara menggunakan data deret waktu pemantauan umum. Menggunakan CpuUsage sebagai contoh:

Arsitektur kluster atau read/write splitting:
- Untuk mengkueri penggunaan CPU keseluruhan dari semua node data (DB): Tentukan CpuUsage$db.
- Untuk mengkueri penggunaan CPU keseluruhan dari semua node Proxy: Tentukan CpuUsage$proxy.
- Untuk mengkueri penggunaan CPU dari node tunggal data atau node Proxy: Tentukan CpuUsage dan setel parameter NodeId ke node DB atau node Proxy.
Arsitektur Jenis Penyimpanan Standar (primer/sekunder): Tentukan CpuUsage.

MonitorKeys	Sub-data deret waktu	Unit	Deskripsi	Cakupan yang didukung
CpuUsage	CpuUsage	%	Penggunaan CPU. Rentang nilai: 0 hingga 100. Catatan Jika instans Anda sebelumnya menggunakan atau mengembalikan parameter RedisCpuUsage, Anda masih dapat menggunakan parameter asli tersebut.	DB Agregasi DB Proxy Agregasi Proxy
MemoryUsage	memoryUsage	%	Penggunaan memori.	DB Agregasi DB
quotaMemory	quotaMemory	Byte	Total memori shard saat ini.	DB Agregasi DB
UsedMemory	UsedMemory	Byte	Memori yang digunakan, termasuk data dan cache.	DB Agregasi DB
Tair_PmemUsage	PmemUsage	%	Penggunaan memori persisten, memori persisten yang digunakan, dan total memori persisten, masing-masing. Hanya instans yang dioptimalkan untuk memori persisten yang mendukung data deret waktu ini.	DB Agregasi DB
Tair_Pmem	PmemUsed	Byte
Tair_Pmem	PmemQuota	Byte
Redis_DetailedSpaceUsage	ins_size	MB	Total ruang penyimpanan instans, ruang disk yang digunakan oleh file data (termasuk file AOF dan RDB), dan ruang disk yang digunakan oleh file log (termasuk log operasi), masing-masing. Hanya instans yang dioptimalkan untuk memori dalam mode penyebaran klasik (sebelumnya disk lokal) yang mendukung data deret waktu ini.	DB Agregasi DB
	data_size	MB
	log_size	MB
Redis_Memory_Monitor	used_memory_rss	Byte	Memori fisik yang ditempati oleh proses, yaitu memori yang dialokasikan oleh sistem operasi ke layanan Tair.	DB
	used_memory_lua	Byte	Memori yang digunakan oleh skrip Lua.
	used_memory_startup	Byte	Memori yang dikonsumsi saat Tair dimulai.
	lazyfree_pending_objects	Jumlah	Jumlah kunci yang menunggu reklamasi memori aktual selama operasi lazy free Tair.
	used_memory_overhead	Byte	Overhead memori yang diperlukan oleh Tair untuk mempertahankan mekanisme internal dataset, termasuk buffer output dari semua klien, buffer kueri, dan AOF.
	used_memory_dataset	Byte	Ruang memori yang ditempati oleh data.
CustomerMemoryUsage	CustomerMemoryUsage	%	Penggunaan memori pengguna. Rentang nilai: 0 hingga 100.	DB Agregasi DB
UsedQPS	TotalQps	Jumlah/detik	Jumlah total permintaan per detik, termasuk perintah baca dan tulis.	DB Agregasi DB Proxy Agregasi Proxy
	GetQps	Jumlah/detik	Jumlah permintaan perintah baca dan tulis per detik, masing-masing. Versi kompatibel instans harus Redis 4.0 atau lebih baru.
	PutQps	Jumlah/detik
	OtherOps	Jumlah/detik	Permintaan tanpa atribut baca atau tulis, seperti PING, INFO, SELECT, dan AUTH. Karena Proxy melakukan pemrosesan khusus pada permintaan, jika instans memiliki node Proxy, OtherOps hanya mencakup beberapa permintaan INFO.
ConnectionUsage	connectionUsage	%	Penggunaan koneksi. Metode perhitungan: jumlah koneksi yang digunakan ÷ total jumlah koneksi yang didukung oleh instans. Data deret waktu ini berguna ketika klien terhubung ke instans Tair (arsitektur kluster) melalui alamat koneksi langsung.	DB Agregasi DB
UsedConnection	ConnCount	Jumlah	Jumlah koneksi yang digunakan.	DB Agregasi DB
IntranetIn	InFlow	KB/detik	Laju lalu lintas masuk dan keluar.	DB Agregasi DB Proxy Agregasi Proxy

Elemen respons

Element	Type	Description	Example
	object
MonitorHistory	string	Informasi pemantauan yang dikembalikan dalam format JSON. Untuk informasi lebih lanjut, lihat Deskripsi parameter pemantauan. Catatan Untuk meningkatkan efisiensi transmisi data, hanya data pemantauan non-nol yang dikembalikan. Semua data pemantauan lain yang tidak ditampilkan memiliki nilai default 0.	"{\"2022-11-06T00:00:00Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:05Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:10Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:15Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:20Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:25Z\":{\"memoryUsage\":\"6.67\"}}"
RequestId	string	ID permintaan.	F0997EE8-F4C2-4503-9168-85177ED7****
MonitorLegend	string

Contoh

Respons sukses

JSONformat

{
  "MonitorHistory": "\"{\\\"2022-11-06T00:00:00Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:05Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:10Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:15Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:20Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:25Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"}}\"",
  "RequestId": "F0997EE8-F4C2-4503-9168-85177ED7****",
  "MonitorLegend": ""
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidStartTime.Malformed	The Specified parameter "StartTime" is not valid.
400	InvalidEndTime.Malformed	The Specified parameter "EndTime" is not valid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.