Redis Sentinel

Supported OS Linux Windows

Integrationv1.1.0

Overview

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

  • Visualize and monitor sentinels states
  • Be notified about failovers

Setup

The Redis Sentinel check is not included in the Datadog Agent package, so you need to install it.

Installation

For Agent v7.21+ / v6.21+, follow the instructions below to install the Redis Sentinel check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.

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

    datadog-agent integration install -t datadog-redis_sentinel==<INTEGRATION_VERSION>
    
  2. Configure your integration similar to core integrations.

Configuration

  1. Edit the redis_sentinel.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Redis Sentinel metrics. See the sample upsc.d/conf.yaml for all available configuration options.

  2. Restart the Agent

Validation

Run the Agent’s status subcommand and look for redis_sentinel under the Checks section.

Data Collected

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

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

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

Need help? Contact Datadog support.