README.rdoc

peep

A heap inspector for live memcached instances.

License¶ ↑

Copyright 2009 Cloudburst, LLC. Licensed under the AFL 3. See the included LICENSE file.

Features¶ ↑

• it works

Installation¶ ↑

x86 Linux is required.

You need memcached compiled with debugging symbols:

CFLAGS='-g' ./configure 
make
sudo make install

Now install the gem:

sudo gem install peep -- --with-memcached-include=/path/to/memcached/source

Usage¶ ↑

Find the pid of a live memcached server. Then run:

peep --pretty $pid

or

peep --ugly $pid

Please note that memcached is fully blocked while peep is running.

Peep is also usable as a library, for statistics gathering or deeper inspection.

Sample output¶ ↑

eweaver@ubuntu:~$ peep 32589
  time | exptime | nbytes | nsuffix | it_f | clsid | nkey |                                    key | exprd | flushd
  8658 |  613458 |    272 |       8 | link |     5 |   31 |      "element2-benchmark:c3RhdH:171:5" | false |  false
  8658 |       0 |      6 |       6 | link |     1 |   35 |  "element2-benchmark:current_c3RhdH:3" | false |  false
  8658 |  613458 |    281 |       8 | link |     5 |   32 |     "element2-benchmark:c3RhdH:171:26" | false |  false
  8678 |   95078 |      6 |       6 | link |     1 |   35 |  "element2-benchmark:User:1:auth:m4Uq" | false |  false
  8658 |       0 |      8 |       6 | link |     2 |   34 |   "element2-benchmark:user_dGltZWxp:4" | false |  false
  8686 |  613486 |   1278 |       9 | link |     9 |   27 |          "element2-benchmark:User:1:6" | false |  false
  8658 |  613458 |   1286 |       9 | link |     9 |   27 |          "element2-benchmark:User:1:4" | false |  false
  8658 |  613458 |    283 |       8 | link |     5 |   32 |     "element2-benchmark:c3RhdH:171:28" | false |  false
  8658 |  613458 |    277 |       8 | link |     5 |   32 |     "element2-benchmark:c3RhdH:171:30" | false |  false
  ...