Node.js精进(7)——日志

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: Node.js精进(7)——日志

在 Node.js 中,提供了console模块,这是一个简单的调试控制台,其功能类似于浏览器提供的 JavaScript 控制台。

  本系列所有的示例源码都已上传至Github,点击此处获取。


一、原理


  与浏览器一样,Node.js 也提供了一个全局变量 console(实例化 Console 类),可调用 log()、error() 等方法。

1)同步还是异步

  console 的方法既不像浏览器中那样始终同步,也不像 Node.js 中的流那样始终异步。

  是否为同步取决于链接的是什么流以及操作系统是 Windows 还是 POSIX:

  • 文件:在 Windows 和 POSIX 中都是同步。
  • TTY(终端):在 Windows 上是异步,在 POSIX 上是同步。
  • 管道和套接字:在 Windows 上是同步,在 POSIX 上是异步。

  可移植操作系统接口(Portable Operating System Interface,缩写为POSIX)是 IEEE 为要在各种 UNIX 操作系统上运行软件,而定义API的一系列互相关联的标准的总称。

  console 的这些行为部分是出于历史原因,因为一旦将它们更改,那么会导致向后不兼容(即不兼容旧版本)。

  注意,同步写入会阻塞事件循环,直至写入完成。

  在输出到文件的情况下,这可能几乎是瞬时的。

  但在系统负载高、接收端未读取管道或终端或文件系统速度较慢的情况下,事件循环可能经常被阻塞足够长,足以对性能产生严重的负面影响。

2)log() 和 error()

  在src/lib/internal/console/constructor.js中,存储着 console.log() 和 console.error() 两个方法的源码。

  下面是删减过的源码,可以看到在输出之前会自动加换行符,并且 log() 和 error() 使用的输出方法还不同。

function(streamSymbol, string) {
  const groupIndent = this[kGroupIndent];
  const useStdout = streamSymbol === kUseStdout;
  // 若是普通输出,则用 process.stdout 输出,若是错误,则用 process.stderr 输出
  const stream = useStdout ? this._stdout : this._stderr;
  const errorHandler = useStdout
    ? this._stdoutErrorHandler
    : this._stderrErrorHandler;
  if (groupIndent.length !== 0) {
    if (StringPrototypeIncludes(string, "\n")) {
      string = StringPrototypeReplace(string, /\n/g, `\n${groupIndent}`);
    }
    string = groupIndent + string;
  }
  // 末尾加换行
  string += "\n";
  try {
    // 控制台输出
    stream.write(string, errorHandler);
  } catch (e) {
    // Console is a debugging utility, so it swallowing errors is not
    // desirable even in edge cases such as low stack space.
    if (isStackOverflowError(e)) throw e;
    // Sorry, there's no proper way to pass along the error here.
  } finally {
    stream.removeListener("error", noop);
  }
}

  若是 log() 输出,则用 process.stdout.write() 方法;若是 error() 输出,则用 process.stderr.write() 方法。

  process.stdout 返回的是一个流,配合 util 模块的inspect()方法,可将对象解析成字符串,并在控制台着色,如下所示。

const util = require('util');

const str = util.inspect({ name: "strick" }, { colors: true });

process.stdout.write(str +'\n');

  


二、bunyan.js


  目前在我们的项目中,使用的日志库是bunyan.js,这个库不仅支持终端和 Node.js 环境,还支持浏览器环境。

1)原理

  从 Github 上下载源码后,可以看到 bin 和 lib 两个目录,终端的代码存于前者,项目中引用的代码存于后者。

  下面是一个简单的示例,引入后也不用实例化,可直接调用方法,log.info() 相当于 console.log(),不过前者会自动将对象转换成字符串。

const bunyan = require('bunyan');
const log = bunyan.createLogger({name: "example"});
log.info("strick");

  在日志内部,会为每条日志维护一个对象,像上面的 strick 字符串,在内部生成的对象格式如下。

{
  name: 'example',
  hostname: '192.168.0.101',
  pid: 94371,
  level: 30,
  msg: 'strick',
  time: 2022-05-11T07:21:51.310Z,
  v: 0
}

  下面是日志输出的核心代码(已做删减),其中 s.stream 使用的也是 process.stdout 类。

  fastAndSafeJsonStringify() 函数用于将对象转换成字符串,它的工作原理会在后文分析。

Logger.prototype._emit = function (rec, noemit) {
  var i;
  // 将对象转换成字符串
  var str;
  if (noemit || this.haveNonRawStreams) {
    str = fastAndSafeJsonStringify(rec) + os.EOL;
  }
  if (noemit) return str;
  var level = rec.level;
  for (i = 0; i < this.streams.length; i++) {
    var s = this.streams[i];
    if (s.level <= level) {
      // 输出原始对象或字符串
      s.stream.write(s.raw ? rec : str);
    }
  }
  return str;
};

  默认运行 node src.js,在控制台输出时是没有着色的,不便于阅读。

  在本地调试 bunyan 库时,可以加 node src.js | ../bin/bunyan,执行此命令后,不仅能着色,还会格式化成可读性更高的字符串,如下所示。

  

  注意,在项目中加载此库后,命令中就不需要加路径了,例如 node index.js | bunyan。

2)fastAndSafeJsonStringify()

  此函数会在 JSON 对象序列化时,处理对象中的循环和 getter 异常,如下所示。

  第一组 try-catch 用于处理JSON.stringify()的异常,第二组 try-catch 用于处理 JSON.stringify(rec, safeCycles()) 的异常。

  最后会判断是否安装了safe-json-stringify库,若安装就用该库处理,否则就输出报错信息。

