HAProxy のログ出力
この記事では、2010年当時の Ubuntu Lucid 環境での設定を紹介します。現在の Ubuntu 環境ではなく、当時のリリースのレガシーな rsyslog 設定と Upstart のサービスコマンドを使用しています。
Transloadit では、一つのポートで異なるサービスを提供するため、「信頼性と性能に優れた TCP/HTTP ロードバランサー」である HAProxy を使用しています。たとえば、ポート 80 へのリクエストを、ホスト名に応じて Node.js(api.transloadit.com の場合)または Nginx(www.transloadit.com の場合)に振り分けられます。HAProxy は期待どおりに働いてくれており、セットアップも簡単でした。しかし、Ubuntu Lucid で HAProxy のログを出力するのは、思った以上に大変でした。見つかったチュートリアルはどれも、ログ出力に触れていないか、非推奨の情報を載せているかのどちらかでした。突然、Google が頼りにならなくなってしまいました。
HAProxy のログ出力先
パフォーマンスと保守性の観点から、HAProxy はファイルに直接ログを出力しません。代わりに、syslog サーバーにログを送信する仕組みです。syslog サーバーは独立した Linux デーモンで、ほとんどのサーバーに標準で備わっています。ただし、HAProxy がログを送信するには UDP ポート 514 で待ち受ける必要があり、通常、この設定は有効になっていません。
syslog サーバーはログエントリーを受信し、必要なものを選別して、高度に最適化された方法でディスクに書き込みます。これらの動作はすべて、用途に合わせて設定できます。
現在の /etc/haproxy/haproxy.cfg ファイルの先頭を見ると、次のような設定があるかもしれません。
global
maxconn 10000
ulimit-n 65536
log 127.0.0.1 local0
log 127.0.0.1 local1 notice
このように、127.0.0.1 がログ送信先の syslog サーバーとして参照されます。Ubuntu Lucid のデフォルトの syslog デーモンは
rsyslogd なので、HAProxy のログエントリーを受け取れるように設定しましょう。
rsyslogd での HAProxy ログの受信
HAProxy のログ出力について Google で見つけた情報の大半は、/etc/default/rsyslog ファイルを変更するよう案内していました。しかし、新しい upstart システムでは、このファイルは完全に無視されます。さらに、HAProxy がこのデフォルトファイルに従うようにしても(実際に試しました)、rsyslogd は強制的に互換モードで動作することになります。これは残念なだけでなく、実は不要なことでもありました。
次の設定を使うと、
$ModLoad imudp
$UDPServerAddress 127.0.0.1
$UDPServerRun 514
rsyslogd はループバックインターフェースでのみ待ち受けます。認証のない syslog のリスナーをパブリックネットワークに公開しないでください。
これらの行をどこに記述すればよいのでしょうか。UDP の syslog ポートを HAProxy サービス専用に使っているなら、/etc/rsyslog.d/haproxy.conf ファイル一つにまとめて記述するか、該当する行のコメントを解除できます。
# .. otherwise consider putting these three in /etc/rsyslog.conf instead:
$ModLoad imudp
$UDPServerAddress 127.0.0.1
$UDPServerRun 514
# ..and in any case, put these two in /etc/rsyslog.d/haproxy.conf:
local0.* -/var/log/haproxy_0.log
local1.* -/var/log/haproxy_1.log
続いて、次を実行します。
restart rsyslog
これで完了です。次の場所で HAProxy のログを確認してください。
tail -f /var/log/haproxy*.log
/etc/haproxy/haproxy.cfg のデバッグレベルの調整もお忘れなく。
それでは、ログ出力を活用してください!
