memcached-toolの使い方

以前も調べた記憶がありつつも毎回忘れるのでメモ
memcachedにはアクセスするための「memcached-tool」という便利ツールが存在する
バージョンによって表示内容が少し異なりますが、新しいバージョンの「memcached-tool」でも
古いバージョンのmemcachedに対して利用可能

公式のソース


https://github.com/memcached/memcached/blob/master/scripts/memcached-tool

オプション

display スラブの一覧と使用状況の表示
dump データのダンプ
stats memcachedの統計データの表示

※オプションを省略するとdisplayとなる

displayオプション
「stats items」コマンドと「stats slabs」コマンドの結果を整形して表示

実行例(memcached 1.4.7)


$ ./memcached-tool localhost:11211
# Item_Size Max_age Pages Count Full? Evicted Evict_Time OOM
2 136B 0s 1 0 no 0 0 0
3 176B 21s 1 1 no 0 0 0
4 224B 31343567s 18 50143 no 0 0 0
5 280B 31343567s 21 54252 no 0 0 0
6 352B 1535s 2 8 no 0 0 0
7 440B 1535s 1 3 no 0 0 0
8 552B 1535s 1 3 no 0 0 0

表示項目

表示項目 コマンド コマンド項目 内容
# スラブ番号
Item_Size stats slabs chunk_size チャンクのサイズ
Max_age stats items age スラブの中でもっとも古いデータの期間(有効期限切れもカウントされる)
1MB_pages stats slabs total_pages スラブに割り当てられたページ数
Count stats items number スラブ内のレコード数(有効期限切れもカウントされる)
Full? stats slabs free_chunks_end 空きチャンクの有無
Evicted stats items evicted 有効期限切れ前に削除された数
Evict_Time stats items evicted_time 最後の追い出しからの期間(memcached 1.4〜)直近でevictされたアイテムについての、最終アクセスからの経過秒
OOM stats items outofmemory 値をスラブに格納できなかった数(-Mオプション指定時のみ)

statsオプション
「stats」コマンドの結果を表示
「stats」コマンドの表示については過去記事に記載


dumpオプション
memcached内の全データをダンプ

書式


Dumping memcache contents
Number of buckets:
Number of items :
Dumping bucket - total items
add

表示項目

slab total num データが保存されているスラブの数
chunk total num データが保存されているチャンクの数
slab num スラブ番号
chunk num チャンクの数
key キー値
flags データ保存時の指定フラグ
exptime データの有効期限(unix time)
bytes データのバイト数
data block データ

実行例


$ ./memcached-tool localhost:11211 dump
Dumping memcache contents
Number of buckets: 1
Number of items : 2
Dumping bucket 1 - 2 total items
add hoge2 0 1314542107 10
1234567890
add hoge1 0 1314542107 4
test