function fastAndSafeJsonStringify(rec) {
  try {
    return JSON.stringify(rec);
  } catch (ex) {
    try {
      return JSON.stringify(rec, safeCycles());
    } catch (e) {
      // 安装了 safe-json-stringify 库
      if (safeJsonStringify) {
        return safeJsonStringify(rec);
      } else {
        var dedupKey = e.stack.split(/\n/g, 3).join("\n");
        _warn(
          "bunyan: ERROR: Exception in " +
            "`JSON.stringify(rec)`. You can install the " +
            '"safe-json-stringify" module to have Bunyan fallback ' +
            "to safer stringification. Record:\n" +
            _indent(format("%s\n%s", util.inspect(rec), e.stack)),
          dedupKey
        );
        return format(
          "(Exception in JSON.stringify(rec): %j. " +
            "See stderr for details.)",
          e.message
        );
      }
    }
  }
}

  接下来看一个循环引用的例子,如下所示,在调用 JSON.stringify() 方法时会报错:TypeError: Converting circular structure to JSON。

  一般自己写的 JSON 对象很少会出现循环引用,但是在一些比较复杂的对象内部有可能会出现。

const man = {
  child: {}
}
man.child = man;
JSON.stringify(man);

  在 bunyan.js 的内部给出了两种解决方案,一种是用Set数据类型处理,另一种是用数组处理。

  解决思路其实差不多,都是依次将属性值加到数据结构中,当判断到已存在时,就返回 [Circular],终止其后面属性的序列化。

var safeCycles = typeof (Set) !== 'undefined' ? safeCyclesSet : safeCyclesArray;
// Set 方式
function safeCyclesSet() {
  var seen = new Set();
  return function (key, val) {
    // 若 value 不存在或不是对象类型,则返回该值
    if (!val || typeof val !== "object") {
      return val;
    }
    // 若 seen 中包含该值,则返回 [Circular]
    if (seen.has(val)) {
      return "[Circular]";
    }
    seen.add(val);
    return val;
  };
}
// 数组方式
function safeCyclesArray() {
  var seen = [];
  return function (key, val) {
    if (!val || typeof val !== "object") {
      return val;
    }
    if (seen.indexOf(val) !== -1) {
      return "[Circular]";
    }
    seen.push(val);
    return val;
  };
}

  JSON.stringify() 方法的第二个参数是一个回调,被序列化的值的每个属性都会经过该函数的处理。

  在调用 safeCyclesSet() 函数后,就能输出 {"child":"[Circular]"}。

JSON.stringify(man, safeCyclesSet());  // {"child":"[Circular]"}

 

 

参考资料:

日志模块

process对象

官网 processconsole

相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
4月前
|
Kubernetes Ubuntu Windows
【Azure K8S | AKS】分享从AKS集群的Node中查看日志的方法(/var/log)
【Azure K8S | AKS】分享从AKS集群的Node中查看日志的方法(/var/log)
143 3
|
4月前
|
缓存 中间件
Nest.js 实战 (九):使用拦截器记录用户 CURD 操作日志
这篇文章介绍了在Nest.js中如何实现记录用户CURD操作的需求。首先解释了什么是拦截器以及拦截器的作用,然后通过创建Prisma模型,添加Log模型,并通过编写LoggerInterceptor拦截器,实现了记录用户操作的功能。最后通过效果演示和总结,强调了使用拦截器实现此功能的有效性。
|
1月前
|
JSON 监控 JavaScript
Node.js-API 限流与日志优化
Node.js-API 限流与日志优化
|
4月前
|
SQL 运维 监控
Nest.js 实战 (十):使用 winston 打印和收集日志记录
这篇文章介绍了在Nest服务中如何使用Winston记录日志。文章首先强调了日志记录在后台服务中的重要性,接着提到Nest默认的内部日志记录器,并指出可以通过@nestjs/common包中的Logger类来全面控制日志系统的行为。文章还提到,为了在生产环境中实现更高级的日志功能,可以使用如Winston之类的Node.js日志包。接下来,文章介绍了如何在Nest服务中使用Winston记录日志,包括安装相关依赖、创建winston配置文件以及实现简单的日志记录示例。最后,文章指出更高级的自定义日志功能需要读者自己去探索。
161 2
Nest.js 实战 (十):使用 winston 打印和收集日志记录
|
4月前
|
JavaScript Serverless Linux
函数计算产品使用问题之遇到Node.js环境下的请求日志没有正常输出时,该如何排查
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。
|
4月前
|
SQL JavaScript 前端开发
【Azure 应用服务】Azure JS Function 异步方法中执行SQL查询后,Callback函数中日志无法输出问题
【Azure 应用服务】Azure JS Function 异步方法中执行SQL查询后,Callback函数中日志无法输出问题
|
1月前
|
JavaScript 前端开发
JavaScript中的原型 保姆级文章一文搞懂
本文详细解析了JavaScript中的原型概念,从构造函数、原型对象、`__proto__`属性、`constructor`属性到原型链,层层递进地解释了JavaScript如何通过原型实现继承机制。适合初学者深入理解JS面向对象编程的核心原理。
26 1
JavaScript中的原型 保姆级文章一文搞懂
|
5月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的客户关系管理系统附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的客户关系管理系统附带文章源码部署视频讲解等
105 2
|
29天前
JS+CSS3文章内容背景黑白切换源码
JS+CSS3文章内容背景黑白切换源码是一款基于JS+CSS3制作的简单网页文章文字内容背景颜色黑白切换效果。
18 0
|
5月前
|
JavaScript Java 测试技术
基于springboot+vue.js+uniapp的小区物流配送系统附带文章源码部署视频讲解等
基于springboot+vue.js+uniapp的小区物流配送系统附带文章源码部署视频讲解等
152 4