DescribeHistoryMonitorValues - Tair (Redis® OSS-Compatible)

Deskripsi operasi

Untuk setara di konsol, 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	Awal rentang waktu untuk dikueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.	2022-11-06T00:00:00Z
EndTime	string	Yes	Akhir rentang waktu untuk dikueri. Waktu akhir harus lebih baru daripada waktu mulai. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Catatan Anda dapat mengkueri data pemantauan dalam satu bulan terakhir. Rentang waktu maksimum untuk kueri adalah 7 hari.	2022-11-06T00:30:00Z
IntervalForHistory	string	Yes	Parameter ini sudah tidak digunakan dan nilainya tetap `01m`. Sistem secara otomatis menentukan interval kueri berdasarkan waktu mulai dan waktu akhir yang ditentukan. Misalnya, jika rentang waktu yang ditentukan adalah 10 menit atau kurang, data diagregasi setiap 5 detik, dan hasil kueri dikembalikan dengan interval 5 detik. Catatan Jika `StartTime` yang ditentukan bukan pada titik agregasi data, titik waktu pertama yang dikembalikan sistem adalah titik agregasi data sebelumnya yang paling dekat. Misalnya, jika Anda menetapkan StartTime ke `2022-01-20T12:01:48Z`, titik waktu pertama yang dikembalikan adalah `2022-01-20T12:01:45Z`. Jika instans memiliki 32 shard data atau lebih, frekuensi agregasi data minimum adalah 1 menit.	01m
MonitorKeys	string	No	Metrik pemantauan yang akan dikueri, seperti `CpuUsage`. Untuk menentukan beberapa metrik, pisahkan dengan koma (,). Untuk instans yang menggunakan arsitektur kluster atau Pemisahan baca/tulis: Untuk mengkueri utilisasi CPU keseluruhan dari semua node data, atur parameter ini menjadi CpuUsage$db. Untuk mengkueri utilisasi CPU dari satu node data, atur parameter ini menjadi CpuUsage dan tentukan node tersebut di parameter `NodeId`. Untuk instans yang menggunakan arsitektur standar (primary/standby), atur parameter ini menjadi CpuUsage. Untuk informasi selengkapnya tentang metrik pemantauan, lihat Informasi tambahan tentang parameter MonitorKeys di bawah ini. Catatan Jika Anda tidak menentukan parameter ini, metrik `UsedMemory` dan `quotaMemory` akan dikembalikan secara default. Untuk memastikan efisiensi kueri, kami menyarankan agar Anda menentukan maksimal 5 metrik pemantauan untuk satu node dan maksimal 1 metrik pemantauan agregat per kueri.	CpuUsage
NodeId	string	No	ID node dalam instans. Anda dapat menggunakan parameter ini untuk mengkueri data pemantauan dari node tertentu. Catatan Parameter ini hanya tersedia untuk instans yang menggunakan arsitektur Pemisahan baca/tulis atau kluster. Anda dapat memanggil operasi DescribeLogicInstanceTopology untuk mengkueri ID node.	r-bp1zxszhcgatnx**-db-0#1679**
NodeRole	string	No	Jika Anda ingin mengkueri metrik dari node read-only dalam instans cloud-native yang menggunakan arsitektur Pemisahan baca/tulis, Anda harus menentukan NodeId dan mengatur parameter ini menjadi READONLY. Catatan Dalam semua kasus lain, Anda tidak perlu menentukan parameter ini. Anda juga dapat mengaturnya menjadi MASTER.	READONLY
Type	string	No

Parameter MonitorKeys

Saat melakukan panggilan API, gunakan parameter dari kolom MonitorKeys pada tabel berikut. API akan mengembalikan sub-metrik yang sesuai. Sebuah instans mendukung metrik tujuan umum dan metrik statistik perintah.

Metrik tujuan umum

Bagian ini menjelaskan cara menggunakan metrik tujuan umum, dengan contoh CpuUsage.

