「Open棟梁 wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。
lon4netでは、3つの主要なコンポーネント
の設定を定義ファイルに定義できる。
アペンダ・ロガーについては、以下が参考になる。
アペンダが出力するログのフォーマットを定義する。
アペンダには以下のような種類がある。
定義ファイルでレイアウト(Layout)を定義することにより、
アペンダ(Appender)毎、ログ ヘッダを設定できる。
(例)
↓時間 ↓レベル ↓スレッドID ↓メッセージ [2007/10/25 15:22:21,750], [DEBUG], [9], 任意のメッセージ
定義ファイルでロガー(Logger)を定義することにより、
出力するログ レベルのフィルタを設定できる。
ログ レベルには次の5つのレベルがあり、
ロガー(Logger)のログ出力APIを使い分ける。
| レベル | 説明 |
| Fatal | システム停止するような致命的な障害 |
| Error | システム停止はしないが、問題となる障害 |
| Warn | 障害ではない注意警告 |
| Info | 操作ログなどの情報 |
| Debug | 開発用のデバッグメッセージ |
ログの種類毎に主要コンポーネント(ロガー、アペンダ、レイアウト)を準備
デバッグや、パフォーマンス・アクセス分析で重宝する。
下記は、アクセス トレース ログ出力のテンプレート・フォーマット。
SQLに絞ってになるが、アクセス トレース ログと同様に、
デバッグや、パフォーマンス・アクセス分析で重宝する。
下記は、SQLトレース ログ出力のテンプレート・フォーマット。
業務のイベントをログ出力する。
アプリケーション側で規定する。
<!-- ローリング・ログファイル出力用アペンダ -->
<appender name="ACCESS" type="log4net.Appender.RollingFileAppender">
<param name="File" value="C:\root\files\resource\Log\ACCESS" />
<!-- ローリングの設定 -->
<param name="StaticLogFileName" value="false" />
<param name="RollingStyle" value="date " />
<param name="DatePattern" value='"."yyyy-MM-dd".log"' />
<!-- 書き込み時の設定(追加 or 上書き、出力エンコーディング) -->
<param name="AppendToFile" value="true" />
<encoding value="utf-8" />
<!-- メッセージのフォーマット -->
<layout type="log4net.Layout.PatternLayout">
<param name="ConversionPattern" value="[%date{yyyy/MM/dd HH:mm:ss,fff}],[%-5level],[%thread],%message%newline" />
</layout>
<!-- フィルタ(範囲)の設定 -->
<filter type="log4net.Filter.LevelRangeFilter">
<levelMin value="DEBUG" />
<levelMax value="FATAL" />
</filter>
</appender>
指定のサイズを超えている場合にローリングを行う。
ファイル サイズは必ず、この設定値未満になるわけではない。
<!-- ローリングの設定--> <param name="StaticLogFileName" value="true" /> <param name="RollingStyle" value="size" /> <param name="MaximumFileSize" value="10MB" /> <param name="MaxSizeRollBackups" value="2" /> <param name="CountDirection" value="-1" />
サイズ10MB(MaximumFileSize?)毎にローリングし、
下記のように、2つ(MaxSizeRollBackups?)のバックアップを保持する 。
付与される番号の順番は、CountDirection?パラメタ値により制御する。
<!-- ローリングの設定 --> <param name="StaticLogFileName" value="false" /> <param name="RollingStyle" value="composite" /> <param name="DatePattern" value='"."yyyy"-"MM"-"dd".log"' /> <param name="MaximumFileSize" value="10MB" /> <param name="MaxSizeRollBackups" value="10" /> <param name="CountDirection" value="-1" />
設定の詳細は、”Open棟梁”の利用ガイド(纏め者編)の1.3節:「log4net」を参照のこと。