Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A heap inspector for live memcached instances.
Ruby
branch: master
Failed to load latest commit information.
bin Memcached 1.4.5 compatibility
ext Memcached 1.4.5 compatibility
lib Memcached 1.4.5 compatibility
CHANGELOG changelog
LICENSE Licensed.
Manifest Rdoc README extension to please Github
README.rdoc Rdoc README extension to please Github
Rakefile

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
  ...
Something went wrong with that request. Please try again.