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

Associated API operations

DescribeHistoryMonitorValues: queries detailed monitoring information about 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. Standard instances of ApsaraDB for Redis support only Metrics for a single node.

Metrics for a single 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 connections usage. Connections usage = Number of connections/Total number of connections supported by the instance.
CpuUsage CpuUsage % The CPU usage.
FailedCount FailedCount Counts The number of failed commands.
Hit_Rate_Monitor hit_rate % The hit ratio of keys. Hit ratio = Total key hits/(Total key hits + Total key misses).
Note The metric is not collected if you use instances of Redis 2.8. You must upgrade the minor version of the instance. For more information, see Upgrade the minor version.
hit Counts/s The number of keys that are hit per second.
miss Counts/s The number of keys that are missed 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 usage rate of the inbound traffic.
IntranetOut OutFlow KBps The outbound traffic rate.
IntranetOutRatio intranetOutRatio % The usage rate of the outbound traffic.
MemoryUsage memoryUsage % The memory usage.
Note Redis 2.8 instances are not supported. To collect this metric, you must upgrade the engine version of the instance. For more information, see Upgrade the major version.
QPSUsage qpsUsage % Queries-per-second (QPS) usage.
Redis_Avg_Rt_Monitor AvgRt us The average response time that is consumed by all commands. This is the average period from when the node receives the command request to when the node returns the response.
Redis_Basic_Monitor Keys Counts The total number of keys.
Expires Counts The total number of keys that have an expiration time set.
Note This metric indicates the instantaneous value when the data is collected.
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 in memory.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Hybrid-storage instances).
swapped_keys Counts The number of key-value pairs on the disk.
Note Supported by only the ApsaraDB for Redis Enhanced Edition (Hybrid-storage instances).
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 family of commands such as AUTH and ECHO is run.
Redis_DetailedSpaceUsage ins_size MB The total disk space that is occupied by the instance, including data_size and log_size.
data_size MB The size of data files on the persistent disk, including the append-only files (AOF) and Redis Database (RDB) files.
log_size MB The size of logs on the persistent disk, including the operational logs of ApsaraDB for Redis instances.
Redis_Geo_Monitor geoadd, geohash, geopos, geodist, georadius, and georadiusbymember. Counts/s The number of times per second each command in the Geo family of commands 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 family of commands 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 family of commands 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 family of commands 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 family of commands such as BLPOP and BRPOP is run.
Redis_Max_Rt_Monitor MaxRt us The maximum response time of requests. This is the maximum response time at which a data node sends a response after it receives a command.
Redis_Memory_Monitor used_memory_rss Bytes The physical memory occupied by the process. This is the memory allocated by the operating system to the Redis service.
used_memory_overhead Bytes The memory usage that is required to support the internal mechanism of ApsaraDB for Redis. This includes the output buffers, query buffers, and AOF files for all clients.
used_memory_startup Bytes The memory consumed by ApsaraDB for Redis at startup.
used_memory_dataset Bytes The memory occupied by the dataset.
lazyfree_pending_objects Counts The pending keys to be collected when ApsaraDB for Redis performs the lazy free operation.
used_memory_lua Bytes Specifies the memory used to store Lua script.
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 family of commands 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 family of commands 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 family of commands 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 family of commands 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 family of commands 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 family of commands 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 family of commands 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 family of commands such as ZADD and ZCARD is run.
UsedConnection ConnCount Counts The number of used connections. This is the number of Transmission Control Protocol (TCP) connections to the node.
Note
  • This metric is collected if the client is connected to a cluster instance of ApsaraDB for Redis through a direct connection.
  • This metric is not collected when the client is connected to a cluster instance or read/write splitting instance through the 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 includes the memory consumed by the data and cache.
UsedQPS TotalQps Counts/s The total number of requests per second, including read and write requests.
GetQps Counts/s The number of read requests per second.
Note To collect this metric, you must upgrade the engine version of the ApsaraDB for Redis instance to Redis 4.0 or later with the latest minor version. For more information, see Upgrade the major version and Upgrade the minor version.
PutQps Counts/s The number of write requests per second.
Note To collect this metric, you must upgrade the engine version of the ApsaraDB for Redis instance to Redis 4.0 or later with the latest minor version. For more information, see Upgrade the major version and Upgrade the minor version.
Redis_TairBloom_Monitor bfadd, bfmadd, bfexists, bfmexists, bfinsert, bfreserve, and bfdebug. Counts/s The number of times per second TairBloom group commands such as BF.RESERVE and BF.ADD are run.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Performance-enhanced instances) and Enhanced Edition (Hybrid-storage instances).
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 TairDoc group commands are run, such as JSON.SET and JSON.GET.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Performance-enhanced instances) and Enhanced Edition (Hybrid-storage instances).
Redis_TairGis_Monitor gisadd, gisget, gisdel, gissearch, giscontains, gisintersects, and gisgetall. Counts/s The number of times per second TairGis group commands such as GIS.ADD, GIS.GET, and GIS.DEL are run.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Performance-enhanced instances) and Enhanced Edition (Hybrid-storage instances).
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 TairHash group commands such as EXHSET and EXHMSET are run.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Performance-enhanced instances) and Enhanced Edition (Hybrid-storage instances).
Redis_TairString_Monitor cas, cad, exset, exget, exsetver, exincrby, exincrbyfloat, excas, and excad. Counts/s The number of times per second TairString group commands such as EXSET and EXGET are run.
Note Supported by only ApsaraDB for Redis Enhanced Edition (Performance-enhanced instances) and Enhanced Edition (Hybrid-storage instances).

