目录

1、Log的用途

2、记录Log日志的基础原则

2.1、日志级别划分

2.2、日志对性能的影响

2.3、什么时候输出日志

2.3.1、系统启动参数、环境变量

2.3.2、异常捕获

2.3.3、函数获得期望之外的结果时

2.3.4、关键操作

2.4 日志输出的内容

3 日志API规范

3.1 Log对象的声明和初始化

3.2 不得使用System.out, System.err进行日志记录，请改使用logger.debug、logger.error

3.3 正确的记录异常信息

3.4 重要方法入口，业务流程前后及处理的结果等，推荐记录log，并使用debug级别

3.5 不允许记录日志后又抛出异常，因为这样会多次记录日志，只允许记录一次日志。

3.6 Log的内容一定要确保不会因为Log语句的问题而抛出异常造成中断

不管是使用何种编程语言，日志输出几乎无处不在。总结起来，日志大致有以下几种用途：

Java日志通常可以分为:error、warn、info、debug、trace五个级别。

不管多么优秀的日志工具，在日志输出时总会对性能产生或多或少的影响，为了将影响降到对低，有以下几个准则需要遵守：

日志并不是越多越详细就越好。在分析运行日志，查找问题时，我们经常遇到该出现的日志没有，无用的日志一大堆，或者有效的日志被大量无意义的日志信息淹没，查找起来非常困难。那么什么时候输出日志呢？以下列出了一些常见的需要输出日志的情况，而且日志的级别基本都是>=INFO，至于Debug级别日志的使用场景，需要具体情况具体分析，但也是要追求“恰如其分”，不是越多越好。

系统启动的参数、配置、环境变量、System.Properties等信息对于软件的正常运行至关重要，这些信息的输出有助于安装配置人员通过日志快速定位问题，所以程序有必要在启动过程中把使用到的关键参数、变量在日志中输出出来。在输出时需要注意，不是一股脑的全部输出，而是将软件运行涉及到的配置信息输出出来。比如，如果软件对jvm的内存参数比较敏感，对最低配置有要求，那么就需要在日志中将-Xms -Xmx -XX:PermSize这几个参数的值输出出来。

在捕获异常处输出日志，大家在基本都能做到，唯一需要注意的是怎么输出一个简单明了的日志信息。这在后面的问题问题中有进一步说明。

一个函数，尤其是供外部系统或远程调用的函数，通常都会有一个期望的结果，但如果内部系统或输出参数发生错误时，函数将无法返回期望的正确结果，此时就需要记录日志，日志的基本通常是warn。需要特别说明的是，这里的期望之外的结果不是说没有返回就不需要记录日志了，也不是说返回false就需要记录日志。比如函数：isXXXXX()，无论返回true、false记录日志都不是必须的，但是如果系统内部无法判断应该返回true还是false时，就需要记录日志，并且日志的级别应该至少是warn。

关键操作的日志一般是INFO级别，如果数量、频度很高，可以考虑使用DEBUG级别。以下是一些关键操作的举例，实际的关键操作肯定不止这么多。

n 删除：删除一个文件、删除一组重要数据库记录……

n 添加：和外系统交互时，收到了一个文件、收到了一个任务……

n 处理：开始、结束一条任务……

n ……

在日志相关数据输出的时要特别注意对敏感信息的保护，比如修改密码时，不能将密码输出到日志中。 

// （推荐）

private static final Logger logger = LoggerFactory.getLogger(Xxx.class);

private final Logger logger = LoggerFactory.getLogger(getClass());

private  static  final Logger logger =  LoggerFactory.getLogger("loggerName");

private static Logger logger = LoggerFactory.getLogger(Xxx.class);

protected final Logger logger = LoggerFactory.getLogger(getClass());

private Logger logger = LoggerFactory.getLogger(getClass());

protected Logger logger = LoggerFactory.getLogger(getClass());

输出Exceptions的全部Throwable信息，因为logger.error(msg)和logger.error(msg,e.getMessage())这样的日志输出方法会丢失掉最重要的StackTrace信息。

try {   

    Integer x = null;

    ++x;

} catch (Exception e) {

    //错误

    log.error(e);       

    //错误

    log.error(e, e);       

    //错误

    log.error(""+ e);       

    //错误

    log.error(e.toString());       

    //错误

    log.error(e.getMessage());       

    //错误

    log.error(null, e);       

    //不推荐

    log.error("", e);       

    //错误

    log.error("{}", e);       

    //错误

    log.error("{}", e.getMessage());     

     //错误

     log.error("Error reading configuration file: " + e);       

    //错误

    log.error("Error reading configuration file: "+ e.getMessage());       

    //推荐

    log.error("Error reading configuration file", e);

}

void foo() throws LogException{

    try{

        // do something

    }catch (Exception e){

        log.error("bad things",e);//错误

        throws new LogException("bad things",e);

    }

}