Node.js日志框架:Winston模块入门学习

前言

Winston是一款简单、通用且支持多种transport方式的日志库。在Winston模块中,一个transport方式就是对日志定义一种存储位置或存储设备,Logger的每个实例都可以配置多个不同级别的transport。例如,可以将错误日志存储在可持久保存的远程位置(如数据库)也可以将日志输出到控制台或保存到本地文件中。
本文主要是对Winston模块的入门学习,主要讲述了Logger的使用。更多操作可以参考Winston模块的github主页

安装和使用

npm install --save winston

Logger的优先级

在npm中,为Logger设定了六种优先级,优先级越高,消息也就被认为约重要,对应的整数便越小,具体为:

{error : 0,warn : 1,info : 2,verbose : 3,debug : 4,silly : 5 }

从上面的例子中我们可以看到,对于优先级的使用有两种方法

  1. 将表示日志优先级的参数传递给log()方法
  2. 使用Winston Logger中自带指定优先级的方法
  logger.log('silly', "127.0.0.1 - there's no place like home");
  logger.log('debug', "127.0.0.1 - there's no place like home");
  logger.log('verbose', "127.0.0.1 - there's no place like home");
  logger.log('info', "127.0.0.1 - there's no place like home");
  logger.log('warn', "127.0.0.1 - there's no place like home");
  logger.log('error', "127.0.0.1 - there's no place like home");
  logger.info("127.0.0.1 - there's no place like home");
  logger.warn("127.0.0.1 - there's no place like home");
  logger.error("127.0.0.1 - there's no place like home");

Logger的基本使用

使用默认的Logger

使用Winston模块,我们可以直接使用默认的Logger,可以调用默认Logger的实例中的任何一个函数。例子如下:

var winston = require('winston');//声明Winston模块

winston.log('info', 'Hello distributed log files!');
//在console输出:info: Hello distributed log files!

winston.info('Hello again distributed logs');
//在console输出:info: Hello again distributed logs

winston.level = 'debug';//定义Logger的级别为debug
winston.log('debug', 'Now my debug messages are written to console!');
//在console输出:debug: Now my debug messages are written to console!

在默认情况下,所有的transport都是显示在console中的,我们可以使用add()和remove()方法来添加或者删除transport

//添加一个`transport`,保存位置为somefile.log文件
winston.add(winston.transports.File, { filename: 'somefile.log' });
//删除一个`transport`,不在console中显示
winston.remove(winston.transports.Console);

也可以使用configure()函数来创建一个新的transport

winston.configure({
  transports: [
    new (winston.transports.File)({ filename: 'somefile.log' })
  ]
});

使用自定义的Logger

加入我们想更好地管理Logger,那么可以使用自定义的Logger,例子如下:

//创建一个新的Logger,定义两种`transport`方式
//一个`transport`为显示在console
//一个`transport`为保存到本地文件
var logger = new (winston.Logger)({
  transports: [
    new (winston.transports.Console)(),
    new (winston.transports.File)({ filename: 'somefile.log' })
  ]
});

在完成了对Logger的定义之后,便可以在文件中对其进行使用:

//使用自定义的Logger
//将信息显示在console,同时保存到本地文件
logger.log('info', 'Hello distributed log files!');
logger.info('Hello again distributed logs');

对于自定义的Logger,同样可以对transport方式进行添加和删除:

logger
  .add(winston.transports.File)//添加`transport`方式
  .remove(winston.transports.Console);//删除`transport`方式

和默认的Logger类似,我们也可以使用configure方法来批量定义winston.Logger的实例:

var logger = new winston.Logger({
  level: 'info',
  transports: [
    new(winston.transports.Console)(),
    new(winston.transports.File)({
      filename: 'somefile.log'
    })
  ]
});
//批量定义`transport`类型
logger.configure({
  level: 'verbose',
  transports: [
    new(require('winston-daily-rotate-file'))(opts)
  ]
});

相同类型的多个transport

对于自定义的Logger,我们可以对其定义多个相同类型的的transport方式,然后设定不同的严重级别,根据级别的不同设定不同的处理方式,例如:对于info类型就在console中显示,对于error类型就保存在本地文件中。

var logger = new (winston.Logger)({
  transports: [
    //info级别的保存在filelog-info.log文件中
    new (winston.transports.File)({
      name: 'info-file',
      filename: 'filelog-info.log',
      level: 'info'
    }),
    //error级别的保存在filelog-error.log文件中
    new (winston.transports.File)({
      name: 'error-file',
      filename: 'filelog-error.log',
      level: 'error'
    })
  ]
});

对于设定好的Logger,我们可以根据不同transportname参数,对其进行删除:

logger.remove('info-file');//删除name为info-file的`transport`

也可以根据不同transport在Logger中的声明顺序进行删除,代码如下:

//删除第一个`transport`
var infoFile = logger.transports[0];
logger.remove(infoFile);

Logger之间共享transport

对于Logger之前共享transport,可以通过三种方法进行实现:

  1. transport在默认的container中设定
  2. transport加入到winston.container的构造函数中
  3. transport加入.get().add()方法
  var winston = require('winston');
  // 1.将`transport`设置在默认的container中
  winston.loggers.options.transports = [
    // Setup your shared transports here
  ];

  // 2.将`transport`加入到`winston.container`的构造函数中 
  var container = new winston.Container({
    transports: [
      // Setup your shared transports here
    ]
  });

  // 3. 将`transport`加入`.get()`和`.add()`方法
  winston.loggers.add('some-category', {
    transports: [
      // Setup your shared transports here
    ]
  });
  container.add('some-category', {
    transports: [
      // Setup your shared transports here
    ]
  });

跨文件使用Logger

当项目的规模到达一定程度的时候,如果想系统的管理代码,则Winston日志模块便会十分有用。我们可以在一个文件中专门定义各种Logger和transport,然后将其作为一个模块进行导出。在需要使用的文件中,则将其引用,根据需求进行调用。例子:

//在winston.js文件中定义Logger
exports.logger = new(winston.Logger)({
  transports: [
    new winston.transports.File({
      name: 'error',
      colorize: true,
      timestamp: true,
      level: 'error',
      filename: 'project.log',
      json: true
    }),
    new winston.transports.File({
      name: 'info',
      colorize: true,
      timestamp: true,
      level: 'info',
      filename: 'project.log',
      json: true
    })
  ]
})
//在useWinston.js文件中使用Logger
var winston = require('./winston')
winston.logger.log('error', 'some error')
winston.logger.log('info', 'some info')
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,482评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,377评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,762评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,273评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,289评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,046评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,351评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,988评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,476评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,948评论 2 324
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,064评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,712评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,261评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,264评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,486评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,511评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,802评论 2 345

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,599评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,510评论 25 707
  • 在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析...
    时待吾阅读 4,961评论 0 6
  • 在应用程序中添加日志记录总的来说基于三个目的:监视代码中变量的变化情况,周期性的记录到文件中供其他应用进行统计分析...
    时待吾阅读 4,952评论 1 13
  • 如何识别遇到电话障碍 ——“许多销售员给对方即使打了上百次电话,还是找不到要找的人,他们都不知道其实是碰上了电话障...
    普实软件阅读 379评论 0 0