6. APPENDER4

Log4J 6章　APPENDER4

6.1. org.apache.log4j.net.TelnetAppender クラス

6.1. org.apache.log4j.net.TelnetAppender クラス

TelnetAppender は読み出し専用のソケットにログを書き込むクラスです。telnet を利用してログを監視するというように、TCP/IP越しにリモートサーバのログ出力をモニタリングすることが容易に行えるようになります。特にサーブレットの動作を監視するときには非常に便利です。

 1: TelnetAppender()

上記コンストラクタで、TelnetAppender オブジェクトを生成したら、各種パラメータをセットします。

TelnetAppender は Layout オブジェクトを必要としますので、setLayout( ) メソッドで Layout をセットします。また、ログをどのポートに出力するのかを、setPort( ) メソッドで指定します。これを使用しない場合は、デフォルトで 23がセットされます。しかし、一般的に Telnet 利用可能なサーバの場合、23番ポートは既に使用中であることから、ここで明示的にポートを使用しないと、この appender を使用しようとした時点で例外が発生します。ですので、他に使用中でないポート番号を明示的に使用する事をお勧めします。

各種パラメータの設定が終わったら、activateOption( ) メソッドで各種設定を有効にします。下記クラスを実行すると、実行されているサーバの9999番ポートをtelnetでアクセスすると、ログの出力を確認することができます。

 1: import org.apache.log4j.*;
 2: import org.apache.log4j.net.TelnetAppender;
 3: 
 4: public TelnetAppenderSample{
 5:
 6:     public static void main(String args[]){
 7:
 8:         Logger logger=Logger.getLogger("sample");
 9:         logger.setLevel(Level.WARN);
10:
11:         PatternLayout layout=new PatternLayout();
12:         layout.setConversionPattern(PatternLayout.DEFAULT_CONVERSION_PATTERN);
13:
14:         TelnetAppender appender=new TelnetAppender();
15:         appender.setPort(9999);
16:         appender.setLayout(layout);
17:         appender.activateOptions();
18:         logger.addAppender(appender);
19:         while(true){
20:             logger.info("--- info! ---");
21:             logger.warn("--- warn! ---");
22:             logger.error("--- error! ---");
23:         }
24:     }
25: }

設定ファイルを使用する場合の書き方の例を以下に示します。

 1: # sampleLogger
 2: log4j.logger.sampleLogger=WARN,A9
 3:
 4: log4j.appender.A9=org.apache.log4j.net.TelnetAppender
 5: log4j.appender.A9.port=9999
 6: log4j.appender.A9.layout=org.apache.log4j.PatternLayout
 7: log4j.appender.A9.layout.ConversionPattern=%d [%t] %-5p %c - %m%n