Untuk instans yang menggunakan arsitektur kluster atau Pemisahan baca/tulis:
- Untuk mengkueri utilisasi CPU keseluruhan dari semua node data (DB), gunakan CpuUsage$db.
- Untuk mengkueri utilisasi CPU keseluruhan dari semua node proxy, gunakan CpuUsage$proxy.
- Untuk mengkueri utilisasi CPU dari satu node data atau node proxy, gunakan CpuUsage dan atur parameter NodeId ke ID node data atau proxy tersebut.
Untuk instans yang menggunakan arsitektur standar (primary/standby), gunakan CpuUsage.

MonitorKeys	Sub-metric	Unit	Description	Supported scope
CpuUsage	CpuUsage	%	Utilisasi CPU. Nilai berkisar antara 0 hingga 100. Catatan Jika instans Anda sebelumnya menggunakan parameter `RedisCpuUsage`, Anda dapat terus menggunakannya.	DB DB aggregate Proxy Proxy aggregate
MemoryUsage	memoryUsage	%	Penggunaan memori.	DB DB aggregate
quotaMemory	quotaMemory	Bytes	Total memori shard saat ini.	DB DB aggregate
UsedMemory	UsedMemory	Bytes	Memori yang digunakan, termasuk data dan cache.	DB DB aggregate
Tair_PmemUsage	PmemUsage	%	Metrik ini masing-masing merepresentasikan penggunaan memori persisten, memori persisten yang digunakan, dan total memori persisten. Hanya didukung oleh instans memori persisten.	DB DB aggregate
Tair_Pmem	PmemUsed	Bytes
Tair_Pmem	PmemQuota	Bytes
Redis_DetailedSpaceUsage	ins_size	MB	Metrik ini masing-masing merepresentasikan total disk space yang digunakan oleh instans, disk space yang digunakan oleh file data (termasuk file AOF dan RDB), dan disk space yang digunakan oleh file log (termasuk runtime logs). Hanya didukung oleh instans optimasi memori yang menggunakan mode penyebaran klasik (local disks).	DB DB aggregate
	data_size	MB
	log_size	MB
Redis_Memory_Monitor	used_memory_rss	Bytes	Memori fisik yang dialokasikan sistem operasi ke proses Tair.	DB
	used_memory_lua	Bytes	Jumlah memori yang digunakan oleh skrip Lua.
	used_memory_startup	Bytes	Memori yang dikonsumsi saat Tair dimulai.
	lazyfree_pending_objects	Counts	Jumlah kunci yang menunggu reclaim saat Tair melakukan operasi lazy free.
	used_memory_overhead	Bytes	Overhead memori yang dibutuhkan Tair untuk mempertahankan struktur data internalnya. Ini mencakup output buffers semua client, query buffers, dan AOF.
	used_memory_dataset	Bytes	Ruang memori yang ditempati oleh data.
CustomerMemoryUsage	CustomerMemoryUsage	%	Penggunaan memori pengguna. Nilai berkisar antara 0 hingga 100.	DB DB aggregate
UsedQPS	TotalQps	Counts/s	Jumlah total permintaan per detik, termasuk perintah baca dan tulis.	DB DB aggregate Proxy Proxy aggregate
	GetQps	Counts/s	Jumlah permintaan baca dan tulis per detik, masing-masing. Instans harus kompatibel dengan Redis 4.0 atau versi lebih baru.
	PutQps	Counts/s
	OtherOps	Counts/s	Jumlah permintaan yang tidak memiliki atribut baca atau tulis, seperti `PING`, `INFO`, `SELECT`, dan `AUTH`. Karena node proxy memiliki pemrosesan khusus untuk permintaan, jika instans memiliki node proxy, metrik ini hanya mencakup beberapa permintaan `INFO`.
