Monitoring Redis

This guide helps you configure Monitoring to monitor Redis.

Redis is an open source advanced key-value store. It is often referred to as a data structure server since values can contain strings, hashes, lists, sets and sorted sets. For more information, visit redis.io.

Note: This functionality is only available for agents running on Linux. It is not available on Windows.

Discovery

Monitoring discovers Redis services running in your Cloud Platform project if you have the following:

• VM instances with redis in their names.
• Firewall rules that open port 6379.

The discovered services are displayed on the Redis Services page in the Resources menu of the Stackdriver Monitoring console.

After you install the monitoring agent and configure the Redis plugin on your instances, Monitoring populates the Redis Services page with inventory and metrics.

Configuring Redis monitoring

The Monitoring agent uses the hiredis client library to monitor Redis. After installing Redis, install hiredis by running the following commands:

• RHEL & CentOS 6

      curl -O "https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm"
      sudo rpm -Uvh "epel-release-latest-6.noarch.rpm"
      sudo yum install hiredis
  

• RHEL & CentOS 7

      curl -O "https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm"
      sudo rpm -Uvh "epel-release-latest-7.noarch.rpm"
      sudo yum install hiredis
  

• Ubuntu 16.04 LTS & Debian 9

      sudo apt-get install libhiredis0.13
  

• Other Debian & Ubuntu

      sudo apt-get install libhiredis0.10
  

Configuring Monitoring

To monitor Redis, perform the following actions on your VM instance after installing the monitoring agent:

1. Install the Redis configuration file, redis.conf, by running the following command:

   (cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/redis.conf)
   

   If you are using a nonstandard host or port for Redis, as root, edit redis.conf by following the instructions at the top of the file.

2. Restart the monitoring agent by running the following command:

   sudo service stackdriver-agent restart
   

For more information on the collectd redis plugin, see Plugin:Redis.

Redis metrics

The full list of metrics the Redis plugin monitors is at Agent metrics: redis. The actual metrics collected, and the metrics available in the Monitoring menus, can vary.