---
name: "pmdaredis"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmdaredis"
---

# pmdaredis(1)

Redis performance metrics domain agent (PMDA)

## NAME

**pmdaredis** - Redis performance metrics domain agent (PMDA)

## DESCRIPTION

This PMDA extracts performance data from sending the INFO command to a Redis (redis.io) server, which includes:

- •

  General information about the Redis server

- •

  Client connections

- •

  Memory consumption

- •

  Persistence statistics

- •

  Replication statistics

- •

  CPU consumption statistics

- •

  Redis command statistics

- •

  Redis Cluster statistics

- •

  Database related statistics

The hostname (localhost), port (6379 by default) and other configuration information must be specified in the `$PCP_PMDAS_DIR`/redis/redis.conf file.

```
# cd $PCP_PMDAS_DIR/redis
# [ edit redis.conf ]
  host=localhost.localdomain:6379
```

Once this is setup, you can access the names and values for the redis performance metrics by doing the following as root:

```
# cd $PCP_PMDAS_DIR/redis
# ./Install
```

To uninstall, the following must be done as root:

```
# cd $PCP_PMDAS_DIR/redis
# ./Remove
```

**pmdaredis** is launched by [*pmcd*(1)](/pmcd/1.md) and should never be executed directly. The Install and Remove scripts notify [*pmcd*(1)](/pmcd/1.md) when the agent is installed or removed.

## FILES

- **$PCP\_PMDAS\_DIR/redis/redis.conf**

  mandatory configuration file listing monitored redis instances

- **$PCP\_PMDAS\_DIR/redis/Install**

  installation script for the **pmdaredis** agent

- **$PCP\_PMDAS\_DIR/redis/Remove**

  undo installation script for the **pmdaredis** agent

- **$PCP\_LOG\_DIR/pmcd/redis.log**

  default log file for error messages from **pmdaredis**

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by **PCP**. On each installation, the file **/etc/pcp.conf** contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [*pcp.conf*(5)](/pcp.conf/5.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md) and [**pmcd**(1)](/pmcd/1.md).