Redis integration metrics
The official Datadog integration for monitoring Redis. It collects 271 metrics.
Official summary
Track redis performance, memory use, blocked clients, evicted keys, and more.
Metric types
- gauge (value at a point in time): 270
- rate (per second): 1
Metrics
Descriptions are the official definitions, unedited.
| Metric | Type | Unit |
|---|---|---|
redis.Number of authentication failures | gauge | - |
redis.Number of commands rejected because of access denied to a channel | gauge | - |
redis.Number of commands rejected because of access denied to the command | gauge | - |
redis.Number of commands rejected because of access denied to a key | gauge | - |
redis.Number of value reallocations performed by the active defragmentation process. | gauge | operation |
redis.Number of keys that were actively defragmented. | gauge | key |
redis.Number of keys that were skipped by. | gauge | key |
redis.Number of aborted value reallocations started by the active defragmentation process. | gauge | operation |
redis.Whether active defragmentation is running or not. | gauge | - |
redis.Total bytes in the allocator active pages, this includes external-fragmentation | gauge | byte |
redis.Total bytes allocated form the allocator, including internal-fragmentation. Normally the same as redis.mem.used. | gauge | byte |
redis.Total bytes in the allocator active pages specifically for Lua, including external-fragmentation. | gauge | byte |
redis.Total bytes allocated from the allocator specifically for Lua, including internal-fragmentation. | gauge | byte |
redis.Delta between redis.allocator.debug.active_lua and redis.allocator.debug.allocated_lua. | gauge | byte |
redis.Total bytes resident (RSS) in the allocator specifically for Lua. This includes pages that can be released to the OS (by MEMORY PURGE, or just waiting). | gauge | byte |
redis.Ratio between redis.allocator.active and redis.allocator.allocated. This is the true (external) fragmentation metric (not redis.mem.fragmentation_ratio). | gauge | byte |
redis.Total bytes of 'muzzy' memory (RSS) in the allocator. Muzzy memory is memory that has been freed, but not yet fully returned to the operating system. It can be reused immediately when needed or reclaimed by the OS when system pressure increases. | gauge | byte |
redis.Total byte resident (RSS) in the allocator, this includes pages that can be released to the OS (by MEMORY PURGE, or just waiting). | gauge | - |
redis.Delta between redis.allocator.resident and redis.allocator.active | gauge | byte |
redis.Ratio between redis.allocator.resident and redis.allocator.active. This usually indicates pages that the allocator can and probably will soon release back to the OS. | gauge | - |
redis.AOF file size on latest startup or rewrite | gauge | byte |
redis.Size of the AOF buffer. | gauge | byte |
redis.Delayed fsync counter | gauge | - |
redis.Flag indicating AOF logging is activated | gauge | - |
redis.The size in bytes of copy-on-write memory during | gauge | byte |
redis.Duration of the last AOF rewrite. | gauge | second |
redis.The estimated amount of time left to load. | gauge | second |
redis.The amount of bytes to load. | gauge | byte |
redis.The percent loaded. | gauge | percent |
redis.The total amount of bytes already loaded. | gauge | byte |
redis.Number of fsync pending jobs in background I/O | gauge | - |
redis.Flag indicating an AOF rewrite operation | gauge | - |
redis.Flag indicating a AOF rewrite operation is on-going. | gauge | - |
redis.Size of the AOF rewrite buffer. Note this field was removed in Redis 7.0 | gauge | byte |
redis.Duration of the on-going AOF rewrite | gauge | second |
redis.Flag indicating an AOF rewrite operation | gauge | - |
redis.Number of AOF rewrites performed since startup | gauge | - |
redis.AOF current file size (redis.aof.size). | gauge | byte |
redis.The network's read rate per second in bytes/sec. Only available on Azure Redis. | gauge | byte/ |
redis.The network's write rate per second in bytes/sec. Only available on Azure Redis. | gauge | byte/ |
redis.The biggest input buffer among current client connections [v3 & v4]. | gauge | - |
redis.The number of connections waiting on a blocking call. | gauge | connection |
redis.Number of evicted clients due to maxmemory-clients limit | gauge | - |
redis.The longest output list among current client connections [v3 & v4]. | gauge | - |
redis.Total number of disconnections due to client reaching output buffer limit | gauge | - |
redis.Total number of disconnections due to client reaching query buffer limit | gauge | - |
redis.The biggest input buffer among recent client connections [v5+]. | gauge | - |
redis.The longest output buffer among recent client connections [v5+]. | gauge | - |
redis.Number of clients in the clients timeout table | gauge | - |
redis.Number of clients in watching mode (WATCH) | gauge | - |
redis.An approximation of the number of sockets used by the cluster's bus | gauge | - |
redis.The local current epoch variable used by the cluster for config versioning | gauge | - |
redis.Indicate Redis cluster is enabled | gauge | - |
redis.Total number of known nodes in the cluster | gauge | - |
redis.The number of master nodes serving at least one hash slot in the cluster | gauge | - |
redis.Number of slots assigned to nodes | gauge | - |
redis.Number of slots in FAIL state | gauge | - |
redis.Number of slots with no nodes in FAIL or PFAIL state | gauge | - |
redis.Number of slots in PFAIL state | gauge | - |
redis.Whether the cluster is in a working state (1) or has encountered an error (0) | gauge | - |
redis.The number of times a redis command has been called, tagged by 'command', e.g. 'command:append'. Enable in Agent's redisdb.yaml with the command_stats option. | gauge | - |
redis.The CPU time consumed per redis command call, tagged by 'command', e.g. 'command:append'. Enable in Agent's redisdb.yaml with the command_stats option. | gauge | microsecond |
redis.Total number of commands processed by the server | gauge | - |
redis.The peak size in bytes of copy-on-write memory | gauge | byte |
redis.The size in bytes of copy-on-write memory | gauge | byte |
redis.The age, in seconds, of the redis.cow.current_size value. | gauge | second |
redis.System CPU consumed by the Redis server. | gauge | - |
redis.System CPU consumed by the background processes. | gauge | - |
redis.System CPU consumed by the Redis server main thread [v7+]. | gauge | - |
redis.User CPU consumed by the Redis server. | gauge | - |
redis.User CPU consumed by the background processes. | gauge | - |
redis.User CPU consumed by the Redis server main thread [v7+]. | gauge | - |
redis.The time passed since memory fragmentation last was over the limit, in milliseconds | gauge | millisecond |
redis.Total time memory fragmentation was over the limit, in milliseconds | gauge | millisecond |
redis.Total number of issued error replies, that is the sum of rejected commands (errors prior command execution) and failed commands (errors within the command execution) | gauge | - |
redis.Number of unexpected error replies, that are types of errors from an AOF load or replication | gauge | - |
redis.The maximal number of commands processed in a single eventloop cycle | gauge | - |
redis.Total number of eventloop cycles | gauge | - |
redis.Total time spent on flushing AOF in eventloop in microseconds. | gauge | microsecond |
redis.Total time spent on executing commands in microseconds | gauge | microsecond |
redis.Total time consumption of cron in microseconds (including serverCron and beforeSleep, but excluding IO and AOF flushing). | gauge | microsecond |
redis.The maximal time spent in a single eventloop cycle in microseconds. | gauge | microsecond |
redis.Total time spent in the eventloop in microseconds (including I/O and command processing) | gauge | microsecond |
redis.Number of eventloop cycles per second | gauge | - |
redis.Average time spent in a single eventloop cycle in microseconds | gauge | microsecond |
redis.The time passed since redis.mem.used last rose above redis.mem.maxmemory, in milliseconds | gauge | millisecond |
redis.Total time redis.mem.used was greater than redis.mem.maxmemory since server startup, in milliseconds | gauge | millisecond |
redis.The cumulative amount of time spent on active expiry cycles | gauge | millisecond |
redis.The number of hash field expiration events | gauge | - |
redis.The count of times that active expiry cycles have stopped early | gauge | - |
redis.The number of keys with an expiration. | gauge | key |
redis.Percentage of total keys with an expiration. | gauge | percent |
redis.Total number of fork operations since the server start | gauge | - |
redis.The number of functions [v7+]. | gauge | - |
redis.The latency of the redis INFO command. | gauge | millisecond |
redis.The number of elements in a given key, tagged by key, e.g. 'key:mykeyname'. Enable in Agent's redisdb.yaml with the keys option. | gauge | - |
redis.The total number of keys. | gauge | key |
redis.The total number of keys evicted due to the maxmemory limit. | gauge | key |
redis.The total number of keys expired from the db. | gauge | key |
redis.Number of blocking keys [v7.2+]. | gauge | - |
redis.Number of blocking keys that one or more clients that would like to be unblocked when the key is deleted [v7.2+]. | gauge | - |
redis.Number of watched keys [v7.4+]. | gauge | - |
redis.The number of libraries [v7+]. | gauge | - |
redis.Flag indicating if the load of a dump file is on-going | gauge | - |
redis.The memory usage of the server that had generated the RDB file at the time of the file's creation | gauge | byte |
redis.Epoch-based timestamp of the start of the load | gauge | - |
redis.The total size in byte of all clients overheads. | gauge | byte |
redis.The total size in byte of all replicas overheads. | gauge | byte |
redis.The size in byte of the dataset. | gauge | byte |
redis.Delta between redis.mem.rss and redis.mem.used. | gauge | byte |
redis.Ratio between redis.mem.rss and redis.mem.used. | gauge | fraction |
redis.Number of byte overhead by Function scripts (part of redis.mem.used). [v7+]. | gauge | byte |
redis.Amount of memory used by the Lua engine. | gauge | byte |
redis.Maximum amount of memory allocated to the Redisdb system. | gauge | byte |
redis.Sum of all overheads allocated by Redis for managing its internal datastructures [v4+]. | gauge | byte |
redis.The peak amount of memory used by Redis. | gauge | byte |
redis.Amount of memory that Redis allocated as seen by the os. | gauge | byte |
redis.redis.mem.scripts_eval + redis.mem.functions (part of redis.mem.used) [v7+]. | gauge | byte |
redis.Number of byte overhead by the EVAL scripts (part of redis.mem.used) [v7+]. | gauge | byte |
redis.Amount of memory consumed by Redis at startup. | gauge | byte |
redis.Total memory consumed for replication buffers [v7+]. | gauge | byte |
redis.Amount of memory allocated by Redis. | gauge | byte |
redis.Number of byte used by the script VM engines for EVAL framework (not part of redis.mem.used) [v7+]. | gauge | byte |
redis.Number of byte used by the script VM engines for Functions framework (not part of redis.mem.used) [v7+]. | gauge | byte |
redis.redis.mem.vm_eval + redis.mem.vm_functions (not part of redis.mem.used) [v7+]. | gauge | byte |
redis.Transient memory used for AOF and AOF rewrite buffers | gauge | byte |
redis.Memory used by links to peers on the cluster bus when cluster mode is enabled. | gauge | byte |
redis.Used memory that's not counted for key eviction. This is basically transient replica and AOF buffers. | gauge | byte |
redis.Temporary memory overhead of database dictionaries currently being rehashed [v7.4+]. | gauge | byte |
redis.Time when peak memory was recorded | gauge | - |
redis.Memory used by replication backlog | gauge | byte |
redis.Delta between redis.mem.rss (the process RSS) and redis.allocator.resident | gauge | byte |
redis.Ratio between redis.mem.rss (the process RSS) and redis.allocator.resident. This includes RSS overheads that are not allocator or heap related. | gauge | byte |
redis.The number of connected clients (excluding slaves). | gauge | connection |
redis.The number of commands processed by the server. | gauge | command |
redis.The number of commands processed by the server per second. | gauge | command/ |
redis.The number of connections tagged by client name. | gauge | connection |
redis.The network's read rate per second in KB/sec. | gauge | kibibyte/ |
redis.Number of commands processed per second. | gauge | operation/ |
redis.The network's write rate per second in KB/sec. | gauge | kibibyte/ |
redis.The maximum number of connected clients. | gauge | connection |
redis.The number of sockets open for MIGRATE purposes | gauge | - |
redis.The number of rejected connections. | gauge | connection |
redis.The number of connected slaves. | gauge | connection |
redis.Total number of connections accepted by the server. | gauge | connection |
redis.The total number of bytes read from the network | gauge | byte |
redis.The total number of bytes written to the network | gauge | byte |
redis.Total number of read events processed | gauge | - |
redis.Total number of write events processed | gauge | - |
redis.The duration of the latest fork. | gauge | microsecond |
redis.The number of keys persisted (redis.keys - redis.expires). | gauge | key |
redis.Percentage of total keys that are persisted. | gauge | percent |
redis.The latency of the redis PING command. | gauge | millisecond |
redis.The number of active pubsub channels. | gauge | - |
redis.Number of clients in pubsub mode (SUBSCRIBE, PSUBSCRIBE, SSUBSCRIBE) | gauge | - |
redis.The number of active pubsub patterns. | gauge | - |
redis.Global number of pub/sub shard channels with client subscriptions | gauge | - |
redis.One if a bgsave is in progress and zero otherwise. | gauge | - |
redis.The number of changes since the last background save. | gauge | - |
redis.Duration of the on-going RDB save operation | gauge | second |
redis.Duration of the last bg_save operation. | gauge | second |
redis.The size in bytes of copy-on-write memory during the last RDB save operation | gauge | byte |
redis.Number of volatile keys deleted during the last RDB loading [v7+]. | gauge | - |
redis.Number of keys loaded during the last RDB loading [v7+]. | gauge | - |
redis.Epoch-based timestamp of last successful RDB save | gauge | - |
redis.Number of RDB snapshots performed since startup | gauge | - |
redis.Flag indicating replication backlog is active | gauge | - |
redis.The master offset of the replication | gauge | - |
redis.The amount of data in the backlog sync buffer. | gauge | byte |
redis.Total size in bytes of the replication backlog buffer | gauge | byte |
redis.The replication delay in offsets. | gauge | offset |
redis.The total number of bytes read from the network for replication purposes | gauge | byte |
redis.The network's read rate per second in KB/sec for replication purposes | gauge | kilobyte/ |
redis.The network's write rate per second in KB/sec for replication purposes | gauge | kilobyte/ |
redis.Amount of time since the last interaction with master. | gauge | second |
redis.Amount of time that the master link has been down. | gauge | second |
redis.Master listening TCP port | gauge | - |
redis.The replication offset reported by the master. | gauge | offset |
redis.Number of replicas currently considered good | gauge | - |
redis.The total number of bytes written to the network for replication purposes | gauge | byte |
redis.Flag indicating if the replica is announced by Sentinel. | gauge | - |
redis.The offset up to which replication IDs are accepted | gauge | - |
redis.The number of keys tracked for expiry purposes | gauge | - |
redis.The priority of the instance as a candidate for failover | gauge | - |
redis.Flag indicating if the replica is read-only | gauge | - |
redis.The read replication offset of the replica instance. | gauge | - |
redis.The replication offset reported by the slave. | gauge | offset |
redis.One if a sync is in progress and zero otherwise. | gauge | - |
redis.The number of full resyncs with replicas | gauge | - |
redis.Number of seconds since last transfer I/O | gauge | second |
redis.The number of denied partial resync requests | gauge | - |
redis.The number of accepted partial resync requests | gauge | - |
redis.Number of bytes already transferred | gauge | byte |
redis.Total number of bytes that need to be transferred. This may be 0 when the size is unknown (for example, when the repl-diskless-sync configuration directive is used) | gauge | byte |
redis.Amount of data left before syncing is complete. | gauge | byte |
redis.Total number of output buffer expands | gauge | - |
redis.Total number of output buffer shrinks | gauge | - |
redis.The number of EVAL scripts cached by the server [v7+]. | gauge | - |
redis.Number of evicted EVAL scripts due to LRU policy [v7.4+]. | gauge | - |
redis.The total amount of memory freed by the garbage collectors from indexes in the shard memory in bytes | gauge | byte |
redis.The total number of coordinator cursors in the shard, either holding pending results or actively executing FT.CURSOR READ | gauge | - |
redis.The total number of coordinator cursors that are currently holding pending results in the shard | gauge | - |
redis.The total number of user cursors in the shard, either holding pending results or actively executing FT.CURSOR READ | gauge | - |
redis.The total number of cursors that were explicitly requested by users, that are currently holding pending results in the shard | gauge | - |
redis.The number of documents marked as deleted whose memory has not yet been freed by the garbage collector | gauge | - |
redis.The total number of indexing failures recorded across all indexes in the shard | gauge | - |
redis.The number of indexing failures in the index with the highest count of failures | gauge | - |
redis.The total number of GEO fields across all indexes in the shard | gauge | - |
redis.The total number of NOINDEX GEO fields across all indexes in the shard; i.e., used for sorting only but not indexed. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of SORTABLE GEO fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of GEOSHAPE fields across all indexes in the shard | gauge | - |
redis.The total number of NOINDEX GEOSHAPE fields across all indexes in the shard; i.e., used for sorting only but not indexed. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of SORTABLE GEOSHAPE fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of NOINDEX NUMERIC fields across all indexes in the shard; i.e., used for sorting only but not indexed. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of NUMERIC fields across all indexes in the shard | gauge | - |
redis.The total number of SORTABLE NUMERIC fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of CASESENSITIVE TAG fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of NOINDEX TAG fields across all indexes in the shard; i.e., used for sorting only but not indexed. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of SORTABLE TAG fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of TAG fields across all indexes in the shard | gauge | - |
redis.The total number of NOINDEX TEXT fields across all indexes in the shard, which are used for sorting only but not indexed. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of SORTABLE TEXT fields across all indexes in the shard. This field appears only if its value is larger than 0 | gauge | - |
redis.The total number of TEXT fields across all indexes in the shard | gauge | - |
redis.The total number of FLAT VECTOR fields across all indexes in the shard | gauge | - |
redis.The total number of HNSW VECTOR fields across all indexes in the shard | gauge | - |
redis.The total number of VECTOR fields across all indexes in the shard | gauge | - |
redis.The total amount of memory freed by the garbage collectors from indexes in the shard's memory in bytes | gauge | byte |
redis.The number of documents marked as deleted, whose memory has not yet been freed by the garbage collector | gauge | - |
redis.The number of vectors marked as deleted in the vector indexes that have not yet been cleaned | gauge | - |
redis.The total number of garbage collection cycles executed | gauge | - |
redis.The total duration of all garbage collection cycles in the shard, measured in milliseconds | gauge | millisecond |
redis.The total number of user and internal cursors currently holding pending results in the shard. Deprecated in 8.0 (split into redis.search.cursors.internal_idle and redis.search.cursors.user_idle) but still available in older versions | gauge | - |
redis.The total number of user and internal cursors in the shard, either holding pending results or actively executing FT.CURSOR READ. Deprecated in 8.0 (split into redis.search.cursors.internal_active and redis.search.cursors.user_active), but still available in older versions | gauge | - |
redis.The total number of indexes running a background indexing and/or background query processing operation. Background indexing refers to vector ingestion process, or in-progress background indexer | gauge | - |
redis.The total count of indexes currently undergoing a background indexing process. Background indexing refers to a vector ingestion process, or an in-progress background indexer. This metric is limited by the number of WORKER threads allocated for writing operations plus the number of indexes | gauge | - |
redis.The total count of indexes currently running a background query process | gauge | - |
redis.The total number of indexes in the shard | gauge | - |
redis.The total time spent on indexing operations, excluding the background indexing of vectors in the HNSW graph | gauge | - |
redis.The number of vectors marked as deleted in the vector indexes that have not yet been cleaned | gauge | - |
redis.The estimated memory usage of the index with the largest memory usage in the shard in bytes | gauge | byte |
redis.The estimated memory usage of the index with the smallest memory usage in the shard in bytes | gauge | byte |
redis.The estimated total memory allocated by all indexes in the shard in bytes (including vector indexes memory accounted in search_used_memory_vector_index) | gauge | byte |
redis.The total memory usage of all vector indexes in the shard | gauge | byte |
redis.The total number of background queries currently being executed in the shard, excluding FT.CURSOR READ | gauge | - |
redis.The total number of successful query command executions (including FT.SEARCH, FT.AGGREGATE, and FT.CURSOR READ) | gauge | - |
redis.The cumulative execution time of all query commands, including FT.SEARCH, FT.AGGREGATE, and FT.CURSOR READ, measured in ms | gauge | millisecond |
redis.The total number of successful query executions (When using cursors, not counting reading from existing cursors) in the shard | gauge | - |
redis.The total number of garbage collection cycles executed | gauge | - |
redis.The total duration of all garbage collection cycles in the shard, measured in milliseconds | gauge | millisecond |
redis.The total count of background write (indexing) processes currently running in the shard. Background indexing refers to a vector ingestion process, or an in-progress background indexer. This metric is limited by the number of threads allocated for writing operations | gauge | - |
redis.Number of Redis masters monitored by this Sentinel instance | gauge | - |
redis.The number of scripts this Sentinel is currently executing | gauge | - |
redis.The length of the queue of user scripts that are pending execution | gauge | - |
redis.Flags for the SENTINEL SIMULATE-FAILURE command | gauge | - |
redis.A value of 1 means this sentinel is in TILT mode | gauge | - |
redis.Duration in seconds of current TILT, or -1 if not TILTed [v7+]. | gauge | second |
redis.The number of times this sentinel has been in TILT mode since running. | gauge | - |
redis.Flag indicating if I/O threads are active [v6+]. | gauge | - |
redis.The 95th percentile of the duration of queries reported in the slow log. | gauge | microsecond |
redis.The average duration of queries reported in the slow log. | gauge | microsecond |
redis.The rate of queries reported in the slow log. | rate | query/ |
redis.The maximum duration of queries reported in the slow log. | gauge | microsecond |
redis.The median duration of queries reported in the slow log. | gauge | microsecond |
redis.Number of read events processed by the main and I/O threads [v6+]. | gauge | - |
redis.Number of write events processed by the main and I/O threads [v6+]. | gauge | - |
redis.The rate of successful lookups in the main db. | gauge | key/ |
redis.The rate of missed lookups in the main db. | gauge | key/ |
redis.Number of clients being tracked | gauge | - |
redis.Number of items, that is the sum of clients number for each key, that are being tracked | gauge | - |
redis.Number of keys being tracked by the server | gauge | - |
redis.Number of tracked prefixes in server's prefix table | gauge | - |
Official documentation
Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.