专栏名称: 腾讯云加社区
目录
相关文章推荐
北美留学生观察  ·  日本县城高中，挤满中国中产娃... ·  6 小时前  
北美留学生观察  ·  别被骗了！欧洲人日常喝的甜白葡萄酒，一瓶也就 ... ·  昨天  
BioArt  ·  北京大学生命科学学院胡家志实验室招聘博士后研 ... ·  昨天  
北美留学生观察  ·  藤校进入9万美元时代！扩招、涨价、割中产娃韭菜… ·  2 天前  
BioArt  ·  Cell | ... ·  3 天前  
51好读  ›  专栏  ›  腾讯云加社区

入门系列之 使用Winston记录Node.js应用程序

腾讯云加社区  · 掘金  ·  · 2018-08-09 02:05

正文
阅读 26

入门系列之 使用Winston记录Node.js应用程序

欢迎大家前往腾讯云+社区，获取更多腾讯海量技术实践干货哦~

本文由 姚啊姚 发表于 云+社区专栏

介绍

在本指南中，我们将重点介绍 Winston 的日志包，这是一个极其通用的日志库，是基于NPM下载统计信息，可用于 Node.js 应用程序的日志记录解决方案。Winston的功能包括支持多个存储选项和日志级别，日志查询，甚至是内置的分析器。本教程将展示如何使用Winston记录我们创建的Node/ Express 应用程序。还将研究如何将Winston与另一个名为Morgan的Node.js的HTTP请求中间件记录器结合起来，以便将HTTP请求数据日志与其他信息进行整合。

完成本教程后，您将拥有一个小型Node /Express应用程序的Ubuntu服务器。您还将用Winston将错误和消息输出到文件和控制台。

准备

在开始本指南之前，您需要以下内容：

  • 一个Ubuntu 16.04服务器，包括一个sudo非root用户和防火墙权限。
  • 使用官方PPA安装Node.js。

不会搭建Nodejs的用户可以查看腾讯云实验室提供了 搭建Nodejs环境 的相关教程，有了这些准备，我们就可以构建我们的应用程序并安装Winston。

第一步，创建Node/ Express应用程序

Winston的一个常见用途是从使用Node.js构建的Web应用程序中记录事件。为了充分展示如何使用Winston，我们将使用Express框架创建一个简单的Node.js Web应用程序。我们使用 express-generator 一个命令行工具来快速运行Node/ Express Web应用程序。因为我们安装了Node Package Manager，所以可以使用npm命令进行安装express-generator。我们使用-g标志来全局安装软件包。使用以下命令安装软件包： 

$ sudo npm install express-generator -g
复制代码

我们可以使用express命令创建我们的应用程序，然后我们想用我们的项目目录的名称。这将创建我们的应用程序，包含了我们开始所需的一切： 

$ express myApp
复制代码

接下来，安装 Nodemon ，它会在我们进行任何更改时自动重新加载应用程序。每当对源代码进行更改时，都需要重新启动Node.js应用程序。Nodemon将自动监视更改并为我们重新启动应用程序。由于我们希望用nodemon作命令行工具，我们将使用-g标志全局安装： 

$ sudo npm install nodemon -g
复制代码

要完成应用程序的设置，请切换到应用程序目录并安装依赖项，如下所示： 

$ cd myApp
$ npm install
复制代码

默认情况下，使用 express-generator 在端口3000上运行创建的应用程序，因此我们需要确保防火墙不阻止该端口。要打开端口3000，请运行以下命令： 

$ sudo ufw allow 3000
复制代码

我们现在拥有启动Web应用程序所需的一切。为此，请运行以下命令： 

$ nodemon bin/www
复制代码

这将启动在端口3000上运行的应用程序。我们可以通过访问Web浏览器来测试它是否正常工作。你应该看到这样的东西： http://your_server_ip:3000

img
localhost:3000

