Redis Integration - Atatus Docs

The Redis integration allows you to monitor your Redis server with the Atatus Infrastructure Agent. The agent connects to Redis to read its metrics and picks up the Redis logs from the same configuration file. Use this integration to:

Track memory usage and the memory fragmentation ratio.
Monitor client connections, blocked clients, and rejected connections.
Observe keyspace hits and misses, evicted keys, and commands processed.
Check replication and persistence status.
Collect Redis server logs and slow logs.

Setup

No additional installation is required. The Redis integration is bundled with the Atatus Infrastructure Agent.

Configuration

Metrics

Copy the Redis example configuration file that ships with the agent:

cd /etc/atatus-infra-agent/conf.d/redis.d/
sudo cp redis.yml.template redis.yml

Then add the following configuration to /etc/atatus-infra-agent/conf.d/redis.d/redis.yml:

# Metrics section
metrics:

    # Host details
  - hosts: ["127.0.0.1:6379"]

    # Redis AUTH password. Empty by default.
    #password:

Check these before you save:

hosts must be the address and port Redis listens on. 6379 is the default Redis port.
password is only needed if your Redis server uses requirepass. Uncomment the line and set your password.

Logs

Logs are configured in the same file as metrics. First, turn on log collection for the agent in /etc/atatus-infra-agent/atatus.yml:

logs_enabled: true

Then add a logs section to /etc/atatus-infra-agent/conf.d/redis.d/redis.yml. The two default types pick up the standard Redis log paths:

# Log section
logs:
  - type: log
  - type: slowlog

If your logs are in a different location, replace the two default types with your own paths:

# Log section
logs:
  - type: log
    paths:
      - /var/log/redis/redis-server.log*
    source: redis
    service: redis

  - type: slowlog
    paths:
      - /var/log/redis_6379.log
    source: redis
    service: redis

Redis Logs Monitoring covers the log options in more detail.

Verify Metrics

You can verify that Redis is reachable from the agent host with redis-cli:

redis-cli -h 127.0.0.1 -p 6379 ping

A healthy server replies with PONG. Add -a <PASSWORD> if your Redis server uses a password.

Restart the Agent

After configuration, restart the Atatus Infrastructure Agent:

sudo service atatus-infra-agent restart

Metrics

These are the metrics the integration collects from Redis:

Name	Description	Type
redis.info.memory.used.value	Total number of bytes allocated by Redis.	`long`
redis.info.memory.fragmentation.ratio	Ratio between `used_memory_rss` and `used_memory`.	`float`
redis.info.stats.keys.evicted	Number of evicted keys.	`long`
redis.info.clients.blocked	Number of clients pending on a blocking call (BLPOP, BRPOP, BRPOPLPUSH).	`long`
redis.info.clients.connected	Number of client connections, excluding connections from replicas.	`long`
redis.info.stats.connections.rejected	Total number of connections rejected.	`long`
redis.info.replication.master.link_status	Status of the link to the master (up or down).	`long`
redis.info.stats.commands_processed	Total number of commands processed.	`long`
redis.info.replication.connected_slaves	Number of connected replicas.	`long`
redis.info.stats.keyspace.hits	Number of successful key lookups in the main dictionary.	`long`
redis.info.stats.keyspace.misses	Number of failed key lookups in the main dictionary.	`long`
redis.info.persistence.rdb.last_save.changes_since	Number of changes since the last dump.	`long`

​Setup

​Configuration

​Metrics

​Logs

​Verify Metrics

​Restart the Agent

​Metrics

Setup

Configuration

Metrics

Logs

Verify Metrics

Restart the Agent

Metrics