前言

本文章针对 log4js v4.3

本文对自己用log4js的技术点简单的做一个记录,有一些技术点没有用到或者写全,会在后面用到的时候进行更新。

先大概的对log4js 的基本用法做一个总结,使用configure()方法对日志输出进行配置,使用 getlogger()方法获取logger对象,然后使用logger 对象进行打印各个级别的日志。其中比较复杂的是 configure()方法中的配置对象appenders 和 categories 下面重点讲解这两个对象

安装

npm install --save log4js

日志级别level

log4js的分为以下几个级别,级别的顺序也是按如下排列,logger只会打印大于等于logger对象设置的level的日志

  1. trace
  2. debug
  3. info
  4. warn
  5. error
  6. fatal

简单的用法

var log4js = require('log4js');
var logger = log4js.getLogger();
logger.level = 'debug';
logger.debug("Some debug messages");

getLogger()方法返回一个logger对象,想对日志进行记录就必须使用logger对象,将logger对象的 level设置为debug(默认为OFF不会输出任何日志)

在node 环境运行上面的代码之后发现在控制台打印出了对应的日志信息,但是这跟我想要的完全不一样,我想要的是根据我自己的想法将日志进行分类方便查找和统计。接下来我们就看如何对日志进行分类。

configure(string | object) 方法

通过调用configure 方法就可以实现我们对日志进行分类管理的目的。方法的参数可以是一个字符串或者是一个object 字符串参数被视为用于加载配置的文件名,配置文件是一个json 文件,也可以直接将配置对象传给configure。

配置对象

本次只对配置对象中最常用的appenders 和categories 进行介绍,还有部分属性暂时还没有用到等用到的时候在进行补充,如果平常用的话这两个属性应该就够了。

简单的总结一下这两个属性,先有一个概念性的认识了解一下他们分别是干什么的。
appenders 主要是用来定义以怎样的方式输出,输出到哪里(主要功能不仅限于)
categories 是用来定义日志输出的规则然后调用之前定义好的 appenders 进行输出

写一个简单的例子方便理解一下

const log4js = require('log4js');
log4js.configure({
  appenders: {
    out: { type: 'stdout' },
    app: { type: 'file', filename: 'application.log' }
  },
  categories: {
    default: { appenders: [ 'out', 'app' ], level: 'debug' }
  }
});

var logger = log4js.getLogger();
logger.debug("Some debug messages");

运行上的代码将会创建application.log 文件在项目目录下,同时会把日志打到控制台和 application.log文件中.
上面定义了两个appender 一个是输出到 stdout 一个是输出到 file ,可以看出appender主要使用来定义输出位置的
同时在categories 中定义了一个规则,调用了appender中定义的输出,并且输出级别为 debug

appenders

appenders 的是一个map, key 代表的是appender的名字是一个字符串,value里面有一个必选的属性是type,根据type 的不同value 的格式也不一样,下面我们说几种常用的 type

file

file 日志将会输出到指定的文件中。

例子

log4js.configure({
  appenders: {
    everything: { type: 'file', filename: 'all-the-logs.log' }
  },
  categories: {
    default: { appenders: [ 'everything' ], level: 'debug' }
  }
});

const logger = log4js.getLogger();
logger.debug('I will be logged in all-the-logs.log');

常用配置属性

1. type:'file' 
2. filename string 输出文件的名字
3. maxLogSize integer日志文件的最大大小(以字节为单位)。如果未指定,则不会发生日志滚动。
4. backups日志滚动期间要保留的旧日志文件数默认为5
5. layout 默认是basic layout
6. keepFileExt boolean  默认为false 滚动日志文件时保留文件扩展名(file.log变为file.1.log而不是file.log.17. compress 对滚动的日志文件进行压缩

dateFile

dateFile 日志的滚动将根据配置的时间格式进行滚动而不是文件大小

例子

log4js.configure({
  appenders: {
    everything: { type: 'dateFile', filename: 'all-the-logs.log' }
  },
  categories: {
    default: { appenders: [ 'everything' ], level: 'debug' }
  }
});

常用配置属性

1. type:'dateFile'
2. filename string 输出文件的名字
3. pattern(默认为.yyyy-MM-dd) - 用于确定何时滚动日志的模式。
4. layout 默认是basic layout
5. daysToKeep integer(默认为0) - 如果此值大于零,则在日志滚动期间将删除早于该天数的文件。
6. keepFileExt (默认为false) - 在滚动日志文件时保留文件扩展名(file.log变为file.2017-05-30.log而不是file.log.2017-05-30
7. compress 对滚动的日志文件进行压缩

categories

categories 也是一个map类型的数据,key是 category 的名字是一个字符串,value 是一个对象。
value 的常用属性

  1. level 定义打印日志的级别
  2. appenders 定义打印的appender

getLogger([category]) 方法

getLogger 方法返回的是一个logger 对象,logger对象用来打印各个级别的日志。
getlogger 方法有一个可选参数category的名字,不写的情况会使用 categories 中default 定义的规则进行打印,填写之后会根据对应的 category定义的规则进行打印日志。


转载地址:

https://segmentfault.com/a/1190000019343887



帖子状态

话题参与者

回复显示排序:

给大家安利一款免费的在线流程图设计软件:贼好用 ProcessFlow — 免费在线作图、实时协作 ProcessFlow是一个在线作图工具的聚合平台, 它可以在线画流程图、思维导图、UI原型图、UML、网络拓扑图、组织结构图等等, 您无需担心下载和更新的问题, 不管Mac还是Windows,一个浏览器就可以随时随地的发挥创意,规划工作,解放您的双手,让您腾出双手去成就别人的梦想。

Finally!
有没有特别的设计建议或更新的指南?
Finally!
您好,这边没有的。
tesla02 best answer
6 Jan,2019
Finally!
有没有特别的设计建议或更新的指南?
此帖子已被版主标记,收到太多否决票。

这是太大的预览图像,它应该更小,甚至五行。在一个页面上有30到60个页面,它是1800个项目 类别例如在附加组件类别有22749个项目,为什么不看到所有的项目,但只有那1800个项目?这是件坏事。

看起来您是个新人,欢迎免费注册社区,加入我们的大家庭,一起学习,一起成长。
提交你的评论
System.out.println("请输入你的代码块...");
话题
分类
喜欢
回复
浏览
活跃
原创社区
985
0
1.5k
原创社区
985
1
1.5k
20/12/25 22:32:21
javaWeb
985
1
1.5k
20/06/15 22:09:21
youtube
698
78
2.1k
3d
Settings

请插入代码块