ConnectionUsage	connectionUsage	%	Penggunaan koneksi dihitung dengan rumus berikut: Koneksi yang terbentuk ÷ Total koneksi yang didukung oleh instans. Metrik ini merupakan referensi yang berguna ketika client terhubung ke instans Tair (arsitektur kluster) menggunakan alamat koneksi langsung.	DB DB aggregate
UsedConnection	ConnCount	Counts	Jumlah koneksi yang digunakan.	DB DB aggregate
IntranetIn	InFlow	KB/s	Laju traffic inbound dan outbound.	DB DB aggregate Proxy Proxy aggregate
IntranetOut	OutFlow	KB/s	Laju traffic inbound dan outbound.	DB DB aggregate Proxy Proxy aggregate
IntranetInRatio	intranetInRatio	%	Persentase penggunaan bandwidth traffic inbound dan outbound.	DB DB aggregate
IntranetOutRatio	intranetOutRatio	%		DB DB aggregate
Redis_Avg_Rt_Monitor	AvgRt	us	Latensi rata-rata, yaitu waktu rata-rata yang dibutuhkan node backend untuk memproses perintah dari penerimaan hingga respons. Untuk node data, metrik ini tidak mencakup latensi node proxy dan load balancing. Untuk node proxy, metrik ini mencakup latensi node data dan node proxy, tetapi tidak mencakup latensi load balancing.	DB DB aggregate Proxy Proxy aggregate
Redis_Max_Rt_Monitor	MaxRt	us	Latensi maksimum, yaitu waktu maksimum yang dibutuhkan node untuk memproses perintah dari penerimaan hingga respons. Untuk node data, metrik ini tidak mencakup latensi node proxy dan load balancing. Untuk node proxy, metrik ini mencakup latensi node data dan node proxy, tetapi tidak mencakup latensi load balancing.	DB DB aggregate Proxy Proxy aggregate
Redis_Basic_Monitor	Keys	Counts	Jumlah total kunci tingkat atas yang disimpan dalam instans.	DB DB aggregate
	Expires	Counts	Jumlah kunci yang memiliki waktu kedaluwarsa yang ditetapkan. Ini adalah nilai instan yang diukur pada saat pengumpulan.
	ExpiredKeys	Counts	Jumlah kumulatif kunci yang kedaluwarsa.
	EvictedKeys	Counts	Jumlah kumulatif kunci yang dievict.
	ExpiredKeysPerSecond	Counts/s	Jumlah kunci yang kedaluwarsa per detik.
	EvictedKeysPerSecond	Counts/s	Jumlah kunci yang dievict per detik.
	inmem_keys	Counts	Metrik ini hanya didukung oleh instans penyimpanan hibrid (telah dihentikan) dan dapat diabaikan.
	swapped_keys	Counts
Hit_Rate_Monitor	hit_rate	%	Persentase pencarian kunci yang berhasil. Rumus: Jumlah hit kunci / (Jumlah hit kunci + Jumlah miss kunci).	DB DB aggregate
	hit	Counts	Jumlah hit kunci per detik.
	miss	Counts	Jumlah miss kunci per detik.
	evicted_keys_per_sec	Counts/s	Jumlah kunci yang dievict per detik.
DiskUsage	disk_usage	%	Metrik ini merepresentasikan penggunaan disk, ukuran input buffer, ukuran output buffer, dan kinerja disk. Hanya didukung oleh instans berbasis disk.	DB
Tair_Connection_Monitor	UsedInputBuffer	Bytes
Tair_Connection_Monitor	UsedOutputBuffer	Bytes
Tair_Disk_Monitor	`io_bandwidth_kbps`, `iops`, `iops_usage`, dan lainnya.	%, ms, Counts, dan lainnya.
UsedConnection	ConnectionUsage	%	Penggunaan koneksi, dihitung sebagai: Koneksi yang digunakan ÷ Koneksi maksimum yang didukung oleh node. Metrik ini merupakan referensi yang berguna ketika client terhubung ke instans Tair (arsitektur kluster atau Pemisahan baca/tulis) melalui node proxy.	Proxy Proxy aggregate
	UsedConnection	Counts	Jumlah koneksi yang digunakan.
	NewUserConnQps	Counts/s	Jumlah koneksi yang dibentuk per detik dari client ke node proxy.
