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	Waktu mulai rentang kueri. Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC.	2022-11-06T00:00:00Z
EndTime	string	Yes	Waktu akhir rentang kueri. Waktu ini harus lebih baru daripada waktu mulai. Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC. Catatan Anda dapat mengkueri data dalam rentang satu bulan terakhir. Satu kueri dapat mencakup maksimal 7 hari.	2022-11-06T00:30:00Z
IntervalForHistory	string	Yes	Parameter ini sudah tidak digunakan lagi. Nilainya tetap `01m`. Sistem secara otomatis menentukan interval kueri berdasarkan waktu mulai dan akhir yang ditentukan. Misalnya, jika rentang waktu adalah 10 menit atau kurang, frekuensi agregasi data adalah 5 detik, dan mengembalikan titik data setiap 5 detik. Catatan Timestamp titik data yang dikembalikan disejajarkan dengan frekuensi agregasi data instans. Jika `StartTime` yang ditentukan tidak sejajar dengan timestamp agregasi, sistem menggunakan timestamp terdekat sebelumnya. Misalnya, jika Anda menentukan `StartTime` sebagai `2022-01-20T12:01:48Z`, timestamp titik data 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 yang akan dikueri. Untuk menentukan beberapa metrik, pisahkan dengan koma (,). Sebagai contoh, pertimbangkan metrik `CpuUsage`: Untuk instans kluster atau pemisahan baca/tulis: Untuk mengkueri pemanfaatan CPU keseluruhan semua node data (DB), atur parameter ini menjadi CpuUsage$db. Untuk mengkueri pemanfaatan CPU satu node data, atur parameter ini menjadi CpuUsage dan atur parameter `NodeId` ke ID node data tersebut. Untuk instans primary/standby standar, atur parameter ini menjadi CpuUsage. Untuk informasi lebih lanjut mengenai metrik dan deskripsi lengkapnya, lihat Informasi tambahan mengenai parameter MonitorKeys. Catatan Jika Anda tidak menentukan parameter ini, metrik `UsedMemory` dan `quotaMemory` akan dikembalikan secara default. Untuk kinerja kueri optimal, kami menyarankan Anda menentukan maksimal 5 metrik per permintaan untuk satu node, dan maksimal 1 metrik per permintaan untuk metrik agregasi.	CpuUsage
NodeId	string	No	ID node yang metriknya akan dikueri. Catatan Parameter ini hanya tersedia untuk instans yang menggunakan arsitektur kluster atau pemisahan baca/tulis. Anda dapat memanggil operasi DescribeLogicInstanceTopology untuk mendapatkan ID node.	r-bp1zxszhcgatnx**-db-0#1679**
NodeRole	string	No	Untuk mengkueri metrik pada node read-only dalam instans cloud-native dengan arsitektur pemisahan baca/tulis, Anda harus menentukan NodeId dan mengatur parameter ini menjadi READONLY. Catatan Untuk semua skenario lain, Anda dapat mengabaikan parameter ini atau mengaturnya menjadi MASTER.	READONLY
Type	string	No

Parameter MonitorKeys

Saat memanggil operasi API ini, gunakan parameter dari kolom MonitorKeys pada tabel berikut. Operasi ini mengembalikan item pemantauan sub yang sesuai. Instans mendukung baik item pemantauan statistik umum maupun statistik perintah.

Item pemantauan umum

Bagian berikut menjelaskan cara menggunakan item pemantauan umum, dengan contoh CpuUsage.

Untuk instans dengan arsitektur kluster atau pemisahan baca/tulis:
- Untuk mengkueri penggunaan CPU keseluruhan semua node data (DB), gunakan CpuUsage$db.
- Untuk mengkueri penggunaan CPU keseluruhan semua node proxy, gunakan CpuUsage$proxy.
- Untuk mengkueri penggunaan CPU satu node data atau node proxy, gunakan CpuUsage dan tentukan node target dalam parameter NodeId.
Untuk instans dengan arsitektur standar (primary/standby), gunakan CpuUsage.

