CPython Runtime 指标的语义约定

状态: 开发中

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

CPython 垃圾回收

状态: 开发中

描述: 与 CPython 垃圾回收相关的指标，命名空间为 cpython.gc.*。

指标: cpython.gc.collections

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
cpython.gc.collections	Counter	{collection}	自解释器启动以来，某个代被收集的次数。[1]

[1]: 此指标报告的数据来自 gc.stats()。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
cpython.gc.generation		必需	int	垃圾回收器收集代的当前代数。	0; 1; 2

cpython.gc.generation 具有以下一系列约定俗成的值。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
0	第 0 代
1	第 1 代
2	第 2 代

指标: cpython.gc.collected_objects

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
cpython.gc.collected_objects	Counter	{object}	自解释器启动以来，某个代中被收集的总对象数。[1]

[1]: 此指标报告的数据来自 gc.stats()。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
cpython.gc.generation		必需	int	垃圾回收器收集代的当前代数。	0; 1; 2

cpython.gc.generation 具有以下一系列约定俗成的值。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
0	第 0 代
1	第 1 代
2	第 2 代

指标: cpython.gc.uncollectable_objects

此指标是推荐的。

名称	Instrument Type	Unit (UCUM)	描述	Stability	实体关联
cpython.gc.uncollectable_objects	Counter	{object}	自解释器启动以来，某个代中被发现无法回收的总对象数。[1]

[1]: 此指标报告的数据来自 gc.stats()。

Attributes

键	Stability	需求级别	Value Type	描述	Example Values
cpython.gc.generation		必需	int	垃圾回收器收集代的当前代数。	0; 1; 2

cpython.gc.generation 具有以下一系列约定俗成的值。如果其中一个适用，则必须使用相应的值；否则，可以使用自定义值。

值	描述	Stability
0	第 0 代
1	第 1 代
2	第 2 代