public
Description: A heap inspector for live memcached instances.
Homepage: http://blog.evanweaver.com/files/doc/fauna/peep/
Clone URL: git://github.com/fauna/peep.git
peep /
name age message
file CHANGELOG Mon Apr 20 10:35:49 -0700 2009 Memcached 1.2.8 compatibility. [Evan Weaver]
file LICENSE Mon Nov 10 02:52:47 -0800 2008 Licensed. [Evan Weaver]
file Manifest Sun Oct 26 07:25:12 -0700 2008 Manifest. [Evan Weaver]
file README Mon Apr 20 10:35:49 -0700 2009 Memcached 1.2.8 compatibility. [Evan Weaver]
file Rakefile Sun Oct 26 07:43:53 -0700 2008 Readme. [Evan Weaver]
directory bin/ Mon Nov 10 02:52:47 -0800 2008 Licensed. [Evan Weaver]
directory ext/ Mon Apr 20 10:35:49 -0700 2009 Memcached 1.2.8 compatibility. [Evan Weaver]
directory lib/ Mon Nov 10 02:52:47 -0800 2008 Licensed. [Evan Weaver]
README
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}[http://www.danga.com/memcached/] compiled with debugging symbols:

  CFLAGS='-g' ./configure --enable-threads
  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
    ...