Java/Jakarta/Log4j の履歴(No.1)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• Java/Jakarta/Log4j へ行く。
  • 1 (2018-10-25 (木) 07:52:41)

---

• JDK標準のロギングよりはるかに使われているライブラリ

インストール†

Log4jを理解する3つのキーワード†

• Categories

出力範囲と出力レベルを設定できます。

• Appenders

出力先を指定できます。マニュアルを見ると、

• Layouts

出力情報とレイアウトをカスタマイズ

設定ファイル†

設定ファイルの場所を指定する†

クラスパスの順番とか、クラスパスが通ってないとかそんなことに悩まされる必要がなくなるので指定するのがお勧め。初期化の段階で以下のコードを入れておく

PropertyConfigurator.configure(propertyFileName)

• 起動オプションで設定するやり方もある

java -Dlog4j.configuration=file:///home/foo/log4j.properties 実行クラス

DEBUGレベルと、ERROR以上でログを分ける†

バッチ処理でDEBUGログはコンソールに出す必要がないがシステムエラー系はコンソールに出しておきたいケースがあった。探しても探しても見つからなく、挫折しかけた頃にようやく見つけた。Thresholdパラメータがポイント

log4j.rootCategory=DEBUG,FILE,STDOUT
# 
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.Threshold=DEBUG
log4j.appender.FILE.File=debug.log
log4j.appender.FILE.Append=true
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d %c %m%n
# 
log4j.appender.STDOUT=org.apache.log4j.ConsoleAppender
log4j.appender.STDOUT.Threshold=INFO
log4j.appender.STDOUT.layout=org.apache.log4j.PatternLayout
log4j.appender.STDOUT.layout.ConversionPattern=%c %m%n

レイアウト†

暗号みたいなレイアウトの記号を解説

• 以下は呼び出しクラスなど詳細な情報でデバッグには役立つがパフォーマンスとトレードオフなので本番運用時ははずすこと。

このままだと出力文字列の長さがまちまちになるのでフォーマットをかますのが一般的。最初からフォーマットをいれてしまうとまさに暗号なので、まずは上記レイアウト項目が出力されるのを確認してからフォーマットの設定を入れるのがよい。

Log4j 逆引き†

出力するログレベルを制御したい†

Thresholdを使う。

• INFO以上出力

log4j.appender.STDOUT.Threshold=INFO

サンプルソース†

etc†

パフォーマンス†

ファイルに書き込む時は同時書き込みでファイルを壊さないようにロック待ちが発生する。数百人が同時にアクセスするようなシステムではパフォーマンスに大きな影響が出る可能性があるのでログ設計は慎重にやる必要がある。なんでもdebug出力はよろしくない。