脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网络编程 → JavaScript → node.js → Nodejs winston

Nodejs使用winston进行日志记录详解

 更新时间：2024年01月15日 11:02:11   作者：东方小月  
在生产环境中,更常见的做法是使用专门的日志记录库,如winston、log4js等,来实现更灵活和可配置的日志记录功能,本篇文章将介绍的是winston的强大的日志记录功能,快跟随小编一起学习一下吧

在我们开发过程中,日志记录是非常重要的一环,它可以提供我们程序的运行状况、错误和异常、性能和安全等方面的关键信息,让开发人员和运维团队更好地管理和维护应用程序。

那么在NodeJS中该如何进行日志记录呢? 有小伙伴就会说console.log! 确实,Node.js中可以使用console.log进行简单的日志记录,但是它将信息输出到控制台就结束了,不会被持久化保存到文件或其他存储设备中。所以通常只是在开发和调试阶段使用一下。

在生产环境中，更常见的做法是使用专门的日志记录库，如winston、log4js等，来实现更灵活和可配置的日志记录功能。本篇文章将介绍的是winston的强大的日志记录功能。下面我们就从一个简单的node项目开始吧!

初始化项目

新建目录执行

npm init

初始化一个 node 项目。

然后在 package.json 文件中新增type:module字段,这样我们就可以使用 ES6 语法了

{
  "name": "winston",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC"
}

新建一个index.js文件。ok，接下来我们就可以使用 winston 了

安装使用 winston

执行命令npm i winston -S安装winston,安装完成我们就可以在程序中导入使用了

比如在index.js中我们可以使用 winston.createLogger 创建一个日志记录器

import winston from "winston";
const { format, transports } = winston;
const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [new transports.Console()],
});

logger.info("cxkhtw");

然后我们执行node index.js就会看到控制台打印了

info: cxkhtw

日志记录器接受以下参数：

名称默认值描述
level'info'仅在 info.level 小于或等于此级别时记录
levelswinston.config.npm.levels表示日志优先级的级别（和颜色）
formatwinston.format.json用于 info 消息的格式化（参见：Formats）
transports[]日志传传输方式
exitOnErrortrue如果为 false，则处理的异常不会导致进程退出
exceptionHandlers[]未捕获异常处理方式
silentfalse如果为 true，则所有日志都将被禁止

我们简单看下上面常用的参数

level

它表示日志记录的最低等级，在 winston 中，日志级别遵循 RFC5424 指定的严重性顺序：所有级别的严重性被规定为从最重要到最不重要的数字递增。

const levels = {
  error: 0,
  warn: 1,
  info: 2,
  http: 3,
  verbose: 4,
  debug: 5,
  silly: 6,
};

比如上面我们指定的 level 为 debug，那么 debug 及以上都会被记录，下面的则不会被打印，比如我们加几种打印类型

logger.info("cxkhtw");
logger.debug("cxkhtw");
logger.warn("cxkhtw");
logger.silly("cxkhtw");

执行程序后会发现只记录了前三个

format

format可以规定日志的格式，默认是format.json也就是 JSON 格式，比如我们将format去掉再执行程序

const logger = winston.createLogger({
  level: "debug",
  transports: [new transports.Console()],
});

你会发现打印出来的变成 JSON 格式了

我们还可以使用format.combine组合我们需要的格式

format: format.combine(format.timestamp(), format.simple()),

更多格式可以参见formats

transports

transports可以理解为日志的传输方式，比如我们想传输到控制台，文件，数据库，接口等等，都可以选择对应transports，比如上面的new transports.Console()就可以让我们在控制台看到打印的日志。

1. transports.File

如果我们想将日志记录在文件中，可以使用new transports.File进行配置

const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [
    new transports.Console(),
    new transports.File({
      dirname: "logs",
      filename: "index.log",
    }),
  ],
});

这时候再执行程序你就会发现多了个 logs/index.log 文件并且记录了打印的日志

如果将所有日志都记录在一个文件中，那这个文件岂不是越来越大？ 不用担心。winston还给我们提供了日志分割的功能,只需要配置maxsize属性即可，单位是字节，为了更好的演示这里我们设置 1024 字节也就是 1kb

const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [
    new transports.Console(),
    new transports.File({
      dirname: "logs",
      filename: "index.log",
      maxsize: 1024,
    }),
  ],
});

然后多执行几次就会发现日志文件新增了一个，并且第一个日志文件大小刚好 1kb 左右

一般来说我们进行日志分割都是根据时间来分割的，这样方便后期排查问题，那么winston支持按时间分割吗？ 答案是肯定的

2. transports.DailyRotateFile

如果想根据时间分割日志，我们需要换别的 Transport ，winston提供了很多transport,感兴趣的可以点进去看下。我们这里使用DailyRotateFile来分割日志

我们首先要安装npm install winston-daily-rotate-file -S,然后导入就可以使用了

import winston from "winston";
import "winston-daily-rotate-file";
const { format, transports } = winston;
const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [
    new transports.Console(),
    new transports.DailyRotateFile({
      level: "debug",
      dirname: "logs",
      filename: "index-%DATE%.log",
      datePattern: "YYYY-MM-DD-HH-mm",
      maxSize: 1024,
    }),
  ],
});

logger.info("cxkhtw");
logger.debug("cxkhtw");
logger.warn("cxkhtw");
logger.info("cxkhtw");

这时候每分钟的日志都会被记录在不同的文件中了,当然你可以设置datePattern来规定这个时间

