4.3 出力する書式
出力する書式
encoder でログ出力時の書式を設定することができます。設定できる項目には以下の項目があります。
項目 | 説明 |
---|---|
c{length} lo{length} logger{length} |
出力するロガーの文字列の長さを設定します。 |
C{length} class{length} |
出力するクラスの文字列の長さを設定します。 |
d{pattern} date{pattern} |
イベントの発生した日時の出力書式を指定します。 JavaのSimpleDateFormatに対応しています。 また、ISO8601フォーマットも使用することができます。 |
F / file | ログのリクエストが発生したJavaのソースの場所を出力します。 この項目の出力は実行速度の低下を招くので、必要ない限り設定をしないでください。 |
caller{depth} caller{depth, evaluator-1, ... evaluator-n} |
ログイベントの発生した階層をどの段階まで出力するかの設定をします。 |
L / line | ログリクエストが発生した行数を出力します。 この項目の出力は実行速度の低下を招くので、必要ない限り設定をしないでください。 |
m / msg / message | アプリケーションが出力するメッセージを出力します。 |
M / method | ログリクエストが発生したメソッド名を出力します。 この項目の出力は実行速度の低下を招くので、必要ない限り設定をしないでください。 |
n | 改行の出力形式を設定します。 |
p / le / level | ログイベントのレベルを出力します。 |
r / relative | アプリケーションが起動してからイベントが発生したタイミングまでの時間をミリ秒で出力します。 |
t / thread | ログイベントを生成したスレッドの名前を出力します。 |
ex{length} exception{length} throwable{length} ex{length, evaluator-1, ..., evaluator-n} exception{length, evaluator-1, ..., evaluator-n} throwable{length, evaluator-1, ..., evaluator-n} |
例外が発生した際のスタックトレースを出力します。 lengthには以下のオプションがあります。 short: スタックトレースを1行出力します。 full: スタックトレースを全行出力します。 Any integer: スタックトレースを指定行数出力します。 evaluatorではどこで例外が発生したときにログを出力するかを指定します。 |
nopex nopexception |
例外を無視します。 |
marker | マーカーを出力します。 |
ログの文字数の設定
出力するログの文字数を細かく設定できます。
出力されたログを固定長のデータとして利用するときに便利です。
書式 | 左余白 | 最小幅 | 最大幅 | 説明 |
---|---|---|---|---|
%20logger | false | 20 | none | ロガーの名前が20文字以下のときに左から足りない文字数分スペースを挿入します。 |
%-20logger | true | 20 | none | ロガーの名前が20文字以下のときに右から足りない文字数分スペースを挿入します。 |
%.30logger | NA ※1 |
none ※2 |
30 | ロガーの名前が30文字より長いときに先頭から30文字を超える分を切り捨てます。 |
%20.30logger | false | 20 | 30 | ロガーの名前が20文字以下のときに左から足りない文字数分スペースを挿入します。ロガーの名前が30文字より長いときは先頭から30文字を超える分を切り捨てます。 |
%-20.30logger | true | 20 | 30 | ロガーの名前が20文字以下のときに右から足りない文字数分スペースを挿入します。ロガーの名前が30文字より長いときは先頭から30文字を超える分を切り捨てます。 |
%.-30logger | NA | none | 30 | ロガーの名前が30文字より長いときは後ろから30文字を超える分を切り捨てます。 |
- ※1NA: not available(該当無し)
- ※2none:設定しません
<encoder> <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern> </encoder>