この記事は英語の原文を日本語に翻訳したものです。原文: https://opentelemetry.io/docs/specs/semconv/resource/process/

翻訳元: open-telemetry/semantic-conventions v1.44.0（コミット e10a930）

Processおよびプロセスランタイムリソース

Status: Development

Process

Status:

type: process

Description: オペレーティングシステムのプロセス。

Attributes:

Role	Key	Stability	Requirement Level	Value Type	Description	Example Values
Identity	process.creation.time		Required	string	プロセスが生成された日時。ISO 8601形式。	2023-11-21T09:25:34.853Z
Identity	process.pid		Required	int	プロセス識別子（PID）。	1234
Description	process.command		Recommended	string	プロセスを起動するために使われたコマンド（すなわちコマンド名）。Linuxベースのシステムでは、proc/[pid]/cmdline の0番目の文字列に設定できます。Windowsでは、GetCommandLineW から抽出された最初のパラメータに設定できます。	cmd/otelcol
Description	process.owner		Recommended	string	プロセスを所有するユーザーのユーザー名。	root
Description	process.args_count		Opt-In	int	process.command_args配列の長さ。[1]	4
Description	process.command_args		Opt-In	string[]	プロセスが受け取った、すべてのコマンド引数（コマンドや実行ファイル自体を含む）。Linuxベースのシステム（およびprocfsをサポートする一部の他のUnix系システム）では、proc/[pid]/cmdline から抽出されたnull区切り文字列のリストに従って設定できます。libcベースの実行ファイルの場合、これは main に渡される完全なargvベクトルになります。機密データを除外するサニタイズが行われていない限り、デフォルトでは収集すべきではありません（SHOULD NOT）。	["cmd/otecol", "--config=config.yaml"]
Description	process.command_line		Opt-In	string	プロセスを起動するために使われた完全なコマンドを表す単一の文字列。Windowsでは、GetCommandLineW の結果に設定できます。監視のためだけに組み立てる必要がある場合はこれを設定せず、代わりに process.command_args を使ってください。機密データを除外するサニタイズが行われていない限り、デフォルトでは収集すべきではありません（SHOULD NOT）。	C:\cmd\otecol --config="my directory\config.yaml"
Description	process.interactive		Opt-In	boolean	プロセスが対話的シェルに接続されているかどうか。
Description	process.linux.cgroup		Opt-In	string	プロセスに関連付けられたコントロールグループ。[2]	1:name=systemd:/user.slice/user-1000.slice/session-3.scope; 0::/user.slice/user-1000.slice/user@1000.service/tmux-spawn-0267755b-4639-4a27-90ed-f19f88e53748.scope
Description	process.parent_pid		Opt-In	int	親プロセス識別子（PPID）。	111
Description	process.title		Opt-In	string	プロセスタイトル（proctitle）。[3]	cat /etc/hostname; xfce4-session; bash
Description	process.working_directory		Opt-In	string	プロセスの作業ディレクトリ。	/root

[1] process.args_count: このフィールドは、プロセスの起動時にいくつの引数が渡されたかを問い合わせたり、バケット分析したりする際に役立ちます。引数が多いことは、疑わしい活動の兆候である場合があります。

[2] process.linux.cgroup: コントロールグループ（cgroups）は、プロセスリソースを整理・管理するために使われるカーネル機能です。この属性は、そのプロセスに関連付けられたcgroupへのパスを提供し、/proc/[PID]/cgroupファイルの内容と一致すべきです（SHOULD）。

[3] process.title: 多くのUnix系システムでは、プロセスタイトル（proctitle）は、ps、top、htopのようなシステム監視ツールによって表示される、実行中のプロセスの名前またはコマンドラインを表す文字列です。

プロセスコマンド属性の選び方

コマンド情報を提供する場合は、process.command_argsを優先してください。process.command_lineは、ネイティブの形式が単一の文字列であるシステムでのみ使用してください。サニタイズやプライバシーの都合でコマンド引数を収集できない場合は、代わりにprocess.commandをprocess.args_countと組み合わせて使用してください。

プロセスランタイム

Status:

type: process.runtime

Description: 監視対象となる単一の（言語）ランタイムインスタンス。

Attributes:

Role	Key	Stability	Requirement Level	Value Type	Description	Example Values
Identity	process.runtime.name		Recommended	string	このプロセスのランタイムの名前。	OpenJDK Runtime Environment
Identity	process.runtime.version		Recommended	string	このプロセスのランタイムのバージョン。ランタイムが変更なしに返す値。	14.0.2
Description	process.runtime.description		Recommended	string	プロセスのランタイムに関する追加の説明。例えば、ランタイム環境に対する特定ベンダーによるカスタマイズなど。	Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0

