Redis Metrics
For setup and configuration, see Redis.
Provided by the redis subagent on UNIX-like systems with the hiredis library.
The id argument is the connection ID from [Redis/Database/id], matched case-insensitively.
Values are read from the poller’s cache; the poller waits 60 seconds between polls.
Failed polls leave previous values in the cache; use Redis.IsReachable(id) alongside numeric metrics.
Fields omitted from later successful INFO responses also retain their previous cached values.
A configured connection with no cached value returns a collection error, except for Redis.Keys.DB, which returns 0 for an absent keyspace entry.
Unknown connection IDs are reported as unsupported.
Metrics
Redis.Clients.Blocked(id)
Clients blocked on a blocking operation (blocked_clients from Redis INFO).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Clients.Connected(id)
Connected clients (connected_clients).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Clients.MaxClients(id)
Configured client limit (maxclients).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Clients.ConnectedPerc(id)
Connected clients divided by the client limit, multiplied by 100, with two decimal places. The derived value is available only when the limit is greater than zero.
Data Type |
Float |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.IsReachable(id)
Poller connection status: YES or NO. This is the status of the last connection or INFO attempt; requesting the metric does not initiate a new connection.
Data Type |
String |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Keys.DB(id,database)
Keys in the logical database identified by the second argument.
Returns 0 when that database has no entry in the cached keyspace information, including before the first successful poll.
If a database disappears from a later INFO keyspace response, its previous key count remains cached until a later response includes that database again or the agent restarts.
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
database |
Integer |
Logical database number, for example |
Redis.Keys.Evicted(id)
Cumulative evicted keys (evicted_keys).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Keys.Expired(id)
Cumulative expired keys (expired_keys).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Keys.Total(id)
Sum of key counts for all logical databases present in the cached INFO keyspace section, regardless of the configured database value.
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.Fragmentation(id)
Memory fragmentation ratio (mem_fragmentation_ratio), returned directly by Redis.
Data Type |
Float |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.MaxMemory(id)
Configured maximum memory in bytes (maxmemory); 0 means no configured limit.
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.Peak(id)
Peak allocated memory in bytes (used_memory_peak).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.Used(id)
Allocated memory in bytes (used_memory).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.UsedPerc(id)
Allocated memory divided by maxmemory, multiplied by 100, with two decimal places. Returns 0.00 when maxmemory is 0.
Data Type |
Float |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Memory.UsedRSS(id)
Resident memory in bytes (used_memory_rss).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Persistence.AOFEnabled(id)
Whether append-only file persistence is enabled (aof_enabled): 1 = enabled, 0 = disabled.
Data Type |
Integer |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Persistence.Changes(id)
Changes since the last RDB save (rdb_changes_since_last_save).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Persistence.LastSave(id)
UNIX timestamp of the last RDB save (rdb_last_save_time).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Replication.ConnectedSlaves(id)
Connected replicas (connected_slaves).
Data Type |
Unsigned Integer |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Replication.MasterLinkStatus(id)
Upstream replication link status (master_link_status, normally up or down). For a primary with no such field cached, the subagent supplies N/A.
Data Type |
String |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Replication.Role(id)
Replication role (role), as reported by Redis.
Data Type |
String |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Server.Mode(id)
Server mode (redis_mode), as reported by Redis.
Data Type |
String |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Server.Uptime(id)
Server uptime in seconds (uptime_in_seconds).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Server.Version(id)
Redis version (redis_version).
Data Type |
String |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Stats.HitRatio(id)
Keyspace hits divided by hits plus misses, multiplied by 100, with two decimal places. Returns 0.00 when there have been no hits or misses.
Data Type |
Float |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Stats.KeyspaceHits(id)
Cumulative successful key lookups (keyspace_hits).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Stats.KeyspaceMisses(id)
Cumulative unsuccessful key lookups (keyspace_misses).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Stats.NetworkInput(id)
Cumulative received bytes (total_net_input_bytes).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |
Redis.Stats.NetworkOutput(id)
Cumulative sent bytes (total_net_output_bytes).
Data Type |
Unsigned Integer 64 |
Platforms |
UNIX-like systems ( |
| Argument | Type | Description |
|---|---|---|
id |
String |
Configured connection ID |