serf-munin.pl¹を書いた時にハマったこと。

複数タグを登録すると、カンマ区切りのkey=valueになる

serfの基本的な動作を試してみた時に知ったことです。 これはドキュメントにもそれとなく書いてあるので、ハマるという程のことは無かったのですが、なんとも言えない挙動があるのでメモしておきます。

例えば以下のように、role=appとdatacenter=tokyoという2つのタグを設定します。

{
 "tags": {
   "role": "app",
   "datacenter": "tokyo"
 }
}

すると、serfは1つのイベントハンドラ発行時に、次のようなタブ区切りの一行を標準入力に送ります。

foo.com   192.168.100.1   app    role=app,datacenter=tokyo

$tagsをパースしたい場合は、

1. 標準入力から得たフィールドを\tで区切り、4番目の値を取得する
2. カンマ,でsplitして、key=valueが入った配列を取得する
3. イコール=で区切り、ハッシュを取得する ($tags{'role'} = appと$tags{'datacenter'} = tokyo)

のような手順が必要です（イベントハンドラの目的が単一的であれば、ハッシュの取得は不要かも）。

tagsの並び順の罠

ここで注意したいのは、必ずしも$tagsの並び順は固定ではないこと です。 role=app,datecenter=tokyoだったりdatecenter=tokyo,role=appだったり、alphabeticalでもなく、ランダムっぽい挙動です（serf membersコマンドを打つ度に結果が変わる。）

複数のイベントが一度に発行されると、複数行にわたって情報がイベントハンドラに渡される

複数のserfからイベントを発行すると、serfはイベントハンドラ²に対して 複数行でメンバの情報を送ります 。 送り先は標準入力です。

foo.com   192.168.100.1   app    role=app
bar.com   192.168.100.2   db     role=db
baz.com   192.168.100.3   mail   role=mail

なので、serfからmember-joinやmember-leave等の情報が送られてきた際に、取りこぼしの無いようにメンバの情報を取得するには、例えば以下のような処理が必要です。

# 複数行にわたって送られる可能性があるのでwhileでぐるぐる回す
while (<STDIN>) {
   chomp;

   # 各フィールドはタブ区切り
   my @member_fields = split("\t", $_);

   # ちゃんと4つのフィールドに別れてないと駄目（必須では無いけどバリデーションしておいた方が良いと思う）
   die "fields must include 4 elements" unless @member_fields == 4;

   # name, address, role, tagsの順で用意されてる
   my ($name, $address, $role, $tags) = @member_fields;

   # 以降、処理が続く
   ...
}

最初、イベントハンドラは各イベントに対して毎回呼び出されるものと思い込んでいたのですが、どうやらバッファリングしているらしく、同時多発的にイベントが発行された場合はイベント情報を複数行で送る実装になっているようです（ちゃんと実装を読んでいないので、半分くらいは想像ですが。）

• https://github.com/hashicorp/serf/blob/master/serf/config.go