これらの属性を特定のランタイム種別に対してどう設定するかは、以下の節で説明します。

これらの属性に加えて、telemetry.sdk.languageを使うことで、使用されているランタイムの大まかな種類を判定できます。

Erlangランタイム

• process.runtime.name - 使用されているErlang VMの名前。すなわち erlang:system_info(machine)。
• process.runtime.version - ランタイム（ERTS - Erlang Runtime System）のバージョン。すなわち erlang:system_info(version)。
• process.runtime.description - string | OTPバージョン（すなわち erlang:system_info(otp_release)）とERTSバージョンを組み合わせて作られる、ランタイムに関する追加の説明。

例:

Goランタイム

Goランタイムは、次のように値を設定すべきです（SHOULD）。

• process.runtime.name - Goのruntime.Compiler定数を、次の規則に従って解釈した値を設定します。 値が gc の場合は go を設定します。それ以外の場合は runtime.Compiler の値をそのまま設定します。

  これは、次のGoスニペットで実装できます。

  import "runtime"
  
  func getRuntimeName() string {
    if runtime.Compiler == "gc" {
      return "go"
    }
    return runtime.Compiler
  }
  

• process.runtime.version - runtime.Version() が返す値をそのまま設定します。例えば go1.17。

• process.runtime.description - このフィールドの使用は推奨されません。

一部のGoコンパイラ・ランタイムの例:

Javaランタイム

Javaの計装は、システムプロパティから値をコピーして設定すべきです（SHOULD）。

• process.runtime.name - java.runtime.name の値をそのまま設定します。
• process.runtime.version - java.runtime.version の値をそのまま設定します。
• process.runtime.description - java.vm.vendor、java.vm.name、java.vm.version の値を、 この順序でスペース区切りにして設定します。

一部のJavaランタイムの例

JavaScriptランタイム

JavaScriptの計装は、組み込みのランタイム定数から値をコピーして設定すべきです（SHOULD）。

• process.runtime.name:
  • ランタイムがNode.jsの場合、定数値 nodejs を設定します。
  • ランタイムがWebブラウザの場合、定数値 browser を設定します。
• process.runtime.version:
  • ランタイムがNode.jsの場合、process.versions.node の値を設定します。
  • ランタイムがWebブラウザの場合、navigator.userAgent の値を設定します。

一部のJavaScriptランタイムの例

.NETランタイム

.NETの計装は、次の値に従って設定すべきです（SHOULD）。

• process.runtime.name - ランタイムの名前を設定します。
• process.runtime.version - .NETでは System.Environment.Version の値を設定します。 .NET Frameworkでは、レジストリの値に基づいてバージョンを判定します。
• process.runtime.description - System.Runtime.InteropServices.RuntimeInformation.FrameworkDescription の値を設定します。

process.runtime.name には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用すべきであり（SHOULD）、それ以外の場合は独自の値を使うべきです（SHOULD）。

• .NET Framework
• .NET
• .NET Core
• .NET Native

一部の.NETランタイムの例

Pythonランタイム

Pythonの計装は、次のように値を設定すべきです（SHOULD）。

• process.runtime.name - sys.implementation.nameの値を設定します。

• process.runtime.version - sys.implementation.versionの値をドットで連結して設定します。 リリースレベルが final かつシリアルが0の場合は、 リリースレベルとシリアルを省略します （両方を省略するか、両方とも省略しないかのいずれかにします）。

  これは、次のPythonスニペットで実装できます。

  vinfo = sys.implementation.version
  result =  ".".join(map(
      str,
      vinfo[:3]
      if vinfo.releaselevel == "final" and not vinfo.serial
      else vinfo
  ))
  

• process.runtime.description - sys.versionの値をそのまま設定します。

一部のPythonランタイムの例:

CPythonのGCC・ClangによるLinuxビルド（3.9まで）とPyPyでは、sys.version 文字列の中に実際の改行が含まれることに注意してください。

Rubyランタイム

Rubyの計装は、組み込みのランタイム定数から値をコピーして設定すべきです（SHOULD）。

• process.runtime.name - RUBY_ENGINE の値をそのまま設定します。
• process.runtime.version - RUBY_VERSION の値をそのまま設定します。
• process.runtime.description - RUBY_DESCRIPTION の値をそのまま設定します。

一部のRubyランタイムの例