Metrics for a single proxy node

MonitorKeys Subordinate metric Unit Description
CpuUsage CpuUsage % The CPU usage.
IntranetIn IntranetIn KBps The inbound traffic rate.
Redis_Package_Monitor request Bytes The average number of bytes per request.
response Bytes The average number of bytes per response.
request_max Bytes The maximum number of bytes per request.
response_max Bytes The maximum number of bytes per response.
UsedQPS TotalQps Counts/s The total number of requests per second, including read and write requests.
GetQps Counts/s The number of read requests per second.
Note To collect the metric, you must upgrade the minor version of the ApsaraDB for Redis instance to the latest. For more information, see Upgrade the minor version.
PutQps Counts/s The number of write requests per second.
Note To collect the metric, you must upgrade the minor version of the ApsaraDB for Redis instance to the latest one. For more information, see Upgrade the minor version.
IntranetOut IntranetOut KBps The outbound traffic rate.
Redis_Max_Rt_Monitor MaxRt us The maximum response time of requests. This is the maximum response time at which a proxy node sends a response after it receives a command.
Redis_Avg_Rt_Monitor AvgRt us The average response time of all commands. This is the average time period from the time when the proxy node receives the command request to the time when the proxy node returns the response.
TotalCalls TotalRefusedCommands Counts The cumulative number of rejected commands.
TotalCallsPerSecCalls Counts/s The number of requests per second
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 from the proxy node to a data node.
NewDBConnQps Counts/s The number of connections per second established from the proxy node to a data node.
DisconnectDBConn Counts The cumulative number of times that the proxy nodes are disconnected from data nodes.
DisconnectUserConn Counts The cumulative number of disconnections from the client to the proxy node.
UsedConnection ConnectionUsage % The connection usage of the proxy node.
UsedConnection Counts The number of connections from the client to the proxy node.
NewUserConnQps Counts/s The number of connections per second established from the client to the proxy node.

Aggregate monitoring metrics for data nodes

MonitorKeys Subordinate metric Unit Description
CpuUsage$db CpuUsage % The CPU usage.
UsedMemory$db UsedMemory Bytes The amount of used memory, which includes the memory consumed by the data and cache.
MemoryUsage$db memoryUsage % The memory usage.
Note Redis 2.8 instances are not supported. To collect this metric, you must upgrade the engine version of the instance. For more information, see Upgrade the major version.
Redis_Basic_Monitor$db Keys Counts The total number of keys.
Expires Counts The total number of keys that have an expiration time set.
Note This metric indicates the instantaneous value when the data is collected.
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 in memory.
Note Supported only by ApsaraDB for Redis Enhanced Edition (Hybrid-storage instances).
swapped_keys Counts The number of key-value pairs on the disk.
Note Supported only by ApsaraDB for Redis Enhanced Edition (Hybrid-storage instances).
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 connections usage. Connections usage = Number of connections/Total number of connections supported by the instance.
UsedConnection Counts The number of used connections. This is the number of TCP connections to the proxy node.
NewUserConnQps Counts/s The number of connections per second established from the client to the proxy node.
IntranetIn$proxy IntranetIn KBps The inbound traffic rate of the proxy node.
IntranetOut$proxy IntranetOut KBps The outbound traffic rate of the proxy node.
UsedQPS$proxy TotalQps Counts/s The total number of requests per second, including read and write requests.
GetQps Counts/s The number of read requests per second.
Note To collect the metric, you must upgrade the minor version of the ApsaraDB for Redis instance to the latest. For more information, see Upgrade the minor version.
PutQps Counts/s The number of write requests per second.
Note To collect the metric, you must upgrade the minor version of the ApsaraDB for Redis instance to the latest. For more information, see Upgrade the minor version.
Redis_Max_Rt_Monitor$proxy MaxRt us The maximum response time of requests. This is the maximum response time at which a proxy node sends a response after it receives a command.
Redis_Avg_Rt_Monitor$proxy AvgRt us The average response time of all commands. This is the average time period from the time when the proxy node receives the command request to the time when the proxy node returns the response.

Monitoring metrics for an instance of ApsaraDB for Memcache

Note The DescribeHistoryMonitorValues operation is also applicable to ApsaraDB for Memcache. To collect metrics of an instance of ApsaraDB for Memcache, 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