MonitorKeys	Sub-monitoring item	Unit	Description	Supported scope
CpuUsage	CpuUsage	%	Penggunaan CPU. Nilai berkisar antara 0 hingga 100. Catatan Jika instans Anda sebelumnya menggunakan atau mengembalikan parameter `RedisCpuUsage`, Anda dapat terus menggunakannya.	DB DB aggregation Proxy Proxy aggregation
MemoryUsage	memoryUsage	%	Penggunaan memori.	DB DB aggregation
quotaMemory	quotaMemory	Bytes	Total memori shard saat ini.	DB DB aggregation
UsedMemory	UsedMemory	Bytes	Jumlah memori yang digunakan, termasuk data dan cache.	DB DB aggregation
Tair_PmemUsage	PmemUsage	%	Penggunaan, jumlah yang digunakan, dan jumlah total memori persisten, masing-masing. Item pemantauan ini hanya didukung oleh instans memori persisten.	DB DB aggregation
Tair_Pmem	PmemUsed	Bytes
Tair_Pmem	PmemQuota	Bytes
Redis_DetailedSpaceUsage	ins_size	MB	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), masing-masing. Item pemantauan ini hanya didukung oleh instans optimasi memori dalam mode penyebaran klasik (local disk).	DB DB aggregation
	data_size	MB
	log_size	MB
Redis_Memory_Monitor	used_memory_rss	Bytes	Memori fisik yang digunakan oleh proses, yaitu memori yang dialokasikan oleh sistem operasi untuk layanan Tair.	DB
	used_memory_lua	Bytes	Jumlah memori yang digunakan oleh skrip Lua.
	used_memory_startup	Bytes	Memori yang dikonsumsi oleh Tair saat startup.
	lazyfree_pending_objects	Counts	Jumlah kunci yang menunggu reclaim oleh proses lazy free Tair.
	used_memory_overhead	Bytes	Overhead memori yang dibutuhkan oleh Tair untuk manajemen data internal. Ini mencakup semua buffer output klien, buffer kueri, dan AOF.
	used_memory_dataset	Bytes	Ruang memori yang digunakan oleh dataset.
UsedQPS	TotalQps	Counts/s	Jumlah total permintaan per detik, termasuk perintah baca dan tulis.	DB DB aggregation Proxy Proxy aggregation
	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	Permintaan yang tidak memiliki atribut baca atau tulis, seperti `PING`, `INFO`, `SELECT`, dan `AUTH`. Jika instans menggunakan node proxy, item pemantauan ini hanya mencakup beberapa permintaan `INFO` karena penanganan khusus oleh node proxy.
ConnectionUsage	connectionUsage	%	Persentase koneksi yang digunakan. Rumus: `Koneksi yang Digunakan / Total Koneksi yang Didukung oleh instans`. Item pemantauan ini relevan ketika klien menggunakan alamat koneksi langsung untuk terhubung ke instans klusterTair.	DB DB aggregation
UsedConnection	ConnCount	Counts	Jumlah koneksi yang digunakan.	DB DB aggregation
IntranetIn	InFlow	KB/s	Laju traffic inbound dan outbound.	DB DB aggregation Proxy Proxy aggregation
IntranetOut	OutFlow	KB/s	Laju traffic inbound dan outbound.	DB DB aggregation Proxy Proxy aggregation
IntranetInRatio	intranetInRatio	%	Tingkat penggunaan traffic inbound dan outbound.	DB DB aggregation
IntranetOutRatio	intranetOutRatio	%	Tingkat penggunaan traffic inbound dan outbound.	DB DB aggregation
Redis_Avg_Rt_Monitor	AvgRt	us	Waktu rata-rata dari saat node backend menerima perintah hingga mengirimkan respons. Untuk node data, item pemantauan ini tidak mencakup latensi dari node proxy atau load balancing. Untuk node proxy, item pemantauan ini mencakup latensi dari node data dan node proxy, tetapi tidak mencakup latensi dari load balancing.	DB DB aggregation Proxy Proxy aggregation
Redis_Max_Rt_Monitor	MaxRt	us	Waktu maksimum dari saat node menerima perintah hingga mengirimkan respons. Untuk node data, item pemantauan ini tidak mencakup latensi dari node proxy atau load balancing. Untuk node proxy, item pemantauan ini mencakup latensi dari node data dan node proxy, tetapi tidak mencakup latensi dari load balancing.	DB DB aggregation Proxy Proxy aggregation
Redis_Basic_Monitor	Keys	Counts	Jumlah total kunci tingkat atas yang disimpan dalam instans.	DB DB aggregation
	Expires	Counts	Jumlah kunci yang memiliki waktu kedaluwarsa yang dikonfigurasi. Nilai ini merupakan snapshot yang diambil saat pengumpulan data.
	ExpiredKeys	Counts	Jumlah kumulatif kunci yang telah kedaluwarsa.
	EvictedKeys	Counts	Jumlah kumulatif kunci yang telah dikeluarkan.
	ExpiredKeysPerSecond	Counts/s	Jumlah kunci yang kedaluwarsa per detik.
	EvictedKeysPerSecond	Counts/s	Jumlah kunci yang dievict per detik.
	inmem_keys	Counts	Item pemantauan ini hanya didukung oleh instans penyimpanan hibrid (yang sudah dihentikan) dan dapat diabaikan.
	swapped_keys	Counts
