anemoeater

anemo eat erは box/Anemometer をdockerコンテナーとして起動して、percona-toolkitのpt-query-digestの結果を食わせるためのラッパースクリプトです。

注意

• pt-query-digestの仕様変更により、percona-toolkit 3.0.11とそれ以降のpt-query-digestでは本家 box/Anemometer が動きません。 --pt-query-digest=/path/to/pt-query-digest で3.0.10とそれ以前のpt-query-digestを指定するか、 --use-docker-for-pt でコンテナ版のpt-query-digestを使うようにしてください。
  • pt-query-digest 3.0.11 changed `checksum` from BIGINT UNSIGNED to CHAR(32) · Issue #200 · box/Anemometer
  • box/Anemometer 本家が直してくれれば一番いいんですが…はてさて。

クイックスタート

• dockerとpercona-toolkitがインストールされている必要があります。

$ git clone https://github.com/yoku0825/anemoeater
$ cd anemoeater
$ cpanm --installdeps .
$ ./anemoeater path_to_slow_log

• オプションなしの起動では、yoku0825/anemoeaterをdocker runします。
• スローログを分割しながらpt-query-digestに食わせます。分割して渡さないとpt-query-digestが(checksum, ts_min, ts_max)という粒度で集計してしまうため、一括で食わせた場合に綺麗なグラフにならないからです（ts_minの時刻にクエリーが集中してプロットされてしまう）
• anemoeaterの起動後にブラウザーからアクセスするためのURLをペロっと吐きます。コンテナーの80番がEXPOSEされてるだけです。
• --sinceと--untilを指定して（ログが多いと重い）スローログを食わせてブラウザで見てコンテナーを止める、みたいな使い方を想定しています。

何故anemo eat erが必要だったのか

• pt-query-digestはスローログをパースする際に時間の情報を「クエリーが最初に記録された時間からクエリーが最後に記録された時間」に集計してしまうからです。
• それを考慮せずにそのままAnemometerに食わせるとこうなります。Anemometerは時間軸に対してts_minの点でプロットするため、そのクエリーが最初に記録された時刻にいっぱい出たことになってしまいます。

• なのでanemo eat erの中でスローログを分割し、(ts_min, ts_max)が綺麗に分かれるようにpt-query-digestを呼び出してAnemometerにインポートさせています。

• あとはAnemometerを使い捨てる（見たくなったら起動、見終わったら破棄）ためにDockerを使っていましたが、毎回インポートするのが面倒になったからです。

オプション

引数

• スローログファイルを渡します。複数指定可能。
• スローログファイルの名前がAnemometer上のhostname_maxになります（Filter By Hostとかで使うやつ）