https://github.com/tumblr/memkeys

a top like tool for inspecting memcache key values in realtime
https://github.com/tumblr/memkeys

Last synced: 11 days ago
JSON representation

a top like tool for inspecting memcache key values in realtime

• Host: GitHub
• URL: https://github.com/tumblr/memkeys
• Owner: tumblr
• License: apache-2.0
• Fork: true (bmatheny/memkeys)
• Created: 2013-04-23T03:21:07.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-05-03T14:49:14.000Z (over 11 years ago)
• Last Synced: 2024-08-02T14:08:25.725Z (4 months ago)
• Language: C++
• Size: 400 KB
• Stars: 357
• Watchers: 43
• Forks: 14
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# memkeys

Show your memcache key usage in realtime.

This was originally inspired by [mctop](https://github.com/etsy/mctop) from etsy.

I found that under load mctop would drop between 50 and 75 percent of packets.

Under the same load memkeys will typically drop less than 3 percent of packets.

This is on a machine saturating a 1Gb network link.

## Command line options

    Usage: memkeys -i NIC [options]

        -d, --discard=THRESH        Discard keys where req/s rate is below THRESH

        -i, --interface=NIC         Network interface to capture traffic on (required)

        -p, --port=PORT             Network port to capture memcache traffic on (default 11211)

        -r, --refresh=INTERVAL      Refresh the stats display every INTERVAL ms (default 500)

        -l, --logfile=FILE          Output logs to FILE

        -R, --report=REPORT         Output data in REPORT format (CSV or curses, default curses)

        -h, --help                  This help

        -v, --verbose               Increase verbosity. May be used multiple times.

        -V, --version               Show program info and exit.

## Running

You will most likely want to run with something like:

    memkeys -i eth0 -l /tmp/memkeys.log

If you are running memkeys on a very high traffic machine you will want to

specify a discard threshold, otherwise the memory footprint will grow quite

large.

    memkeys -i eth0 -d 10.0 -l /tmp/memkeys.log

## Screenshot

![Screenshot](https://raw.github.com/wiki/bmatheny/memkeys/misc/screenshot.png)

## Development/Build

Install gperftools and gperftools-devel if you want to build with

`--enable-profiling`. You will typically want to configure with

`--enable-debug`, and possibly with `--enable-development`. The latter two

options will enable additional error logging.

You will need libpcap-devel, libpcrecpp, and libncurses-devel.

memkeys was developed on CentOS 5.8 with the following software tools:

    GCC version    : g++44 (GCC) 4.4.6 20110731 (Red Hat 4.4.6-3)

    GNU gmake      : 3.81

    ld             : 2.17.50.0.6-20

    coreutils      : 5.97

    libtool        : 2.4.2

    autoconf       : 2.68

    automake       : 1.9.6

The following library versions were used:

    libpcap-devel  : 0.9.4-15

    pcre-devel     : 6.6-6

    ncurses-devel  : 5.5-24.20060715

This should build fine against newer versions of the above tools. Different

libraries are untested.

# License

Copyright 2013 Tumblr.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use

this file except in compliance with the License. You may obtain a copy of the

License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed

under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR

CONDITIONS OF ANY KIND, either express or implied. See the License for the

specific language governing permissions and limitations under the License.