Node.js v18.12.1 documentation

Diagnostics Channel诊断频道#

Source Code: lib/diagnostics_channel.js

The node:diagnostics_channel module provides an API to create named channels to report arbitrary message data for diagnostics purposes.node:diagnostics_channel模块提供了一个API，用于创建命名通道，以报告任意消息数据以用于诊断。

It can be accessed using:可通过以下方式访问：

import diagnostics_channel from 'node:diagnostics_channel';const diagnostics_channel = require('node:diagnostics_channel');

It is intended that a module writer wanting to report diagnostics messages will create one or many top-level channels to report messages through. 希望报告诊断消息的模块编写器将创建一个或多个顶级通道来报告消息。Channels may also be acquired at runtime but it is not encouraged due to the additional overhead of doing so. 信道也可以在运行时获取，但由于这样做的额外开销，不鼓励这样做。Channels may be exported for convenience, but as long as the name is known it can be acquired anywhere.为了方便，可以导出频道，但只要知道名称，就可以在任何地方获取。

If you intend for your module to produce diagnostics data for others to consume it is recommended that you include documentation of what named channels are used along with the shape of the message data. 如果您打算让您的模块生成诊断数据供其他人使用，建议您包含所使用的命名通道的文档以及消息数据的形状。Channel names should generally include the module name to avoid collisions with data from other modules.通道名称通常应包括模块名称，以避免与来自其他模块的数据发生冲突。