目前为止我们一直使用的SSH会话，并且当前正在运行应用程序作为会话A.我们将使用新的SSH会话来运行命令和编辑文件，我们将此会话称为会话B.除非另有说明，否则所有剩余命令应在会话B中运行。

第二步，自定义Node.js应用程序

创建的默认应用程序在express-generator启动方面做得很好，甚至包括我们用于记录有关HTTP请求的数据的Morgan HTTP日志记录中间件。由于Morgan支持输出流，因此它与Winston内置的流支持很好地配对，使我们能够将HTTP请求数据日志与Winston记录的任何其他内容进行整合。

默认情况下，express-generator样板文件在引用包时使用变量 记录器 morgan。由于我们将使用morgan和winston，这两个都是记录包，调用其中一个 记录器 都会变得很困惑。因此，让我们通过编辑app.js项目根目录中的文件并进行一些更改来改变它。

要打开app.js进行编辑，请使用以下nano命令： 

$ nano \~/myApp/app.js
复制代码

在文件顶部附近找到以下行：

~/myApp/app.js 

...
var logger = require('morgan');
...
复制代码

将其更改为以下内容：

~/myApp/app.js 

...
var morgan = require('morgan');
...
复制代码

我们还需要找到文件中引用变量 记录器 的位置并将其更改为morgan。在我们使用它时，让我们将morgan包使用的日志格式更改combined为标准的Apache日志格式，并在日志中包含有用信息，例如远程IP地址和用户代理HTTP请求标头。

为此，请找到以下行：

~/myApp/app.js 

...
app.use(logger('dev'));
...
复制代码

将其更改为以下内容：

~/myApp/app.js 

...
app.use(morgan('combined'));
...
复制代码

在我们集成Winston配置后，这些更改将有助于我们更好地了解日志包。通过输入CTRL-X，然后Y，然后ENTER来退出并保存文件。

现在我们的应用程序已经建立，我们已准备好开始Winston配置。

第三步， 安装和配置Winston

我们现在准备安装和配置Winston。在这一步，我们将探讨作为winston软件包的一些配置选项，并创建一个将信息记录到文件和控制台的记录器。

要安装，请winston运行以下命令： 

$ cd ~/myApp
$ npm install winston
复制代码

创建一个包含winston配置的config文件夹： 

$ mkdir ~/myApp/config
复制代码

现在让我们创建包含我们winston配置的文件，我们将调用它winston.js： 

$ touch ~/myApp/config/winston.js
复制代码

接下来，创建一个包含日志文件的文件夹： 

$ mkdir ~/myApp/logs
复制代码

最后，让我们安装 app-root-path 。此程序包与Winston没有直接关系，但在Node.js代码中指定文件路径时会有很大帮助。我们将使用它来指定项目根目录中的Winston日志文件的位置，并避免丑陋的相对路径语法： 

$ npm install app-root-path --save
复制代码

我们需要配置我们想要如何处理日志记录的所有内容，因此我们可以继续定义配置设置。首先打开 ~/myApp/config/winston.js 编辑： 

$ nano ~/myApp/config/winston.js
复制代码

接下来，需要 app-root-path 和 winston 包：

~/myApp/config/winston.js 

var appRoot = require('app-root-path');
var winston = require('winston');
复制代码

有了这些变量，我们可以为传输定义配置设置。传输是Winston引入的一个概念，它指的是用于日志的存储/输出机制。Winston带有三个核心传输元素- 控制台 ， 文件 和 HTTP 。本教程专注于控制台和文件传输：控制台传输将信息记录传输到控制台，文件传输将信息记录传输到指定的文件。每个传输定义都可以包含自己的配置设置，例如文件大小，日志级别和日志格式。以下是我们将使用的每个传输设置的快速摘要：

  • level - 要记录的消息级别。
  • filename - 用于将日志数据写入的文件。
  • handleExceptions - 捕获并记录未处理的异常。
  • json - 以JSON格式记录日志数据。
  • maxsize - 在创建新文件之前，日志文件的最大大小（以字节为单位）。
  • maxFiles - 限制超出日志文件大小时创建的文件数。
  • colorize - 着色输出。这在查看控制台日志时很有用。