Redis_Package_Monitor	request	Byte	Ukuran rata-rata satu permintaan dalam byte.	Proxy
	response	Byte	Ukuran rata-rata satu respons dalam byte.
	request_max	Byte	Ukuran maksimum satu permintaan dalam byte.
	response_max	Byte	Ukuran maksimum satu respons dalam byte.
RedisProxyConn	RedisUsedConnection	Counts	Jumlah koneksi dari node proxy ke node data.
	NewDBConnQps	Counts/s	Jumlah koneksi yang dibentuk per detik dari node proxy ke node data.
	DisconnectDBConn	Counts	Jumlah kumulatif pemutusan koneksi dari node proxy ke node data.
	DisconnectUserConn	Counts	Jumlah kumulatif pemutusan koneksi dari client ke node proxy.
TotalCalls	TotalRefusedCommands	Counts	Jumlah kumulatif perintah yang ditolak.
	TotalCallsPerSecCalls	Counts/s	Jumlah permintaan per detik.
	TotalCallsPerSecRetryCalls	Counts/s	Jumlah permintaan yang dicoba ulang per detik.
	TotalCallsPerSecRetryFailed	Counts/s	Jumlah permintaan yang gagal per detik.

Metrik statistik perintah

Metrik statistik perintah hanya dapat dikueri untuk node data tertentu. Untuk mengkueri metrik ini, gunakan parameter MonitorKeys yang sesuai dan tentukan node data di parameter NodeId.

Catatan

Kelompok pemantauan perintah ekstensi Tair hanya didukung oleh instans optimasi memori yang menggunakan mode penyebaran klasik (local disks).

