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 (redis)

Table 1. Arguments
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 (redis)

Table 2. Arguments
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 (redis)

Table 3. Arguments
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 (redis)

Table 4. Arguments
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 (redis)

Table 5. Arguments
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 (redis)

Table 6. Arguments
Argument Type Description

id

String

Configured connection ID

database

Integer

Logical database number, for example 0 for db0

Redis.Keys.Evicted(id)

Cumulative evicted keys (evicted_keys).

Data Type

Unsigned Integer 64

Platforms

UNIX-like systems (redis)

Table 7. Arguments
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 (redis)

Table 8. Arguments
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 (redis)

Table 9. Arguments
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 (redis)

Table 10. Arguments
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 (redis)

Table 11. Arguments
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 (redis)

Table 12. Arguments
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 (redis)

Table 13. Arguments
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 (redis)

Table 14. Arguments
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 (redis)

Table 15. Arguments
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 (redis)

Table 16. Arguments
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 (redis)

Table 17. Arguments
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 (redis)

Table 18. Arguments
Argument Type Description

id

String

Configured connection ID

Redis.Replication.ConnectedSlaves(id)

Connected replicas (connected_slaves).

Data Type

Unsigned Integer

Platforms

UNIX-like systems (redis)

Table 19. Arguments
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 (redis)

Table 20. Arguments
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 (redis)

Table 21. Arguments
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 (redis)

Table 22. Arguments
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 (redis)

Table 23. Arguments
Argument Type Description

id

String

Configured connection ID

Redis.Server.Version(id)

Redis version (redis_version).

Data Type

String

Platforms

UNIX-like systems (redis)

Table 24. Arguments
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 (redis)

Table 25. Arguments
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 (redis)

Table 26. Arguments
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 (redis)

Table 27. Arguments
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 (redis)

Table 28. Arguments
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 (redis)

Table 29. Arguments
Argument Type Description

id

String

Configured connection ID

Redis.Stats.OpsPerSec(id)

Instantaneous operations per second reported by Redis (instantaneous_ops_per_sec).

Data Type

Unsigned Integer 64

Platforms

UNIX-like systems (redis)

Table 30. Arguments
Argument Type Description

id

String

Configured connection ID

Redis.Stats.TotalCommands(id)

Cumulative processed commands (total_commands_processed).

Data Type

Unsigned Integer 64

Platforms

UNIX-like systems (redis)

Table 31. Arguments
Argument Type Description

id

String

Configured connection ID

Lists

Redis.Databases

Configured connection IDs, usable for agent-list instance discovery. These are connection IDs, rather than Redis logical database numbers.

Data Type

List

Platforms

UNIX-like systems (redis)