NC-日志配置及代码详解

一、日志文件输出说明

日志目录/nchome/nclogs/servername/ ,其中servername集群时目录类似为master,ncMem01等。非集群时目录为:server1(服务名)

模块 输出格式 说明
anonymous anony-log.log 业务日志,如果没有配置模块,日志写在该处
nclog nc-log.log 系统日志,是系统的主日志系统,所有错误日志都会输出到该文件。
pfxx pfxx-log.log 外部交换平台日志文件
portal portal-log.log portal日志文件
prealert pa-log.log 预警平台日志文件
accountmanage am-log.log 系统管理升级日志文件
nc.bs.framework fw-log.log IOC容器框架日志文件
iufo iufo-log.log iufo日志文件
userpower userpower-log.log 权限升级日志文件
workflow wf-log.log 流程平台日志文件
nc.bs.framework.mx.thread mwsummary-log.log 性能概要日志,记录部分中间日志,结合NMC分析中间件使用
sql sql-log.log 系统执行sql日志文件,结合NMC分析使用;一般不用设置为debug,调试时再设置
uapweb uapweb-log.log uapweb模块日志文件
nc.bs.framework.codesync codesync-log.log 代码同步日志文件
uapbdsearch uapbdsearch-log.log 企业搜索日志文件
uapadp uap-adp.log 分布系统日志文件
scheduleengine schedule-log.log 调度引擎日志文件
tmobm tmobm-log.log 资金银企直联模块日志文件
nc.itf.uap.queryengine qeddc-log.log 查询引擎日志文件
warningsql warningsql-log.log 引发警告条件的sql日志文件,结合NMC分析使用

二、日志配置说明

2.1 配置文件路径

/nchome/ierp/bin/logger-config.properties

2.2 配置格式

mobileaim.level=DEBUG
mobileaim.pattern=$$callid=%X{serial} $$thread=[%t] $$host=%X{remoteAddr} $$userid=%X{user} $$ts=%d{yyyy-MM-dd HH:mm:ss} $$remotecall=[%A] $$debuglevel=%p $$msg=%m %n
mobileaim.file=./nclogs/${server}/mobileaim-log.log
mobileaim.size.maxSize=5MB
mobileaim.size.maxIndex=5

2.2.1 参数说明

mobileaim = 模块名称 <moduleName> 
level = 日志等级 
    ALL = new Level("ALL", 0);
    TRACE = new Level("TRACE", 1);
    DEBUG = new Level("DEBUG", 2);
    INFO = new Level("INFO", 3);
    WARN = new Level("WARN", 4);
    ERROR = new Level("ERROR", 5);
    NSTACK = new Level("NSTACK", 5);
    FATAL = new Level("FATAL", 6);
    OFF = new Level("OFF", 7);

pattern = 日志输出格式
file = 日志输出文件
size.maxSize = 单日志文件最大存储
size.maxIndex = 日志最大个数

其中pattern配置说明如下:

%m 代码中指定的具体日志信息,message
%n 一个回车换行符,Windows平台为"\r\n",Unix平台为"\n"
%x 和当前线程相关联的NDC上下文信息(栈式)
%X{key} 和当前线程相关的MDC上下文变量(key/value形式)
// NCD与MDC见../JAVA/Log4j之MDC和NDC区别和用法
%C className 类名
%M methodName 方法名
%L lineNumber 线程号
%T logType 日志类型
%A moduleName 模块名
%t 产生该日志事件的线程名
%d 输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式
%p level,日志信息的优先级

三、代码说明

NC6X的日志框架为Log4j,NCC后升级为Log4j2

基本日志类

nc.bs.logging.Log;
// 可以基于该类实现自定义日志的输出
Log defLog = Log.getInstance(moduleName);

日志级别

nc.bs.logging.Level;
ALL = new Level("ALL", 0);
TRACE = new Level("TRACE", 1);
DEBUG = new Level("DEBUG", 2);
INFO = new Level("INFO", 3);
WARN = new Level("WARN", 4);
ERROR = new Level("ERROR", 5);
NSTACK = new Level("NSTACK", 5);
FATAL = new Level("FATAL", 6);
OFF = new Level("OFF", 7);

日志事件参数类

org.apache.log4j.spi.LoggingEvent;
// NC对该类的继承
nc.bs.logging.impl.log4j.Log4jLoggingEvent;

pattern参数解析类

org.apache.log4j.PatternLayout
// NC的继承
nc.bs.logging.impl.log4j.Log4jPatternFormatter;

四、自定义日志实例

logger-config.properties配置如下:

# liyas add 20200911 接口日志
uapport.level=DEBUG
uapport.pattern=$$callid=%X{serial} $$thread=[%t] $$host=%X{remoteAddr} $$userid=%X{user} $$ts=%d{yyyy-MM-dd HH:mm:ss} $$debuglevel=%p $$module=[%A] $$class=[%C] $$method=[%M] $$msg=%m %n
uapport.file=./nclogs/${server}/uapport-log.log
uapport.size.maxSize=5MB
uapport.size.maxIndex=5

实例1-新建日志类

package nc.bs.logging;
import nc.bs.logging.Log;
/**
 * 系统对外接口日志输出类
 * @author liyas 2020-07-27
 *
 */
public class UapPortLogger {
	private static String LOGFILE = "uapport";

	public static void debug(Object msg, Class caller, String methodName) {
		Log LOGFILELog = Log.getInstance(LOGFILE);
		LOGFILELog.debug(msg, caller, methodName);
	}

	public static void info(Object msg, Class caller, String methodName) {
		Log portLog = Log.getInstance(LOGFILE);
		portLog.info(msg, caller, methodName);
	}

	public static void error(Object msg, Throwable exception, Class caller,
			String methodName) {
		Log portLog = Log.getInstance(LOGFILE);
		portLog.error(msg, exception, caller, methodName);
	}

	public static void error(Object msg, Class caller, String methodName) {
		Log portLog = Log.getInstance(LOGFILE);
		portLog.error(msg, caller, methodName);
	}

	public static void warn(Object msg, Throwable exception, Class caller,
			String methodName) {
		Log portLog = Log.getInstance(LOGFILE);
		portLog.warn(msg, exception, caller, methodName);
	}

	public static void warn(Object msg, Class caller, String methodName) {
		Log portLog = Log.getInstance(LOGFILE);
		portLog.warn(msg, caller, methodName);
	}
}

实例2-直接在代码中使用日志输出

// 将日志输出至uapport文件
Log.getInstance("uapport").info("message",this.getClass(),"Method");

五、附录

参考文章

Log4j.properties配置详解
Log4j之MDC和NDC用法

posted @ 2022-06-01 14:48  YaenLi  阅读(1694)  评论(0编辑  收藏  举报