This topic describes a variety of performance metrics that are supported by ApsaraDB for Redis. When you call the DescribeHistoryMonitorValues operation, you must pass one or more metrics described in the following tables to the MonitorKeys parameter to collect the relevant monitoring data.

Associated API operations

DescribeHistoryMonitorValues: queries the performance monitoring data of an ApsaraDB for Redis instance.

Note When you call this operation, you can pass the metrics listed in the MonitorKeys column of the following tables to the MonitorKeys request parameter based on your business requirements. Only single-node monitoring metrics are supported by ApsaraDB for Redis standard instances. For more information about single-node monitoring metrics, see the Metrics for a single data node section of this topic.

Metrics for a single data node

MonitorKeys Subordinate metric Unit Description
Calls_Monitor flushall_calls Counts The total number of times the FLUSHALL command is run.
flushdb_calls Counts The total number of times that the FLUSHDB command is run.
keys_calls Counts The total number of times that the KEYS command is run.
ConnectionUsage connectionUsage % The connection usage, which is calculated by using the following formula: Connection usage = Number of connections/Total number of connections supported by the data node.
CpuUsage CpuUsage %
The CPU utilization. Valid values: 0% to 100%. The metric varies based on the instance series. This is because different instance series use engines that come with different threading models.
  • Tair persistent memory-optimized instances and DRAM-based instances that are compatible with Redis 6.0: RedisCpuUsage
  • Community Edition instances and other Tair instances: CpuUsage
