Log 4 j公式ドキュメント翻訳(三、構成)
3678 ワード
前の章ではlog 4 jのコアコンポーネントについて説明しましたが、本章ではプロファイルを通じてコア構築の構成について説明します.
主にプロファイルにlog 4 jのログレベルを構成し、appender、layoutなどを定義します.
log4j.propertiesはlog 4 jのプロファイルであり、キー値ペアで定義されます.
デフォルトでは、logManagerオブジェクトはCLASSSPATHディレクトリでlog 4 jを探す.properties.
まず基本的な構成テンプレートを見てみましょう
このプロファイルが何をしているか見てみましょう.まずログのレベルはDEBUGで、またappenderが追加されました.名前はXです. appenderの名前をXとする、そのappenderの実装をorgとする.apache.log4j.FileAppender、すなわちファイル読み書き方式 Xに表示を設定する方法——layout 実際のサンプル
上のプロファイルはまた何をしましたか?ログのrootレベルはDEBUG、DEBUGのappender名はFILEです. FILEの実現をorgとする.apache.log4j.FileAppenderは、ログディレクトリにログ情報を書き込むlogと呼ばれます.outのファイル. layoutのフォーマットは%m%nと定義され、各ログが改行文字に従うことを意味します.
log 4 jはUNIXスタイルの変数参照をサポートしています.たとえば${variableName}
Appenders
log 4 jは、コンソール、ファイル、システムイベントログなど、異なる宛先にログメッセージを出力するための複数のAppenderオブジェクトを提供する.各appenderオブジェクトには、オブジェクトの動作を定義する異なる構成プロパティがあります. layout appenderこのlayoutオブジェクトを使用してログ情報を変換するフォーマット targetターゲットは、コンソール、ファイル、または他のappender に依存する可能性があります. levelフィルタログのレベルを設定するための threshhold appenderは、ログのレベルに関係するしきい値を設定できます.ログは、レベルを下回るすべてのログ を無視します. filterフィルタオブジェクトは、ログ情報を分析し、あるappenderによってログ要求が処理されるか、または が破棄されるかを決定することができる.
loggerにappenderを追加するには、次のようにします.
もちろんXMLでは、次のようにすることもできます.
プログラムにappenderを追加する場合は、次の方法を呼び出すことができます.
このaddAppender()メソッドはloggerオブジェクトにappenderを追加します.
例に示すように、複数のappenderを同時に構成することができ、各ログは独立して異なる宛先に送信されません.
上にはFileAppenderの使い方しか示されていません.log 4 jには次のappenderがあります. AppenderSkeleton AysncAppender ConsoleAppender DailyRollingFileAppender ExternallyRolledFileAppender FileAppender JDBCAppender JMSAppender LF5Appender NTEventLogAppender NullAppender RollingFileAppender SMTPAppender SocketAppender SocketHubAppender SyslogAppender TelnetAppender WriterAppender
layout
上にはPatternLayoutが使用されていますが、下には他のオプションがあります. DateLayout HTMLLayout PatternLayout SimpleLayout XMLLayout
異なるappendersとlayoutの使い方は、その後徐々に更新されます.
主にプロファイルにlog 4 jのログレベルを構成し、appender、layoutなどを定義します.
log4j.propertiesはlog 4 jのプロファイルであり、キー値ペアで定義されます.
デフォルトでは、logManagerオブジェクトはCLASSSPATHディレクトリでlog 4 jを探す.properties.
まず基本的な構成テンプレートを見てみましょう
# Define the root logger with appender X
log4j.rootLogger = DEBUG, X
# Set the appender named X to be a File appender
log4j.appender.X=org.apache.log4j.FileAppender
# Define the layout for X appender
log4j.appender.X.layout=org.apache.log4j.PatternLayout
log4j.appender.X.layout.conversionPattern=%m%n
このプロファイルが何をしているか見てみましょう.
# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE
# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out
# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n
上のプロファイルはまた何をしましたか?
log 4 jはUNIXスタイルの変数参照をサポートしています.たとえば${variableName}
Appenders
log 4 jは、コンソール、ファイル、システムイベントログなど、異なる宛先にログメッセージを出力するための複数のAppenderオブジェクトを提供する.各appenderオブジェクトには、オブジェクトの動作を定義する異なる構成プロパティがあります.
loggerにappenderを追加するには、次のようにします.
log4j.logger.[logger-name]=level, appender1,appender..n
もちろんXMLでは、次のようにすることもできます.
<logger name="com.apress.logging.log4j" additivity="false">
<appender-ref ref="appender1"/>
<appender-ref ref="appender2"/>
</logger>
プログラムにappenderを追加する場合は、次の方法を呼び出すことができます.
public void addAppender(Appender appender);
このaddAppender()メソッドはloggerオブジェクトにappenderを追加します.
例に示すように、複数のappenderを同時に構成することができ、各ログは独立して異なる宛先に送信されません.
上にはFileAppenderの使い方しか示されていません.log 4 jには次のappenderがあります.
layout
上にはPatternLayoutが使用されていますが、下には他のオプションがあります.
異なるappendersとlayoutの使い方は、その後徐々に更新されます.