Introduction

The INFO command is one of the most useful diagnostic tools in Redis. It provides detailed information about the server's current status, including memory usage, connected clients, persistence, replication, CPU utilization, and database statistics.

System administrators and developers frequently use the INFO command to monitor Redis performance, troubleshoot issues, and verify server configuration.

This guide explains how the Redis INFO command works, its available sections, and the most important metrics to monitor in production environments.

What Is the Redis INFO Command?

The INFO command returns runtime statistics about a Redis server.

Run:

redis-cli INFO

Example output:

Server

redis_version:8.2.0

Clients

connected_clients:12

Memory

used_memory:31457280

Persistence

loading:0

Stats

total_connections_received:12458

The output is divided into multiple sections, each containing statistics for a specific part of the Redis server.

INFO Syntax

Display all information:

redis-cli INFO

Display a specific section:

redis-cli INFO memory

redis-cli INFO clients

redis-cli INFO persistence

Displaying only the required section produces cleaner output and is commonly used in scripts and monitoring tools.

INFO Sections

Redis organizes server statistics into multiple sections.

| Section        | Description                                                     |
| -------------- | --------------------------------------------------------------- |
| `server`       | Redis version, operating system, process information and uptime |
| `clients`      | Connected client statistics                                     |
| `memory`       | Memory allocation and usage                                     |
| `persistence`  | RDB and AOF status                                              |
| `stats`        | General server statistics                                       |
| `replication`  | Replication and replication role                                |
| `cpu`          | CPU usage statistics                                            |
| `commandstats` | Command execution statistics                                    |
| `keyspace`     | Database key statistics                                         |

INFO Server

Displays general information about the running Redis server.

Example:

redis-cli INFO server

Useful fields include:

Redis version

Operating system

Process ID

Uptime

Configuration file location

This section is commonly used to verify the running Redis version after upgrades.

INFO Clients

Displays client connection statistics.

Example:

redis-cli INFO clients

Common fields include:

Connected clients

Blocked clients

Maximum configured clients

This section helps diagnose connection problems and monitor client activity.

INFO Memory

Displays Redis memory statistics.

Example:

redis-cli INFO memory

Important metrics include:

used_memory

used_memory_peak

used_memory_rss

maxmemory

mem_fragmentation_ratio

For a detailed explanation, see:

Redis INFO Memory Explained

INFO Persistence

Shows the current status of persistence.

Example:

redis-cli INFO persistence

Useful information includes:

RDB save status

Last successful save

AOF enabled status

Background save progress

This section is essential for verifying that persistence is functioning correctly.

INFO Replication

Displays replication information.

Example:

redis-cli INFO replication

Typical fields include:

Master or replica role

Connected replicas

Replication offset

Synchronization status

This information is especially useful in high-availability deployments.

INFO CPU

Displays CPU usage statistics.

Example:

redis-cli INFO cpu

Administrators can monitor CPU consumption and identify unusually high resource usage.

INFO Keyspace

Shows database statistics.

Example:

redis-cli INFO keyspace

Example output:

db0:keys=12800,expires=2500

This section displays:

Number of keys

Keys with expiration

Database activity

Common Use Cases

The INFO command is commonly used to:

Monitor memory usage.

Verify Redis persistence.

Check client connections.

Monitor replication status.

Troubleshoot performance issues.

Collect metrics for monitoring systems.

Many monitoring platforms periodically execute INFO to gather server statistics.

Best Practices

Monitor important INFO sections regularly.

Use section-specific queries instead of retrieving all information when possible.

Integrate Redis statistics with monitoring tools such as Prometheus and Grafana.

Investigate unusual changes in memory, client connections, or persistence status.

Monitor trends over time rather than relying on individual snapshots.

Related Articles

Redis Explained

Redis Persistence Explained

Redis INFO Memory Explained

Redis maxmemory Explained

Redis maxmemory-policy Explained

Redis slowlog Explained

Conclusion

The Redis INFO command provides a comprehensive overview of server health and performance. By understanding sections such as memory, clients, persistence, replication, and cpu, administrators can quickly identify problems, monitor resource usage, and maintain stable Redis deployments.

Whether managing a development server or a large production environment, the INFO command is one of the most valuable tools for monitoring and troubleshooting Redis.