この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/runtime/nodejs-metrics/
翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）
Node.jsランタイムメトリクスに関するセマンティック規約
ステータス: Development
この文書では、OpenTelemetryにおけるNode.jsランタイムメトリクスに関するセマンティック規約を定義します。
Description: nodejsの下で取得される、開発中のNode.jsランタイムメトリクス。
注記: イベントループの遅延に関するメトリクスは、単一のヒストグラムではなく個別の値に分割されています。これは、Node.jsランタイムがperf_hooks.monitorEventLoopDelay([options])を通じて単一の値のみを返し、ヒストグラム全体を返さないため、OpenTelemetryのヒストグラムに変換できないことによります。
メトリクス: nodejs.eventloop.delay.min
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.min | Gauge | s | イベントループの最小遅延。[1] |  |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.minの値から取得できます。
メトリクス: nodejs.eventloop.delay.max
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.max | Gauge | s | イベントループの最大遅延。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.maxの値から取得できます。
メトリクス: nodejs.eventloop.delay.mean
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.mean | Gauge | s | イベントループの平均遅延。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.meanの値から取得できます。
メトリクス: nodejs.eventloop.delay.stddev
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.stddev | Gauge | s | イベントループの遅延の標準偏差。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.stddevの値から取得できます。
メトリクス: nodejs.eventloop.delay.p50
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.p50 | Gauge | s | イベントループの50パーセンタイル遅延。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.percentile(50)の値から取得できます。
メトリクス: nodejs.eventloop.delay.p90
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.p90 | Gauge | s | イベントループの90パーセンタイル遅延。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.percentile(90)の値から取得できます。
メトリクス: nodejs.eventloop.delay.p99
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.delay.p99 | Gauge | s | イベントループの99パーセンタイル遅延。[1] | |
[1]: 値はperf_hooks.monitorEventLoopDelay([options])のhistogram.percentile(99)の値から取得できます。
メトリクス: nodejs.eventloop.utilization
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.utilization | Gauge | 1 | イベントループの利用率。[1] | |
[1]: 値の範囲は[0.0, 1.0]であり、performance.eventLoopUtilization([utilization1[, utilization2]])から取得できます。
メトリクス: nodejs.eventloop.time
このメトリクスは推奨です。
| Name | Instrument Type | Unit (UCUM) | Description | Stability | Entity Associations |
|---|---|---|---|---|---|
nodejs.eventloop.time | Counter | s | イベントループが各状態にあった時間の累積。[1] | |
[1]: 値はperformance.eventLoopUtilization([utilization1[, utilization2]])から取得できます。
Attributes:
| Key | Stability | Requirement Level | Value Type | Description | Example Values |
|---|---|---|---|---|---|
nodejs.eventloop.state | | Required | string | イベントループ時間の状態。 | active; idle |
nodejs.eventloop.stateには、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。
| Value | Description | Stability |
|---|---|---|
active | アクティブな時間。 | |
idle | アイドルな時間。 | |