Jakarta log4j.xml に設定するログレベルの整理

最新推荐文章于 2020-07-10 18:14:51 发布

westkingwy

最新推荐文章于 2020-07-10 18:14:51 发布

阅读量1.5k

点赞数

分类专栏： JAVA Apache参照文章标签： log4j class encoding dependencies import layout

JAVA 同时被 2 个专栏收录

85 篇文章 0 订阅

订阅专栏

Apache参照

8 篇文章 0 订阅

订阅专栏

はじめに †

log4j.xml のログレベルの関係がよく分からないので調べてみる。次の３つで制御されるが、それぞれの関係は？
1. appender の <param name="threshold" value="debug"/>
2. category の <priority value="debug" />
3. root の <priority value="info" />
結局こうなる
- category と root は、影響し合わない
- 実際に出力されるログレベルは、
  - root と appender で指定したログレベルの内、どちらか厳しいもの
  - category と appender で指定したログレベルの内、どちらか厳しいもの
いろいろ面倒なので、基本的に root は使わず、category のみにしたほうがいいかも
- アプリケーションではなく、ライブラリからのログも混じってしまう
- 微妙に挙動がおかしくなる・・・

↑

検証アプリケーション †

↑

プロジェクトの構成 †

↑

Log4jExamApplication? †

 
 
 
 
 
 
 
-
|
|
|
|
|
|
-
|
|
|
|
|
|
|
|
|
|
|
!
|
!

package com.snail.exam.log4j;
 
import org.apache.log4j.Logger;
 
import com.snail.exam.log4j.buggy.BuggyClass;
import com.snail.exam.log4j.gentle.GentleClass;
 
public class Log4jExamApplication {
  
  private static Logger logger = Logger.getLogger(Log4jExamApplication.class);
 
  /**
   * @param args
   */
  public static void main(String[] args) {
    logger.fatal("本当にやばいログ　　");
    logger.error("普通にやばいログ　　");
    logger.warn( "ちょっとやばいログ　");
    logger.info( "運用時に必要なログ　");
    logger.debug("開発時に必要なログ　");
    logger.trace("デスマ時に必要なログ");
    
    new BuggyClass().doSomething();
    
    new GentleClass().doSomething();
 
  }
 
}

↑

BuggyClass? †

 
 
 
 
-
|
|
|
|
|
|
-
|
|
|
|
|
|
!
|
!

package com.snail.exam.log4j.buggy;
 
import org.apache.log4j.Logger;
 
public class BuggyClass {
  
  private static Logger logger = Logger.getLogger(BuggyClass.class);
 
  /**
   * @param args
   */
  public void doSomething() {
    logger.fatal("本当にやばいログ　　");
    logger.error("普通にやばいログ　　");
    logger.warn( "ちょっとやばいログ　");
    logger.info( "運用時に必要なログ　");
    logger.debug("開発時に必要なログ　");
    logger.trace("デスマ時に必要なログ");
  }
 
}

↑

GentleClass? †

 
 
 
 
-
|
|
|
|
|
|
-
|
|
|
|
|
|
!
|
!

package com.snail.exam.log4j.gentle;
 
import org.apache.log4j.Logger;
 
public class GentleClass {
  
  private static Logger logger = Logger.getLogger(GentleClass.class);
 
  /**
   * @param args
   */
  public void doSomething() {
    logger.fatal("本当にやばいログ　　");
    logger.error("普通にやばいログ　　");
    logger.warn( "ちょっとやばいログ　");
    logger.info( "運用時に必要なログ　");
    logger.debug("開発時に必要なログ　");
    logger.trace("デスマ時に必要なログ");
  }
 
}

↑

実行結果 †

↑

実行結果１ †

運用時に良くある log4j.xml。基本的に info 以上を出力し、どうもおかしい振る舞いをするパッケージは、debug 以上を出力する。

↑

log4j.xml †

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>
  
  <!-- ********************** 標準出力への出力 ********************** -->
  <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
    <param name="threshold" value="info"/>
  
    <!-- レイアウトの指定 -->
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern"
             value="RUNTIME [%x%-5p] %-10.10m @ %c%n" />
    </layout>
  </appender>
  
  <!-- ********************** ファイルへの出力 ********************** -->
  <appender name="FILE" class="org.apache.log4j.DailyRollingFileAppender">
    <param name="threshold" value="debug"/>
  
    <!-- ファイル情報 -->
    <param name="file" value="C:\\Users\\kagyuu\\Documents\\logtest.txt" />
    
    <param name="append" value="false" />
    <param name="datePattern" value="'.'yyyy-MM-dd" />
    
    <!-- レイアウトの指定 -->
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern"
             value="DEBUG [%x%-5p] %-10.10m @ %c%n" />
    </layout>
  </appender>
 
  <!-- ********************** category定義 ************************* -->
  <category name="com.snail.exam.log4j.buggy">
    <priority value="debug" />
    <appender-ref ref="FILE" />
  </category>
 
  <!-- ********************** root定義 ***************************** -->
  <root>
    <priority value="debug" />
    <appender-ref ref="STDOUT" />
  </root>
   
</log4j:configuration>

↑

出力 †

STDOUT

RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [INFO ] 運用時に必要なログ　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [INFO ] 運用時に必要なログ　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.gentle.GentleClass
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.gentle.GentleClass
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.gentle.GentleClass
RUNTIME [INFO ] 運用時に必要なログ　 @ com.snail.exam.log4j.gentle.GentleClass

FILE(C:\Users\kagyuu\Documents\logtest.txt)

DEBUG [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [INFO ] 運用時に必要なログ　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [DEBUG] 開発時に必要なログ　 @ com.snail.exam.log4j.buggy.BuggyClass

↑

フィルタリングの概要 †

root
- root で info 未満は切り捨てられて、
- appender では debug 未満を切り捨てるから、
- 結局 info 以上が出力される
category
- category で、BuggyClass? 以外、debug 未満は切り捨てられて、
- appender では debug 未満を切り捨てるから、
- 結局 BuggyClass? の debug 以上が出力される

↑

実行結果2 †

やや変則的な log4j.xml (log4j.xml の振る舞いを確かめるための log4j.xml )。

↑

log4j.xml †

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>
  
  <!-- ********************** 標準出力への出力 ********************** -->
  <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
    <param name="threshold" value="warn"/>
  
    <!-- レイアウトの指定 -->
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern"
             value="RUNTIME [%x%-5p] %-10.10m @ %c%n" />
    </layout>
  </appender>
  
  <!-- ********************** ファイルへの出力 ********************** -->
  <appender name="FILE" class="org.apache.log4j.DailyRollingFileAppender">
    <param name="threshold" value="info"/>
  
    <!-- ファイル情報 -->
    <param name="file" value="C:\\Users\\kagyuu\\Documents\\logtest.txt" />
    
    <param name="append" value="false" />
    <param name="datePattern" value="'.'yyyy-MM-dd" />
    
    <!-- レイアウトの指定 -->
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern"
             value="DEBUG [%x%-5p] %-10.10m @ %c%n" />
    </layout>
  </appender>
 
  <!-- ********************** category定義 ************************* -->
  <category name="com.snail.exam.log4j.buggy">
    <priority value="debug" />
    <appender-ref ref="FILE" />
  </category>
 
  <!-- ********************** root定義 ***************************** -->
  <root>
    <priority value="debug" />
    <appender-ref ref="STDOUT" />
  </root>
   
</log4j:configuration>

↑

出力 †

STDOUT

RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.Log4jExamApplication
RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.buggy.BuggyClass
RUNTIME [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.gentle.GentleClass
RUNTIME [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.gentle.GentleClass
RUNTIME [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.gentle.GentleClass

FILE(C:\Users\kagyuu\Documents\logtest.txt)

DEBUG [FATAL] 本当にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [ERROR] 普通にやばいログ　　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [WARN ] ちょっとやばいログ　 @ com.snail.exam.log4j.buggy.BuggyClass
DEBUG [INFO ] 運用時に必要なログ　 @ com.snail.exam.log4j.buggy.BuggyClass

↑

フィルタリングの概要 †

root
- root で info 未満は切り捨てられて、
- appender では warn 未満を切り捨てるから、
- 結局 warn 以上が出力される
category
- category で、BuggyClass? 以外、debug 未満は切り捨てられて、
- appender では info 未満を切り捨てるから、
- 結局 BuggyClass? の info 以上が出力される

↑

(余談) Maven2 で要らない依存ライブラリを取ってこないようにするには？ †

<?xml version="1.0" encoding="UTF-8"?>
<project>
  <modelVersion>4.0.0</modelVersion>
  <groupId>Log4jExam</groupId>
  <artifactId>Log4jExam</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <description></description>
  <dependencies>
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.15</version>
      <exclusions>
        <exclusion>
          <groupId>com.sun.jdmk</groupId>
          <artifactId>jmxtools</artifactId>
        </exclusion>
        <exclusion>
          <groupId>com.sun.jmx</groupId>
          <artifactId>jmxri</artifactId>
        </exclusion>
        <exclusion>
          <groupId>javax.jms</groupId>
          <artifactId>jms</artifactId>
        </exclusion>
      </exclusions>
    </dependency>
  </dependencies>
</project>

<exclusion> で、要らない依存ライブラリ(依存ライブラリの依存ライブラリ)を指定することができる。
- この場合、アプリケーションは log4j を使い、log4jは jmx や jms を使っているが、
- このアプリケーションからは jmx や jms が必要な log4j の機能を使わないので <exclusion> に指定することにより、Maven2 が勝手に jmx や jms を取り込むのを防いでいる
<exclusion> に指定されたライブラリは、Maven レポジトリから勝手に取ってこられないので、mvn package などでできた jar にも入らない
便利だからと言って、何にも考えずに POM ファイルにライブラリを記述していくと、最終成果物が数十MB になったりするんだよね・・・

westkingwy

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Jakarta log4j.xml に設定するログレベルの整理

はじめに †log4j.xml のログレベルの関係がよく分からないので調べてみる。次の３つで制御されるが、それぞれの関係は？appender の category の root の結局こうなるcategory と root は、影響し合わない実際に出力されるログレベルは、root と appender で指定したログレベルの内、どちらか厳しいもの c
复制链接

扫一扫

专栏目录