MonitorKeys	Sub-metric	Unit	Description
Redis_Keys_Monitor	del, dump, exists, expire, expireat, move, persist, pexpire, pexpireat, pttl, randomkey, rename, renamenx, restore, sort, ttl, type, scan	Counts/s	Jumlah panggilan per detik untuk perintah terkait kunci, seperti DEL dan EXISTS.
Redis_String_Monitor	append, bitcount, bitop, decr, decrby, get, getbit, getrange, getset, incr, incrby, incrbyfloat, mget, mset, msetnx, psetex, set, setbit, setex, setnx, setrange, strlen	Counts/s	Jumlah panggilan per detik untuk perintah terkait String, seperti APPEND dan MGET.
Redis_Hashes_Monitor	hdel, hexists, hget, hgetall, hincrby, hincrbyfloat, hkeys, hlen, hmget, hmset, hset, hsetnx, hvals, hscan	Counts/s	Jumlah panggilan per detik untuk perintah terkait Hash, seperti HGET dan HDEL.
Redis_Lists_Monitor	blpop, brpop, brpoplpush, lindex, linsert, llen, lpop, lpush, lpushx, lrange, lrem, lset, ltrim, rpop, rpoplpush, rpush, rpushx	Counts/s	Jumlah panggilan per detik untuk perintah terkait List, seperti BLPOP dan BRPOP.
Redis_Sets_Monitor	sadd, scard, sdiff, sdiffstore, sinter, sinterstore, sismember, smembers, smove, spop, srandmember, srem, sunion, sunionstore, sscan	Counts/s	Jumlah panggilan per detik untuk perintah terkait Set, seperti SADD dan SCARD.
Redis_Zset_Monitor	zadd, zcard, zcount, zincrby, zrange, zrangebyscore, zrank, zrem, zremrangebyrank, zremrangebyscore, zrevrange, zrevrangebyscore, zrevrank, zscore, zunionstore, zinterstore, zscan, zrangebylex, zlexcount, zremrangebylex, zpopmin, zpopmax, bzpopmin, bzpopmax	Counts/s	Jumlah panggilan per detik untuk perintah terkait Sorted Set, seperti ZADD dan ZCARD.
Redis_Hyperlog_Monitor	pfadd, pfcount, pfmerge	Counts/s	Jumlah panggilan per detik untuk perintah terkait HyperLogLog, seperti PFADD dan PFCOUNT.
Redis_Pub_Sub_Monitor	psubscribe, publish, pubsub, punsubscribe, subscribe, unsubscribe	Counts/s	Jumlah panggilan per detik untuk perintah terkait publish/subscribe, seperti PUBLISH dan SUBSCRIBE.
Redis_Transaction_Monitor	discard, exec, multi, unwatch, watch	Counts/s	Jumlah panggilan per detik untuk perintah terkait transaksi, seperti WATCH dan MULTI.
Redis_Scripting_Monitor	eval, evalsha, script	Counts/s	Jumlah panggilan per detik untuk perintah terkait scripting, seperti EVAL dan EVALSHA.
Calls_Monitor	flushall_calls, flushdb_calls, keys_calls	Counts	Jumlah kumulatif panggilan untuk perintah FLUSHALL, FLUSHDB, dan KEYS.
Redis_Connection_Monitor	auth, echo, ping, quit, select	Counts/s	Jumlah panggilan per detik untuk perintah terkait koneksi, seperti AUTH dan ECHO.
Redis_Server_Monitor	bgsave, client, command, config, dbsize, debug, flushall, flushdb, info, monitor, slowlog, time	Counts/s	Jumlah panggilan per detik untuk perintah terkait server, seperti BGSAVE dan CONFIG.
Redis_Geo_Monitor	geoadd, geohash, geopos, geodist, georadius, georadiusbymember	Counts/s	Jumlah panggilan per detik untuk perintah terkait Geo, seperti GEOADD dan GEOHASH.
Redis_Streams_Monitor	xinfo, xadd, xtrim, xdel, xrange, xrevrange, xlen, xread, xgroup, xreadgroup, xack, xclaim, xpending	Counts/s	Jumlah panggilan per detik untuk perintah terkait Streams, seperti XINFO dan XADD.
Redis_TairDoc_Monitor	jsondel, jsonget, jsonmget, jsonset, jsontype, jsonnumincrby, jsonstrappend, jsonstrlen, jsonarrappend, jsonarrpop, jsonarrinsert, jsonarrlen, jsonarrtrim	Counts/s	Jumlah panggilan per detik untuk perintah terkait Doc, seperti JSON.SET dan JSON.GET.
Redis_TairHash_Monitor	exhset, exhsetnx, exhmset, exhexpireat, exhexpire, exhmsetwithopts, exhpexpireat, exhpexpire, exhpttl, exhttl, exhver, exhsetver, exhincrby, exhincrbyfloat, exhget, exhgetwithver, exhmget, exhdel, exhlen, exhexists, exhkeys, exhvals, exhgetall, exhmgetwithver, exhsterlen, exhscan	Counts/s	Jumlah panggilan per detik untuk perintah terkait exHash, seperti EXHSET dan EXHMSET.
Redis_TairString_Monitor	cas, cad, exset, exget, exsetver, exincrby, exincrbyfloat, excas, excad	Counts/s	Jumlah panggilan per detik untuk perintah terkait exString, seperti EXSET dan EXGET.
Redis_TairGis_Monitor	gisadd, gisget, gisdel, gissearch, giscontains, gisintersects, gisgetall	Counts/s	Jumlah panggilan per detik untuk perintah terkait GIS, seperti GIS.ADD, GIS.GET, dan GIS.DEL.
Redis_TairBloom_Monitor	bfadd, bfmadd, bfexists, bfmexists, bfinsert, bfreserve, bfdebug	Counts/s	Jumlah panggilan per detik untuk perintah terkait Bloom, seperti BF.RESERVE dan BF.ADD.

Elemen respons

Element	Type	Description	Example
	object
MonitorHistory	string	Data pemantauan yang dikembalikan sebagai string berformat JSON. Untuk informasi selengkapnya, lihat Parameter pemantauan. Catatan Untuk meningkatkan efisiensi transfer data, sistem hanya mengembalikan data pemantauan untuk metrik dengan nilai bukan nol. Jika suatu metrik tidak dikembalikan, nilainya adalah 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****

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****"
}

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.