Redis / Valkey¶

The redis probe monitors Redis (or Valkey) via the INFO command, reporting memory usage, client connections, command throughput, cache hit/miss ratio, keyspace size, replication state and persistence (RDB/AOF) health.

Quick start¶

probes:
  - name: redis
    type: redis
    params:
      host: 127.0.0.1
      port: 6379

Parameters¶

Parameter	Default	Description
`host`	`127.0.0.1`	Redis server hostname or IP
`port`	`6379`	Redis server port
`password`	—	Redis `AUTH` password (if required)
`tls`	`false`	Enable TLS for the Redis connection

Metrics¶

Metric	Unit	Description
`senhub.db.up`	1	1 when the agent reached the Redis server
`redis.uptime`	s	Server uptime
`redis.clients.connected`	{connection}	Connected client count
`redis.clients.blocked`	{connection}	Clients blocked on a command (BLPOP, etc.)
`redis.connections.received`	{connection}	Total connections accepted since start
`redis.memory.used`	By	Memory currently allocated by Redis
`redis.memory.peak`	By	Peak memory allocation
`redis.memory.fragmentation_ratio`	1	Memory fragmentation ratio
`redis.commands.processed`	{command}	Total commands processed since start
`redis.keyspace.hits`	{hit}	Successful key lookups
`redis.keyspace.misses`	{miss}	Failed key lookups
`redis.keys.expired`	{key}	Keys expired since start
`redis.keys.evicted`	{key}	Keys evicted due to `maxmemory` policy
`redis.replication.lag`	s	Replica lag in seconds (replica instances only)
`redis.rdb.last_save.duration`	s	Duration of the last successful RDB save

Operational notes¶

Valkey (the Redis fork) exposes the same INFO interface; configure it identically.
For Redis Cluster, point the probe at one node; cluster-wide stats are reported per node, not aggregated.
Metric names align with the community redis_exporter baseline.