Plugin:Redis

Redis plugin
Type:	read
Callbacks:	config, read
Status:	supported
First version:	5.0
Copyright:	2010 Andrés J. Díaz
License:	GPLv2+
Manpage:	collectd.conf(5)
List of Plugins

The Redis plugin connects to one or more instances of Redis, a key-value store, and collects usage information using the credis library.

Synopsis

<Plugin redis>
  <Node "mynode">
    Host "localhost"
    Port "6379"
    Timeout 2000
  </Node>
</Plugin>

Example graphs

None yet. Add one now!

Dependencies

• credis, C library implementing the redis protocol. The credis library is lagging support for current redis, and requires at least the following patch:

--- ../credis_2/credis-0.2.3/credis.c   2010-08-27 01:57:25.000000000 -0700
+++ ../credis-0.2.3/credis.c    2014-01-28 22:39:42.000000000 -0800
@@ -754,7 +754,7 @@
    * first 1.1.0 release(?), e.g. stable releases 1.02 and 1.2.6 */
   if (cr_sendfandreceive(rhnd, CR_BULK, "INFO\r\n") == 0) {
     int items = sscanf(rhnd->reply.bulk,
-                       "redis_version:%d.%d.%d\r\n",
+                       "# Server\r\nredis_version:%d.%d.%d\r\n",
                        &(rhnd->version.major),
                        &(rhnd->version.minor),
                        &(rhnd->version.patch));

• see brief notes on configuring this under ubuntu 14.04 [1]

• the following tips are useful when testing and troubleshooting
• use redis-cli ping to ensure you can connect to redis itself.
• use credis-test to see if your compiled credis is able to talk to redis itself. If this fails, the collectd plugin will also not work.
• use redis-cli monitor & to see what redis is receiving and sending itself.
• use sudo ngrep -texd lo port 6379 to see raw traffic goin to/from redis on the loopback adapter. You may need to use eth0 or similar depending on your setup. This may show up more information on why certain credis commands do not get through to redis itself.

Finally, users comfortable with compiling their own versions from scratch may want to follow the hiredis alternative mentioned in current issues [2]

See also

• Redis project page on Google Project Hosting.
• Credis project page on Google Project Hosting.
• Plugin:exec-redis.sh