RedisCpuUsage %
FailedCount FailedCount Counts The number of failed commands.
Hit_Rate_Monitor hit_rate % The key hit rate, which is calculated by using the following formula: Hit rate = Total key hits/(Total key hits + Total key misses).
Note The metric is not displayed if you use instances that run Redis 2.8. In this case, if you need this metric, you must update the minor version of the instance. For more information about how to update the minor version, see Update the minor version.
hit Counts/s The number of key hits per second.
miss Counts/s The number of key misses per second.
evicted_keys_per_sec Counts/s The number of keys that are evicted per second.
IntranetIn InFlow KBps The inbound traffic rate.
IntranetInRatio intranetInRatio % The inbound bandwidth usage.
IntranetOut OutFlow KBps The outbound traffic rate.
IntranetOutRatio intranetOutRatio % The outbound bandwidth usage.
MemoryUsage memoryUsage % The memory usage.
Note The metric is not displayed if you use instances that run Redis 2.8. In this case, if you need this metric, you must upgrade the engine version of the instance. For more information about how to upgrade the engine version, see Upgrade the major version.
QPSUsage qpsUsage % The queries per second (QPS) usage.
Redis_Avg_Rt_Monitor AvgRt us The average latency for commands, which indicates the average time period from the time when the data node receives a command to the time when the node returns the command output.
Redis_Basic_Monitor Keys Counts The total number of keys, which indicates the number of primary keys stored in the data node.
Expires Counts The total number of key-value pairs that have an expiration time configured.
Note The metric collects the total number of keys at the point in time when data is collected. The metric collects an instantaneous value.
ExpiredKeys Counts The total number of expired keys.
EvictedKeys Counts The total number of evicted keys.
inmem_keys Counts The number of key-value pairs stored in memory.
Note The metric is supported only by hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about hybrid storage instances, see Hybrid-storage instances (phased out).
swapped_keys Counts The number of key-value pairs stored in disks.
Note The metric is supported only by hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about hybrid storage instances, see Hybrid-storage instances (phased out).
ExpiredKeysPerSecond Counts/s The number of keys that are expired per second.
EvictedKeysPerSecond Counts/s The number of keys that are evicted per second.
Redis_Connection_Monitor auth, echo, ping, quit, and select Counts/s The number of times per second each command in the Connection command group such as AUTH and ECHO is run.
Redis_DetailedSpaceUsage ins_size MB The total amount of disk space that is occupied by the data node, which includes the data_size and log_size parameters.
data_size MB The amount of disk space that is occupied by data files, which includes append-only files (AOF) and Redis Database (RDB) files.
log_size MB The amount of disk space that is occupied by log files, which includes the operational logs of the data node.
Redis_Geo_Monitor geoadd, geohash, geopos, geodist, georadius, and georadiusbymember Counts/s The number of times per second each command in the Geo command group such as GEOADD and GEOHASH is run.
Redis_Hashes_Monitor hdel, hexists, hget, hgetall, hincrby, hincrbyfloat, hkeys, hlen, hmget, hmset, hset, hsetnx, hvals, and hscan Counts/s The number of times per second each command in the Hash command group such as HGET and HDEL is run.
Redis_Hyperlog_Monitor pfadd, pfcount, and pfmerge Counts/s The number of times per second each command in the HyperLogLog command group such as PFADD and PFCOUNT is run.
Redis_Keys_Monitor del, dump, exists, expire, expireat, move, persist, pexpire, pexpireat, pttl, randomkey, rename, renamenx, restore, sort, ttl, type, and scan Counts/s The number of times per second each command in the Keys command group such as DEL and EXITS is run.
Redis_Lists_Monitor blpop, brpop, brpoplpush, lindex, linsert, llen, lpop, lpush, lpushx, lrange, lrem, lset, ltrim, rpop, rpoplpush, rpush, and rpushx Counts/s The number of times per second each command in the Lists command group such as BLPOP and BRPOP is run.
Redis_Max_Rt_Monitor MaxRt us The highest latency for commands, which indicates the maximum time period from the time when the data node receives a command to the time when the node returns the command output.
Redis_Memory_Monitor used_memory_rss Bytes The amount of physical memory occupied by the process, which indicates the amount of memory allocated by the operating system to the ApsaraDB for Redis service.
used_memory_overhead Bytes The memory usage that is required to support the internal mechanism of ApsaraDB for Redis for maintaining data sets. This includes the output buffers, query buffers, and AOF files for all clients.
used_memory_startup Bytes The amount of memory consumed by ApsaraDB for Redis at startup.
used_memory_dataset Bytes The amount of memory occupied by the data.
lazyfree_pending_objects Counts The number of pending keys to be collected when ApsaraDB for Redis performs the lazy free operation.
used_memory_lua Bytes The amount of memory occupied by Lua scripts.
Redis_Pub_Sub_Monitor psubscribe, publish, pubsub, punsubscribe, subscribe, and unsubscribe Counts/s The number of times per second each command in the Pub/Sub command group such as PUBLISH and SUBSCRIBE is run.
Redis_Scripting_Monitor eval, evalsha, and script Counts/s The number of times per second each command in the Scripting command group such as EVAL and EVALSHA is run.
Redis_Server_Monitor bgsave, client, command, config, dbsize, debug, flushall, flushdb, info, monitor, slowlog, and time Counts/s The number of times per second each command in the Server command group such as BGSAVE and CONFIG is run.
Redis_Sets_Monitor sadd, scard, sdiff, sdiffstore, sinter, sinterstore, sismember, smembers, smove, spop, srandmember, srem, sunion, sunionstore, and sscan Counts/s The number of times per second each command in the Sets command group such as SADD and SCARD is run.
Redis_Streams_Monitor xinfo, xadd, xtrim, xdel, xrange, xrevrange, xlen, xread, xgroup, xreadgroup, xack, xclaim, and xpending Counts/s The number of times per second each command in the Streams command group such as XINFO and XADD is run.
Redis_String_Monitor append, bitcount, bitop, decr, decrby, get, getbit, getrange, getset, incr, incrby, incrbyfloat, mget, mset, msetnx, psetex, set, setbit, setex, setnx, setrange, and strlen Counts/s The number of times per second each command in the String command group such as APPEND and MGET is run.
Redis_Transaction_Monitor discard, exec, multi, unwatch, and watch Counts/s The number of times per second each command in the Transaction command group such as WATCH, MULTI, and EXEC is run.
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, and bzpopmax Counts/s The number of times per second each command in the ZSET command group such as ZADD and ZCARD is run.
UsedConnection ConnCount Counts The number of used connections, which indicates the number of Transmission Control Protocol (TCP) connections to the data node.
Note
  • The metric is valid if clients are connected to an ApsaraDB for Redis cluster instance by using a private endpoint. For more information about private endpoints, see Enable the direct connection mode.
  • The metric is invalid when clients are connected to a cluster instance or read/write splitting instance through a proxy node. In this case, you must pay attention to the number of connections on the proxy node.