记录级别 表示消息优先级，并由整数表示。Winston使用npm优先级从0到5（从最高到最低）的日志记录级别：

  • 0 ：error
  • 1 ：warn
  • 2 ：info
  • 3 ：verbose
  • 4 ：debug
  • 5 ：silly

指定特定传输的日志记录级别时，将记录该级别或更高级别的任何内容。例如，通过指定信息级别，将记录级别为错误，警告或信息的任何内容。调用记录器时指定了日志级别，这意味着我们可以执行以下操作来记录错误：logger.error('test error message').

我们可以在配置中定义file和console传输的配置设置，winston如下所示：

~/myApp/config/winston.js 

...
var options = {
  file: {
    level: 'info',
    filename: `${appRoot}/logs/app.log`,
    handleExceptions: true,
    json: true,
    maxsize: 5242880, // 5MB
    maxFiles: 5,
    colorize: false,
  },
  console: {
    level: 'debug',
    handleExceptions: true,
    json: false,
    colorize: true,
  },
};
复制代码

接下来，使用 options 变量中定义的属性实例化具有文件和控制台传输的新 winston 记录器：

~/myApp/config/winston.js 

...
var logger = new winston.Logger({
  transports: [
    new winston.transports.File(options.file),
    new winston.transports.Console(options.console)
  ],
  exitOnError: false, // do not exit on handled exceptions
});
复制代码

默认情况下，只有morgan输出到控制台，所以让我们定义一个流函数，它可以将morgan生成的输出生成到winston日志文件中。我们将使用该info级别，因此输出将由两个传输（文件和控制台）拾取：

~/myApp/config/winston.js 

...
logger.stream = {
  write: function(message, encoding) {
    logger.info(message);
  },
};
复制代码

最后，导出记录器，以便它可以在应用程序的其他部分中使用：

~/myApp/config/winston.js 

...
module.exports = logger;
复制代码

完成的winston配置文件应如下所示：

~/myApp/config/winston.js 

var appRoot = require('app-root-path');
var winston = require('winston');

// define the custom settings for each transport (file, console)
var options = {
  file: {
    level: 'info',
    filename: `${appRoot}/logs/app.log`,
    handleExceptions: true,
    json: true,
    maxsize: 5242880, // 5MB
    maxFiles: 5,
    colorize: false,
  },
  console: {
    level: 'debug',
    handleExceptions: true,
    json: false,
    colorize: true,
  },
};

// instantiate a new Winston Logger with the settings defined above
var logger = new winston.Logger({
  transports: [
    new winston.transports.File(options.file),
    new winston.transports.Console(options.console)
  ],
  exitOnError: false, // do not exit on handled exceptions
});

// create a stream object with a 'write' function that will be used by `morgan`
logger.stream = {
  write: function(message, encoding) {
    // use the 'info' log level so the output will be picked up by both transports (file and console)
    logger.info(message);
  },
};

module.exports = logger;
复制代码

退出并保存文件。我们现在配置了记录器，但我们的应用程序仍然没有意识到它或如何使用它。我们现在将记录器与应用程序集成在一起。

第四步， 将Winston与应用程序集成

我们已经在步骤2中看到我们app.js中的快速配置，所以让我们将记录器导入到该文件中。运行以下命令打开文件进行编辑： 

$ nano ~/myApp/app.js
复制代码

winston使用其他命令语句在文件顶部附近导入：

~/myApp/app.js 

...
var winston = require('./config/winston');
...
复制代码

我们实际使用 winston 的第一个地方是 morgan 。我们将使用 stream 选项，并将其设置为我们在 winston 配置中创建的流接口。为此，请找到以下行：