3. transports.Http

有的时候我们想将日志上报到指定接口中进行记录 winston 也是支持的，可以使用内置的 transport.Http 进行配置，为了更好的演示，我们用express写一个简单的接口，安装express后新建一个 server.js

import express from "express";
import bodyParser from "body-parser";
const app = express();
const port = 3000;
app.use(bodyParser.json());
// 定义一个 POST请求的路由
app.post("/", (req, res) => {
  console.log(req.body);
  res.send("Hello, World!");
});

// 启动服务器
app.listen(port, () => {
  console.log(`Server is running on port ${port}`);
});

注意这里还需要安装body-parser让我们的接口可以接收 JSON 文件，然后新建一个终端执行node server.js启动一个端口为 3000 的接口

在我们程序中的transports添加一个transports.Http,并传入一些配置参数

import winston from "winston";
import "winston-daily-rotate-file";
const { format, transports } = winston;
const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [
    new transports.Console(),
    new transports.Http({
      level: "info",
      host: "localhost",
      port: 3000,
      path: "/",
    }),
  ],
});

logger.info("cxkhtw");
logger.debug("cxkhtw");
logger.warn("cxkhtw");
logger.info("cxkhtw");

然后执行一下，可以发现我们接口中拿到了日志信息,后面可以根据自己的需求将这些信息存储下来

winston的transport还有很多,由于篇幅有限这里先只介绍这几个常用的,感兴趣的可以自己查看

exceptionHandlers

除了上述功能外，winston 还可以配置处理未捕获异常,如下

import winston from "winston";
import "winston-daily-rotate-file";
const { format, transports } = winston;
const logger = winston.createLogger({
  level: "debug",
  format: format.simple(),
  transports: [new transports.Console()],
  exceptionHandlers: [
    new transports.File({
      dirname: "errorlogs",
      filename: "error.log",
    }),
  ],
});
throw Error("这是一条错误信息");

运行就会发现多了一个errorlogs/error.log文件

总结

本篇文章介绍 winston 一些常见用法，包括 level 的优先级、日志打印的格式format以及一些transport的使用等等。

其中,重点介绍了transport的用法，通过transport实现了生成日志文件，日志分割，日志上传接口等常见日志处理功能。

到此这篇关于Nodejs使用winston进行日志记录详解的文章就介绍到这了,更多相关Nodejs winston内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • node.js中的console.dir方法使用说明

    node.js中的console.dir方法使用说明

    这篇文章主要介绍了node.js中的console.dir方法使用说明,本文介绍了console.dir的方法说明、语法、接收参数、使用实例和实现源码,需要的朋友可以参考下
    2014-12-12
  • nvm安装步骤及使用方法

    nvm安装步骤及使用方法

    nvm是一个管理nodejs版本的工具。在实际的开发中，有些项目的开发依赖需要低版本的nodejs运行环境，有些则需要高版本的nodejs，此时我们就需要使用nvm来切换nodejs版本，接下来通过本文给大家讲解nvm安装步骤及使用方法，感兴趣的朋友一起看看吧
    2023-01-01
  • nodejs+express最简易的连接数据库的方法

    nodejs+express最简易的连接数据库的方法

    这篇文章主要介绍了nodejs+express 最简易的连接数据库，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2020-12-12
  • nodejs不用electron实现打开文件资源管理器并选择文件

    nodejs不用electron实现打开文件资源管理器并选择文件

    最近在开发一些小脚本,用 nodejs 实现,其中很多功能需要选择一个/多个文件,或者是选择一个文件夹,这种情况下网上给出的解决方案都是 electron,但是我一个小脚本用 electron 属实有点夸张了,后来转念一想可以通过 powershell 来实现类似的功能,需要的朋友可以参考下
    2024-01-01
  • Node.js卸载与重装及zip与msi安装详解

    Node.js卸载与重装及zip与msi安装详解

    Node.js是一个JavaScript运行环境,可以使JavaScript这类脚本语言编写出来的代码运行速度获得极大提升,下面这篇文章主要给大家介绍了关于Node.js卸载与重装及zip与msi安装的相关资料,需要的朋友可以参考下
    2023-01-01
  • 从零开始学习Node.js系列教程二：文本提交与显示方法

    从零开始学习Node.js系列教程二：文本提交与显示方法

    这篇文章主要介绍了Node.js文本提交与显示方法,结合实例形式分析了nodejs基于http的文本提交、传输与显示相关操作技巧,需要的朋友可以参考下
    2017-04-04
  • Node.js 多线程完全指南总结

    Node.js 多线程完全指南总结

    这篇文章主要介绍了Node.js 多线程完全指南总结,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2019-03-03
  • node.js同步/异步文件读写-fs，Stream文件流操作实例详解

    node.js同步/异步文件读写-fs，Stream文件流操作实例详解

    这篇文章主要介绍了node.js同步/异步文件读写-fs，Stream文件流操作,结合实例形式详细分析了node.js针对文件的同步/异步读写与文件流相关操作技巧,需要的朋友可以参考下
    2023-06-06
  • 详解Nodejs get获取远程服务器接口数据

    详解Nodejs get获取远程服务器接口数据

    这篇文章主要介绍了Nodejs get获取远程服务器接口数据，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • OpenSCA技术原理npm依赖示例解析

    OpenSCA技术原理npm依赖示例解析

    这篇文章主要为大家介绍了OpenSCA技术原理npm依赖示例解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2023-02-02

最新评论