UsedMemory UsedMemory Bytes The amount of used memory, which indicates the amount of memory consumed by data and cache.
quotaMemory quotaMemory Bytes The total size of memory.
UsedQPS TotalQps Counts/s The total number of requests per second, which includes read and write requests.
GetQps Counts/s The number of read requests per second.
Note The metric is displayed when you use instances that run Redis 4.0 or later and the latest minor version. For more information, see Upgrade the major version and Update the minor version.
PutQps Counts/s The number of write requests per second.
Note The metric is displayed when you use instances that run Redis 4.0 or later and the latest minor version. For more information, see Upgrade the major version and Update the minor version.
Redis_TairBloom_Monitor bfadd, bfmadd, bfexists, bfmexists, bfinsert, bfreserve, and bfdebug Counts/s The number of times per second each command in the TairBloom command group such as BF.RESERVE and BF.ADD is run. For more information about TairBloom, see TairBloom commands.
Note The metric is supported only for performance-enhanced instances and hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about performance-enhanced instances and hybrid storage instances, see DRAM-based instances and Hybrid-storage instances (phased out).
Redis_TairDoc_Monitor jsondel, jsonget, jsonmget, jsonset, jsontype, jsonnumincrby, jsonstrappend, jsonstrlen, jsonarrappend, jsonarrpop, jsonarrinsert, jsonarrlen, and jsonarrtrim Counts/s The number of times per second each command in the TairDoc command group such as JSON.SET and JSON.GET is run. For more information about TairDoc, see TairDoc commands.
Note The metric is supported only for performance-enhanced instances and hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about performance-enhanced instances and hybrid storage instances, see DRAM-based instances and Hybrid-storage instances (phased out).
Redis_TairGis_Monitor gisadd, gisget, gisdel, gissearch, giscontains, gisintersects, and gisgetall Counts/s The number of times per second each command in the TairGiS command group such as GIS.ADD, GIS.GET, and GIS.DEL is run. For more information about TairGiS, see TairGIS commands.
Note The metric is supported only for performance-enhanced instances and hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about performance-enhanced instances and hybrid storage instances, see DRAM-based instances and Hybrid-storage instances (phased out).
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, and exhscan Counts/s The number of times per second each command in the TairHash command group such as EXHSET and EXHMSET is run. For more information about TairHash, see TairHash commands.
Note The metric is supported only for performance-enhanced instances and hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about performance-enhanced instances and hybrid storage instances, see DRAM-based instances and Hybrid-storage instances (phased out).
Redis_TairString_Monitor cas, cad, exset, exget, exsetver, exincrby, exincrbyfloat, excas, and excad Counts/s The number of times per second each command in the TairString command group such as EXSET and EXGET is run. For more information about TairString, see TairString commands.
Note The metric is supported only for performance-enhanced instances and hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about performance-enhanced instances and hybrid storage instances, see DRAM-based instances and Hybrid-storage instances (phased out).

Metrics for a single proxy node

MonitorKeys Subordinate metric Unit Description
CpuUsage CpuUsage %
The CPU utilization. Valid values: 0% to 100%. The metric varies based on the instance series. This is because different instance series use engines that come with different threading models.
  • Tair persistent memory-optimized instances and DRAM-based instances that are compatible with Redis 6.0: RedisCpuUsage
  • Community Edition instances and other Tair instances: CpuUsage
RedisCpuUsage %
IntranetIn IntranetIn KBps The inbound traffic rate.
Redis_Package_Monitor request Bytes The average size of a request in bytes.
response Bytes The average size of a response in bytes.
request_max Bytes The maximum size of a request in bytes.
response_max Bytes The maximum size of a response in bytes.
UsedQPS TotalQps Counts/s The total number of requests per second, which includes read and write requests.
GetQps Counts/s The number of read requests per second.
Note The metric is displayed only if you use instances that run the latest minor version. For more information about how to update the minor version, see Update the minor version.
PutQps Counts/s The number of write requests per second.
Note The metric is displayed only if you use instances that run the latest minor version. For more information about how to update the minor version, see Update the minor version.
IntranetOut IntranetOut KBps The outbound traffic rate.
Redis_Max_Rt_Monitor MaxRt us The highest latency for commands, which indicates the maximum time period from the time when the proxy node receives a command to the time when the node returns the command output to clients.
Redis_Avg_Rt_Monitor AvgRt us The average latency for commands, which indicates the average time period from the time when the proxy node receives a command to the time when the node returns the command output to clients.
TotalCalls TotalRefusedCommands Counts The cumulative number of rejected commands.
TotalCallsPerSecCalls Counts/s The QPS.
TotalCallsPerSecRetryCalls Counts/s The number of request retries per second.
TotalCallsPerSecRetryFailed Counts/s The number of failed requests per second.
RedisProxyConn RedisUsedConnection Counts The number of connections established from the proxy node to data nodes.
NewDBConnQps Counts/s The number of connections per second established from the proxy node to data nodes.
DisconnectDBConn Counts The cumulative number of disconnections from the proxy node to data nodes.
DisconnectUserConn Counts The cumulative number of disconnections from clients to the proxy node.
UsedConnection ConnectionUsage % The connection usage of the proxy node.
UsedConnection Counts The number of connections from clients to the proxy node.
NewUserConnQps Counts/s The number of connections per second established from clients to the proxy node.

