log4js的配置属性
Configuration- log4js.configure(object || string)
一个入口去配置log4js,字符串将会被当做文件名去加载配置文件,配置文件应该是json文件包含一个配置对象
在你的应用中使用log4js的第一时间配置它,如果你没有调用 configure ,log4js将会使用LOG4JS_CONFIG(如果存在)或者默认的配置。默认配置定义了一个追加器,这个追加器将日志打印到有颜色布局的stdout(标准输出),并且定义了默认日志水平是OFF,这意味着没有日志输出
如果你使用集群,在工作程序中也要像主程序中一样调用configure。这样,工作进程将为您的类别选择正确的级别,或者已经定义的任何自定义级别追加器只在主进程上定义,因此不会有多个进程试图写入同一个追加器的危险。与以前的版本不同,在集群中使用log4js不需要特殊配置。
Configuration Object
属性
levels (Object)可选
用于定义自定义日志等级,或者重新定义存在的对象;这是一个map,key是等级名称(大小写不敏感),value是一个对象,这个对象应该有两个属性:等级值(integer)和颜色。日志级别用于分配日志消息的重要性,使用整数值对日志消息进行排序。如果您在配置中没有指定任何内容,则使用默认值(ALL < TRACE < DEBUG < INFO < WARN < ERROR < FATAL < MARK < OFF)。这里定义的级别除了默认级别之外,还可以使用整数值来确定它们与默认级别的关系。如果您定义了一个与默认级别同名的级别,则配置中的整数值优先。级别名称必须以字母开头,只能包含字母、数字和下划线。
appenders(Object)
一个命名的追加器(string)到追加器的定义对象,对象必须有type(string)属性。
categories(Object)
一个命名的类别(string)到类别定义对象。必须定义默认类别,用于不匹配特定类别的所有日志事件。必须有两个属性appenders、level
categories.appenders(string[])
追加器名称数组,使用那些追加器,必须至少有一个追加器
categories.level(string,大小写不敏感)
这个类别将发送给追加器的最小的日志等级。例如设置为error 然后,追加器将只会受到error、fatal、mark等级的日志,info、warn、debug、trace将会被忽略。
enableCallStack(Boolean,可选,默认false)
设置为true将会为这个类别打印行数和文件名查看pattern layout可以设置这个输出。
pm2(Boolean,可选)
如果使用pm2设置为true,否则会不起作用(也需要安装pm2 install pm2-intercom)
pm2InstanceVar(string、可选、默认值NODE_APP_INSTANCE)
如果使用pm2并且已经更改了节点应用实例变量的默认名称
disableClustering (Boolean、可选)
如果你喜欢log4js过去忽略集群环境的方式,或者遇到PM2日志记录的问题,则将此设置为true。每个工作进程都将进行自己的日志记录。如果要将日志记录到文件中,请小心,可能会发生奇怪的情况。