---
title: Redis Sentinel
description: Redis Sentinel provides high availability for Redis.
breadcrumbs: Docs > Integrations > Redis Sentinel
---

# Redis Sentinel
Supported OS Integration version1.1.1
## Overview{% #overview %}

Get metrics from Redis's Sentinel service in real time to:

- Visualize and monitor sentinels states
- Be notified about failovers

## Setup{% #setup %}

The Redis Sentinel check is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you need to install it.

### Installation{% #installation %}

For Agent v7.21+ / v6.21+, follow the instructions below to install the Redis Sentinel check on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations.md) to install with the Docker Agent or earlier versions of the Agent.

1. Run the following command to install the Agent integration:

   ```shell
   datadog-agent integration install -t datadog-redis_sentinel==<INTEGRATION_VERSION>
   ```

1. Configure your integration similar to core [integrations](https://docs.datadoghq.com/getting_started/integrations.md).

### Configuration{% #configuration %}

1. Edit the `redis_sentinel.d/conf.yaml` file in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files.md#agent-configuration-directory) to start collecting your Redis Sentinel metrics. See the [sample upsc.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/redis_sentinel/datadog_checks/redis_sentinel/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent)

## Validation{% #validation %}

Run the [Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#service-status) and look for `redis_sentinel` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **redis.sentinel.known\_sentinels**(gauge)        | number of sentinels detected*Shown as instance*                             |
| **redis.sentinel.known\_slaves**(gauge)           | number of slaves detected*Shown as instance*                                |
| **redis.sentinel.last\_ok\_ping\_latency**(gauge) | number of seconds since last OK ping*Shown as second*                       |
| **redis.sentinel.ok\_sentinels**(gauge)           | number of sentinels up and running*Shown as instance*                       |
| **redis.sentinel.ok\_slaves**(gauge)              | number of slaves up and running*Shown as instance*                          |
| **redis.sentinel.odown\_slaves**(gauge)           | number of slaves that are in the Objectively Down state*Shown as instance*  |
| **redis.sentinel.sdown\_slaves**(gauge)           | number of slaves that are in the Subjectively Down state*Shown as instance* |
| **redis.sentinel.link\_pending\_commands**(gauge) | number of pending sentinel commands*Shown as command*                       |
| **redis.sentinel.ping\_latency**(gauge)           | latency of a sentinel ping*Shown as millisecond*                            |
| **redis.sentinel.failover**(count)                | number of failovers detected*Shown as occurrence*                           |

### Events{% #events %}

The Redis's Sentinel check does not include any events.

### Service Checks{% #service-checks %}

**redis.sentinel.master\_is\_down**

Returns `CRITICAL` if the master is down, returns `OK` otherwise.

*Statuses: ok, critical*

**redis.sentinel.master\_is\_disconnected**

Returns `CRITICAL` if the master is disconnected, returns `OK` otherwise.

*Statuses: ok, critical*

**redis.sentinel.slave\_master\_link\_down**

Returns `CRITICAL` if the master link is down, returns `OK` otherwise.

*Statuses: ok, critical*

**redis.sentinel.slave\_is\_disconnected**

Returns `CRITICAL` if the slave is disconnected, returns `OK` otherwise.

*Statuses: ok, critical*

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](http://docs.datadoghq.com/help).
