# ランタイム環境に関するセマンティック規約

> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/runtime/


# ランタイム環境に関するセマンティック規約

**ステータス**: [Development][DocumentStatus]

この文書では、ランタイム環境のスパン、メトリクス、ログに関するセマンティック規約を定義します。

## メトリクス

ランタイム環境は、用語、実装、そして特定のメトリクスに対する相対的な値において大きく異なります。例えばGoとPythonはどちらもガーベジコレクションを行う言語ですが、GoランタイムとCPythonランタイムのヒープ使用量を直接比較することに意味はありません。このため、この文書では標準的なトップレベルのランタイムメトリクスInstrumentを提案しません。詳しい議論は[OTEP 108](https://github.com/open-telemetry/oteps/pull/108/files)を参照してください。

特定のランタイム環境に固有のメトリクスには、そのランタイムのトップレベルの名前空間`{environment}.*`（例えば`jvm.*`）を接頭辞として付け、[汎用のメトリクスセマンティック規約のガイドライン](/works/otel-specs-ja/semconv/general/metrics/#一般的なガイドライン)に従うべきです（SHOULD）。

ランタイム計装の作者は、メトリクスの名前や値を解釈する際に曖昧さが生じないよう、`{environment}`の選び方に責任を持ちます。

例えば一部のプログラミング言語には、実装が大きく異なる複数のランタイム環境があります。[Pythonには多くの実装があります](https://www.python.org/download/alternatives)。そのような言語では、曖昧さを避けるために`cpython.*`や`pypy.*`のような特定の`{environment}`接頭辞を使うことを検討してください。

また、ランタイム環境を計装する際は、[汎用メトリクス](/works/otel-specs-ja/semconv/general/metrics/#一般的なガイドライン)、[システムメトリクス](/works/otel-specs-ja/semconv/system/system-metrics/)、[OSプロセスメトリクス](/works/otel-specs-ja/semconv/system/process-metrics/)のセマンティック規約も考慮してください。

- [CPython](/works/otel-specs-ja/semconv/runtime/cpython-metrics/)
- [Go](/works/otel-specs-ja/semconv/runtime/go-metrics/)
- [JVM](/works/otel-specs-ja/semconv/runtime/jvm-metrics/)
- [Node.js](/works/otel-specs-ja/semconv/runtime/nodejs-metrics/)
- [V8 JSエンジン](/works/otel-specs-ja/semconv/runtime/v8js-metrics/)
- [.NET](/works/otel-specs-ja/semconv/runtime/dotnet-metrics/)

### 属性

[`process.runtime`](/works/otel-specs-ja/semconv/resource/process/#プロセスランタイム)リソース属性は、適切であればランタイムメトリクスイベントに含めるべきです（SHOULD）。

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status

- [.NET](/works/otel-specs-ja/semconv/runtime/dotnet-metrics/)
- [CPython](/works/otel-specs-ja/semconv/runtime/cpython-metrics/)
- [Go](/works/otel-specs-ja/semconv/runtime/go-metrics/)
- [JVM](/works/otel-specs-ja/semconv/runtime/jvm-metrics/)
- [Node.js](/works/otel-specs-ja/semconv/runtime/nodejs-metrics/)
- [V8 JSエンジン](/works/otel-specs-ja/semconv/runtime/v8js-metrics/)