Telemetry

遥测属性

本文档定义了遥测 SDK 的属性。

Attributes

StabilityValue Type描述Example Values
telemetry.distro.nameDevelopment字符串自动仪器化代理或分发版的名称(如果使用)。[1]parts-unlimited-java
telemetry.distro.versionDevelopment字符串自动仪器化代理或分发版的版本字符串(如果使用)。1.2.3
telemetry.sdk.languageStable字符串遥测 SDK 的语言。cpp; dotnet; erlang
telemetry.sdk.nameStable字符串上面定义的遥测 SDK 的名称。[2]opentelemetry
telemetry.sdk.versionStable字符串遥测 SDK 的版本字符串。1.2.3

[1] telemetry.distro.name: 官方的自动仪器化代理和分发版应将 telemetry.distro.name 属性设置为以 opentelemetry- 开头的字符串,例如 opentelemetry-java-instrumentation

[2] telemetry.sdk.name OpenTelemetry SDK 必须将 telemetry.sdk.name 属性设置为 opentelemetry。如果使用了其他 SDK,例如分支或供应商提供的实现,则该 SDK 必须将 telemetry.sdk.name 属性设置为该 SDK 主要入口点的完全限定类名或模块名,或者根据语言选择其他合适的标识符。标识符 opentelemetry 是保留的,不得在此情况下使用。所有自定义标识符在实现的不同版本之间应保持稳定。


telemetry.sdk.language 具有以下一组已知的(well-known)值。如果其中一个适用,则必须使用相应的值;否则,可以自由使用自定义值。

描述Stability
cppcppStable
dotnetdotnetStable
erlangerlangStable
gogoStable
javajavaStable
nodejsnodejsStable
phpphpStable
pythonpythonStable
rubyrubyStable
rustrustStable
swiftswiftStable
webjswebjsStable