Hit_Rate_Monitor	hit_rate	%	Tingkat hit kunci. Rumus: `Hit Kunci / (Hit Kunci + Miss Kunci)`.	DB DB aggregation
	hit	Counts	Jumlah hit kunci per detik.
	miss	Counts	Jumlah miss kunci per detik.
	evicted_keys_per_sec	Counts	Jumlah kunci yang dievict per detik.
DiskUsage	disk_usage	%	Item pemantauan penggunaan disk, ukuran buffer input, ukuran buffer output, dan kinerja disk, masing-masing. Item ini hanya didukung oleh instans yang menggunakan penyimpanan disk.	DB
RocksDBConn	Tair_Connection_Monitor	Bytes
RocksDBConn	Tair_Connection_Monitor	Bytes
Tair_Disk_Monitor	io_bandwidth_kbps, iops, iops_usage, etc.	%, ms, Counts, etc.
UsedConnection	ConnectionUsage	%	Persentase koneksi yang digunakan. Rumus: `Koneksi yang Digunakan / Koneksi Maksimum yang Didukung oleh node`. Item pemantauan ini relevan untuk instans kluster atau pemisahan baca/tulisTair ketika klien terhubung melalui node proxy.	Proxy Proxy aggregation
	UsedConnection	Counts	Jumlah koneksi yang digunakan.
	NewUserConnQps	Counts/s	Jumlah koneksi yang dibuat per detik dari klien 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 dibuat 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 klien ke node proxy.
TotalCalls	TotalRefusedCommands	Counts	Jumlah kumulatif perintah yang ditolak.
	TotalCallsPerSecCalls	Counts/s	Jumlah permintaan per detik.
	TotalCallsPerSecRetryCalls	Counts/s	Jumlah retry permintaan per detik.
	TotalCallsPerSecRetryFailed	Counts/s	Jumlah permintaan gagal per detik.

Item pemantauan statistik perintah

Anda hanya dapat mengkueri item pemantauan statistik perintah untuk node data tertentu. Untuk melakukannya, Anda harus menggunakan parameter MonitorKeys yang sesuai dan menentukan node data tersebut dalam parameter NodeId.

Catatan

Grup pemantauan perintah ekstensi Tair hanya didukung oleh instans optimasi memori dalam mode penyebaran klasik (local disk).