Aggregate monitoring metrics for data nodes

MonitorKeys Subordinate metric Unit Description
CpuUsage$db CpuUsage %
The CPU utilization. Valid values: 0% to 100%. The metric varies based on the instance series. This is because different instance series use engines that come with different threading models.
  • Tair persistent memory-optimized instances and DRAM-based instances that are compatible with Redis 6.0: RedisCpuUsage
  • Community Edition instances and other Tair instances: CpuUsage
RedisCpuUsage$db RedisCpuUsage %
UsedMemory$db UsedMemory Bytes The amount of used memory, which indicates the amount of memory consumed by data and cache.
quotaMemory$db quotaMemory Bytes The total size of memory.
MemoryUsage$db memoryUsage % The memory usage.
Note The metric is not displayed if you use instances that run Redis 2.8. In this case, if you need this metric, you must upgrade the engine version of the instance. For more information about how to upgrade the engine version, see Upgrade the major version.
Redis_Basic_Monitor$db Keys Counts The total number of keys, which indicates the number of primary keys stored in the data nodes.
Expires Counts The total number of key-value pairs that have an expiration time configured.
Note The metric collects the total number of keys at the point in time when data is collected. The metric collects an instantaneous value.
ExpiredKeys Counts The total number of expired keys.
EvictedKeys Counts The total number of evicted keys.
inmem_keys Counts The number of key-value pairs stored in memory.
Note The metric is supported only by hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about hybrid storage instances, see Hybrid-storage instances (phased out).
swapped_keys Counts The number of key-value pairs stored in disks.
Note The metric is supported only by hybrid storage instances of the ApsaraDB for Redis Enhanced Edition (Tair). For more information about hybrid storage instances, see Hybrid-storage instances (phased out).
ExpiredKeysPerSecond Counts/s The number of keys that are expired per second.
EvictedKeysPerSecond Counts/s The number of keys that are evicted per second.

Aggregate monitoring metrics for proxy nodes

MonitorKeys Subordinate metric Unit Description
UsedConnection$proxy ConnectionUsage % The connection usage, which is calculated by using the following formula: Connection usage = Number of connections/Total number of connections supported by the proxy nodes.
UsedConnection Counts The number of used connections, which indicates the number of TCP connections to the proxy nodes.
NewUserConnQps Counts/s The number of connections per second established from clients to the proxy nodes.
IntranetIn$proxy IntranetIn KBps The inbound traffic rate of proxy nodes.
IntranetOut$proxy IntranetOut KBps The outbound traffic rate of proxy nodes.
UsedQPS$proxy TotalQps Counts/s The total number of requests per second, which includes read and write requests.
GetQps Counts/s The number of read requests per second.
Note The metric is displayed only if you use instances that run the latest minor version. For more information about how to update the minor version, see Update the minor version.
PutQps Counts/s The number of write requests per second.
Note The metric is displayed only if you use instances that run the latest minor version. For more information about how to update the minor version, see Update the minor version.
Redis_Max_Rt_Monitor$proxy MaxRt us The highest latency for commands, which indicates the maximum time period from the time when proxy nodes receive a command to the time when the nodes return the command output to clients.
Redis_Avg_Rt_Monitor$proxy AvgRt us The average latency for commands, which indicates the average time period from the time when proxy nodes receive a command to the time when the nodes return the command output to clients.

Monitoring metrics for ApsaraDB for Memcache instances

Note The DescribeHistoryMonitorValues operation is also applicable to ApsaraDB for Memcache. For more information about ApsaraDB for Memcache, see ApsaraDB for Memcache. To collect metrics of ApsaraDB for Memcache instances, you can set the parameters listed in the MonitorKeys column.
MonitorKeys Subordinate metric Unit Description
Memcached_Monitor mem_get, mem_set, mem_add, mem_replace, mem_delete, mem_incr, mem_decr, mem_flush_all, mem_noop, mem_version, mem_getk, mem_append, mem_append, mem_preappend, mem_gat, mem_gets, and mem_cas Counts/s The number of times per second ApsaraDB for Memcache commands are run.
Memcached_Quiet_Monitor mem_getq, mem_setq, mem_addq, mem_replaceq, mem_deleteq, mem_incrq, mem_decrq, mem_flush_allq, mem_getkq, mem_appendq, mem_preappendq, and mem_gatq Counts/s
Memcached_Quit_Monitor mem_quit and mem_quitq Counts/s
Memcached_Sasl_Monitor mem_list_mechs, mem_sasl_auth, and mem_sasl_step Counts/s