阿里Java开发手册思考（四）

上期咱们分享了Java中日志的处理（上）：Java中日志的相关知识、Slf4j的原理及源码分析

本期咱们将分享Java中日志的处理（下）

首先看下阿里Java开发手册中日志规约的剩余几条并给出分析：

• 2.【强制】日志文件推荐至少保存 15 天，由于有些异常具有以“周”为频次发生的特色。

分析：

• 若是使用的是Log4j，且采用的RollingFileAppender方式, 经过设置maxBackupIndex属性来指定要保留的日志文件数的最大值能够间接实现删除N天前的日志文件
• 若是使用的是Log4j,且采用的DailyRollingFileAppender方式，因为该方式不支持maxBackupIndex，须要从新实现DailyRollingFileAppender，用以支持maxBackupIndex的设置
• 若是使用的是Logback,能够经过设置maxHistory实现删除N天前的日志

• 3.【强制】应用中的扩展日志(如打点、临时监控、访问日志等)命名方式: appName_logType_logName.log。logType:日志类型，推荐分类有stats/desc/monitor/visit 等;logName:日志 述。这种命名的好处:经过文件名就可知道日志文件属于什么应用，什么类型，什么目的，也有利于归类查找。 正例:mppserver应用中单独监控时区转换异常，如: mppserver_monitor_timeZoneConvert.log 说明:推荐对日志进行分类，如将错误日志和业务日志分开存放，便于开发人员查看，也便于 经过日志对系统进行及时监控。

• 4.【强制】对trace/debug/info级别的日志输出，必须使用条件输出形式或者使用占位符的方 式。 说明:logger.debug("Processing trade with id: " + id + " and symbol: " + symbol); 若是日志级别是warn，上述日志不会打印，可是会执行字符串拼接操做，若是 symbol是对象， 会执行toString()方法，浪费了系统资源，执行了上述操做，最终日志却没有打印。

正例:(条件)

if (logger.isDebugEnabled()) {
    logger.debug("Processing trade with id: " + id + " and symbol: " + symbol);
}
复制代码

正例:(占位符)

logger.debug("Processing trade with id: {} and symbol : {} ", id, symbol);
复制代码

分析：

• 正如上篇分析的，推荐全部使用Slf4j，打印日志统一使用占位符，且不需判读isxxxEnabled()

• 5.【强制】避免重复打印日志，浪费磁盘空间，务必在 log4j.xml 中设置 additivity=false。 正例:

<logger name="com.taobao.dubbo.config" additivity="false">
复制代码

• 6.【强制】异常信息应该包括两类信息:案发现场信息和异常堆栈信息。若是不处理，那么经过 关键字 throws 往上抛出。 正例:

logger.error(各种参数或者对象 toString + "_" + e.getMessage(), e);
复制代码

• 7.【推荐】谨慎地记录日志。生产环境禁止输出 debug 日志;有选择地输出 info日志;若是使 用 warn 来记录刚上线时的业务行为信息，必定要注意日志输出量的问题，避免把服务器磁盘 撑爆，并记得及时删除这些观察日志。 说明:大量地输出无效日志，不利于系统性能升，也不利于快速定位错误点。记录日志时请 思考:这些日志真的有人看吗?看到这条日志你能作什么?能不能给问题排查带来好处?
• 8.【参考】能够使用warn 日志级别来记录用户输入参数错误的状况，避免用户投诉时，无所适 从。注意日志输出的级别，error级别只记录系统逻辑出错、异常等重要的错误信息。如非必 要，请不要在此场景打出 error级别。

补充

• 一、 涉及到多线程时，日志中最好将线程id打印出来，以区分不一样的线程

public final class LogIdThreadLocal {
    private static ThreadLocal<String> logIdThreadLocal = new ThreadLocal<String>();
    ...
}

public class MyPatternLayout extends PatternLayout {
    private static final String SPLIT_STRING = "|";