MonitorKeys	Sub-monitoring item	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	Item pemantauan untuk perintah terkait kunci, seperti jumlah panggilan per detik untuk perintah 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	Item pemantauan untuk perintah terkait tipe data String, seperti jumlah panggilan per detik untuk perintah seperti APPEND dan MGET.
Redis_Hashes_Monitor	hdel, hexists, hget, hgetall, hincrby, hincrbyfloat, hkeys, hlen, hmget, hmset, hset, hsetnx, hvals, hscan	Counts/s	Item pemantauan untuk perintah terkait tipe data Hash, seperti jumlah panggilan per detik untuk perintah 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	Item pemantauan untuk perintah terkait tipe data List, seperti jumlah panggilan per detik untuk perintah seperti BLPOP dan BRPOP.
Redis_Sets_Monitor	sadd, scard, sdiff, sdiffstore, sinter, sinterstore, sismember, smembers, smove, spop, srandmember, srem, sunion, sunionstore, sscan	Counts/s	Item pemantauan untuk perintah terkait tipe data Set, seperti jumlah panggilan per detik untuk perintah 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	Item pemantauan untuk perintah terkait tipe data Zset (sorted set), seperti jumlah panggilan per detik untuk perintah seperti ZADD dan ZCARD.
Redis_Hyperlog_Monitor	pfadd, pfcount, pfmerge	Counts/s	Item pemantauan untuk perintah terkait tipe data HyperLogLog, seperti jumlah panggilan per detik untuk perintah seperti PFADD dan PFCOUNT.
Redis_Pub_Sub_Monitor	psubscribe, publish, pubsub, punsubscribe, subscribe, unsubscribe	Counts/s	Item pemantauan untuk perintah terkait fitur publish/subscribe (Pub/Sub), seperti jumlah panggilan per detik untuk perintah seperti PUBLISH dan SUBSCRIBE.
Redis_Transaction_Monitor	discard, exec, multi, unwatch, watch	Counts/s	Item pemantauan untuk perintah terkait transaksi, seperti jumlah panggilan per detik untuk perintah seperti WATCH dan MULTI.
Redis_Scripting_Monitor	eval, evalsha, script	Counts/s	Item pemantauan untuk perintah terkait skrip, seperti jumlah panggilan per detik untuk perintah 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	Item pemantauan untuk perintah terkait koneksi, seperti jumlah panggilan per detik untuk perintah seperti AUTH dan ECHO.
Redis_Server_Monitor	bgsave, client, command, config, dbsize, debug, flushall, flushdb, info, monitor, slowlog, time	Counts/s	Item pemantauan untuk perintah terkait server, seperti jumlah panggilan per detik untuk perintah seperti BGSAVE dan CONFIG.
Redis_Geo_Monitor	geoadd, geohash, geopos, geodist, georadius, georadiusbymember	Counts/s	Item pemantauan untuk perintah terkait Geo, seperti jumlah panggilan per detik untuk perintah seperti GEOADD dan GEOHASH.
Redis_Streams_Monitor	xinfo, xadd, xtrim, xdel, xrange, xrevrange, xlen, xread, xgroup, xreadgroup, xack, xclaim, xpending	Counts/s	Item pemantauan untuk perintah terkait Streams, seperti jumlah panggilan per detik untuk perintah seperti XINFO dan XADD.
Redis_TairDoc_Monitor	jsondel, jsonget, jsonmget, jsonset, jsontype, jsonnumincrby, jsonstrappend, jsonstrlen, jsonarrappend, jsonarrpop, jsonarrinsert, jsonarrlen, jsonarrtrim	Counts/s	Grup pemantauan Doc: Item pemantauan untuk perintah terkait Doc, seperti jumlah panggilan per detik untuk perintah seperti jsonset dan jsonget.
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	Grup pemantauan exHash: Item pemantauan untuk perintah terkait exHash, seperti jumlah panggilan per detik untuk perintah seperti EXHSET dan EXHMSET.
Redis_TairString_Monitor	cas, cad, exset, exget, exsetver, exincrby, exincrbyfloat, excas, excad	Counts/s	Grup pemantauan exString: Item pemantauan untuk perintah terkait exString, seperti jumlah panggilan per detik untuk perintah seperti EXSET dan EXGET.
Redis_TairGis_Monitor	gisadd, gisget, gisdel, gissearch, giscontains, gisintersects, gisgetall	Counts/s	Grup pemantauan GIS: Item pemantauan untuk perintah terkait GIS, seperti jumlah panggilan per detik untuk perintah seperti gisadd, gisget, dan gisdel.
Redis_TairBloom_Monitor	bfadd, bfmadd, bfexists, bfmexists, bfinsert, bfreserve, bfdebug	Counts/s	Grup pemantauan Bloom: Item pemantauan untuk perintah terkait Bloom, seperti jumlah panggilan per detik untuk perintah seperti bfreserve dan bfadd.

Elemen respons

Element	Type	Description	Example
	object
MonitorHistory	string	Informasi pemantauan dalam format JSON. Untuk informasi selengkapnya, lihat Deskripsi parameter pemantauan. Catatan Untuk meningkatkan efisiensi transfer data, operasi ini hanya mengembalikan data pemantauan yang tidak nol. Titik data yang tidak termasuk dalam respons diasumsikan bernilai 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.