fauna / peep
watch download tarball
public
Forks0Right
Watchers60Right
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 / README
100644 56 lines (34 sloc) 1.984 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

 
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
    ...