    @Override
    public String format(LoggingEvent event) {
        String log = super.format(event);

        String threadLocalId = LogIdThreadLocal.getLogId();

        if (StringUtils.isEmpty(threadLocalId)) {
            threadLocalId = LogIdThreadLocal.create();
        }

        return log + threadLocalId + SPLIT_STRING + event.getMessage() + Layout.LINE_SEP;
    }
}
复制代码

log4j.appender.output.layout=com.test.log.MyPatternLayout
log4j.appender.output.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss:SSS}|%t|%-5p|%C{1}.%M:%L| 
复制代码

• 二、 提供动态修改日志级别的接口或者使用Log4j Web Tracker

对于生产环境，默认的日志级别多是error/warning/info，对于debug的日志就没有打出来，若是要让debug日志能打印出来，那么常见的方法就是修改log4j.xml或者log4j.properties文件，修改了以后须要重启tomcat，咱们知道，生产环境是不可能随随便便重启的，那么有没有其余方法呢？答案是：有。 Log4j为咱们提供了这样的API,经过调用Log4j的API，提供rest接口，使得客户端能够动态修改某个日志的级别：

private String changeLoggerLevel(String loggerName, String level) {  
    Logger logger = LogManager.exists(loggerName);  
    String result = null;  
    if (logger != null) {  
        logger.setLevel(Level.toLevel(level));  
        result = logger.getName() + "|" + logger.getLevel();  
    } else {  
        result = "logger not exist.";  
    }  
    return result;  
}  
复制代码

此外，推荐一个开源的第三方组件：Log4j Web Track（连接为Github地址），以下图：

相关配置：

<servlet>
    <servlet-name>TrackerServlet</servlet-name>
    <servlet-class>log4jwebtracker.servlet.TrackerServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>TrackerServlet</servlet-name>
    <url-pattern>/tracker/*</url-pattern>
</servlet-mapping>

<servlet>
    <servlet-name>Log4jInitServlet</servlet-name>
    <servlet-class>log4jwebtracker.servlet.init.Log4jInitServlet</servlet-class>
    <init-param>
        <param-name>log4jConfigLocation</param-name>
        <param-value>WEB-INF/classes/log4j.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
复制代码

经过阅读源码，其也是调用了Log4j的API，进行了展现：

public abstract class LoggingUtils {

	static synchronized public List getFileAppenders() {
		List list = new ArrayList();
		Enumeration e = LogManager.getRootLogger().getAllAppenders();
		while(e.hasMoreElements()) {
			Appender a = (Appender) e.nextElement();
			if(a instanceof FileAppender) {
				list.add(a);
			}
		}
		return list;
	}

	static synchronized public FileAppender getFileAppender(String appenderName) {
		Enumeration e = LogManager.getRootLogger().getAllAppenders();
		while(e.hasMoreElements()) {
			Appender a = (Appender) e.nextElement();
			if(a instanceof FileAppender && a.getName().equals(appenderName)) {
				return (FileAppender) a;
			}
		}
		return null;
	}

	static public boolean contains(List loggers, String loggerName) {
		int i=0;
		while(i<loggers.size()) {
			if(((Logger)loggers.get(i)).getName().equals(loggerName)) {
				return true;
			}
			i++;
		}
		return false;
	}

	static public List getLoggers() {
		Enumeration e = LogManager.getCurrentLoggers();
		List loggersList = new LinkedList();
		while(e.hasMoreElements()) {
			loggersList.add(e.nextElement());
		}
		Collections.sort(loggersList, new Comparator() {
			public int compare(Object arg0, Object arg1) {
				Logger log0 = (Logger) arg0;
				Logger log1 = (Logger) arg1;
				return log0.getName().compareTo(log1.getName());
			}
		});
		loggersList.add(0, LogManager.getRootLogger());
		return loggersList;
	}
}
复制代码

若是有兴趣的话，咱们能够实现一个Web Tracker的门面，相似于Slf4j，那么对于Log4j1/二、LogBack、Juc、Commons Logging的日志都能实现可视化以及动态修改日志级别的功能

微信公众号： 码上论剑 请关注个人我的技术微信公众号，订阅更多内容