Node.js Runtime 指标的语义约定

状态：开发中

本文档描述了 OpenTelemetry 中 Node.js Runtime 指标的语义约定。

描述： 处于开发阶段的 Node.js Runtime 指标，捕获在 nodejs 下。

注意：事件循环延迟的指标被分成单独的值，而不是一个直方图，因为 Node.js 运行时只能通过 perf_hooks.monitorEventLoopDelay([options]) 返回单个值，而不是整个直方图，因此无法将其转换为 OpenTelemetry 直方图。

指标: nodejs.eventloop.delay.min

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.min	Gauge	s	事件循环的最小延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.min 值中检索。

指标: nodejs.eventloop.delay.max

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.max	Gauge	s	事件循环的最大延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.max 值中检索。

指标: nodejs.eventloop.delay.mean

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.mean	Gauge	s	事件循环的平均延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.mean 值中检索。

指标: nodejs.eventloop.delay.stddev

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.stddev	Gauge	s	事件循环的标准差延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.stddev 值中检索。

指标: nodejs.eventloop.delay.p50

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.p50	Gauge	s	事件循环的 50% 百分位延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.percentile(50) 值中检索。

指标: nodejs.eventloop.delay.p90

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.p90	Gauge	s	事件循环的 90% 百分位延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.percentile(90) 值中检索。

指标: nodejs.eventloop.delay.p99

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.delay.p99	Gauge	s	事件循环的 99% 百分位延迟。[1]

[1]: 值可以从 perf_hooks.monitorEventLoopDelay([options]) 的 histogram.percentile(99) 值中检索。

指标: nodejs.eventloop.utilization

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.utilization	Gauge	1	事件循环的利用率。[1]

[1]: 值范围为 [0.0, 1.0]，可以从 performance.eventLoopUtilization([utilization1[, utilization2]]) 检索。

指标: nodejs.eventloop.time

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
nodejs.eventloop.time	Counter	s	事件循环在每个状态下的累计持续时间。[1]

[1]: 值可以从 performance.eventLoopUtilization([utilization1[, utilization2]]) 检索。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
nodejs.eventloop.state		必需	字符串	事件循环时间的状态。	active; idle

nodejs.eventloop.state 具有以下一组预定义值。如果其中一个适用，则必须使用相应的预定义值；否则，可以使用自定义值。

值	描述	Stability
active	活动时间。
idle	空闲时间。