CPythonランタイムメトリクスに関するセマンティック規約

ステータス: Development

この文書では、OpenTelemetryにおけるCPythonランタイムメトリクスに関するセマンティック規約を定義します。

CPythonのガーベジコレクション

ステータス: development

Description: 名前空間cpython.gc.*の下で取得される、ガーベジコレクションに関するCPythonメトリクス。

このメトリクスは推奨です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`cpython.gc.collections`	Counter	`{collection}`	インタプリタの起動以降、ある世代がコレクトされた回数。[1]

[1]: このメトリクスはgc.stats()からのデータを報告します。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
`cpython.gc.generation`		`Required`	int	ガーベジコレクターのコレクション世代の値。	`0`; `1`; `2`

cpython.gc.generationには、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。

このメトリクスは推奨です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`cpython.gc.collected_objects`	Counter	`{object}`	インタプリタの起動以降、ある世代の中でコレクトされたオブジェクトの総数。[1]

[1]: このメトリクスはgc.stats()からのデータを報告します。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
`cpython.gc.generation`		`Required`	int	ガーベジコレクターのコレクション世代の値。	`0`; `1`; `2`

このメトリクスは推奨です。

Name	Instrument Type	Unit (UCUM)	Description	Stability	Entity Associations
`cpython.gc.uncollectable_objects`	Counter	`{object}`	インタプリタの起動以降、ある世代の中でコレクト不能と判明したオブジェクトの総数。[1]

[1]: このメトリクスはgc.stats()からのデータを報告します。

Attributes:

Key	Stability	Requirement Level	Value Type	Description	Example Values
`cpython.gc.generation`		`Required`	int	ガーベジコレクターのコレクション世代の値。	`0`; `1`; `2`