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.
|
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
|
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.
|
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.
|
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 |