~/myApp/app.js 

...
app.use(morgan('combined'));
...
复制代码

把它改成这个：

~/myApp/app.js 

...
app.use(morgan('combined', { stream: winston.stream }));
...
复制代码

退出并保存文件。

我们将看到一些日志数据了！如果您在Web浏览器中重新加载页面，您应该在SSH会话A的控制台中看到类似于以下内容的内容： 

[nodemon] restarting due to changes...
[nodemon] starting `node bin/www`
info: ::ffff:72.80.124.207 - - [07/Mar/2018:17:29:36 +0000] "GET / HTTP/1.1" 304 - "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.186 Safari/537.36"

info: ::ffff:72.80.124.207 - - [07/Mar/2018:17:29:37 +0000] "GET /stylesheets/style.css HTTP/1.1" 304 - "http://167.99.4.120:3000/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.186 Safari/537.36"
复制代码

这里有两个日志条目 -第一个用于HTML页面的请求，第二个用于附带的样式表。由于每个传输都配置为处理 info 级别日志数据，我们还应该在位于 \~/myApp/logs/app.log 的文件传输中看到类似的信息。但是，文件传输中的输出应该写为JSON对象，因为我们 json:true 在文件传输配置中指定了它。您可以在我们的 JSON教程简介中 了解有关JSON的更多信息。要查看日志文件的内容，请运行以下命令： 

$ tail ~/myApp/logs/app.log
复制代码

您应该看到类似于以下内容的内容： 

{"level":"info","message":"::ffff:72.80.124.207 - - [07/Mar/2018:17:29:36 +0000] \"GET / HTTP/1.1\" 304 - \"-\" \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.186 Safari/537.36\"\n","timestamp":"2018-03-07T17:29:36.962Z"}
{"level":"info","message":"::ffff:72.80.124.207 - - [07/Mar/2018:17:29:37 +0000] \"GET /stylesheets/style.css HTTP/1.1\" 304 - \"http://167.99.4.120:3000/\" \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.186 Safari/537.36\"\n","timestamp":"2018-03-07T17:29:37.067Z"}
复制代码

到目前为止，我们的记录器只记录HTTP请求和相关数据。这是我们日志中非常重要的信息，有时候我们需要记录自定义日志消息来记录错误或分析数据库查询性能。为了说明我们如何做到记录自定义日志消息，让我们从错误处理程序路由调用记录器。

该express-generator软件包默认包含404和500错误处理程序路由，因此我们将使用它。打开~/myApp/app.js文件： 

$ nano ~/myApp/app.js
复制代码

找到文件底部的代码块，如下所示：







请到「今天看啥」查看全文


推荐文章
北美留学生观察  ·  日本县城高中，挤满中国中产娃...
6 小时前
北美留学生观察  ·  别被骗了！欧洲人日常喝的甜白葡萄酒，一瓶也就几十块，还是梵高联名！
昨天
BioArt  ·  北京大学生命科学学院胡家志实验室招聘博士后研究人员启事
昨天
北美留学生观察  ·  藤校进入9万美元时代！扩招、涨价、割中产娃韭菜…
2 天前
BioArt  ·  Cell | 转录起始图谱揭示早期哺乳动物发育中基因和转座子表达的调控机制
3 天前
MacTalk  ·  只要努力工作，人生很快就过去了
8 年前
互联网新鲜事  ·  愚人节，这有一个史上最强坑人套路！
7 年前
IT时代网  ·  太特么尴尬了：低头捡不到钱，抢劫一次赔一次
7 年前
相约新会  ·  【扩散周知】双水将新建一个新小区！规划314户！选址就在……
7 年前
天下说法  ·  益阳市原市委书记胡忠雄遭实名举报（附证据）
7 年前
Sov5搜索   ·   小百科   ·   今天看啥   ·   移动版
51好读 - 好文章就要读起来!