Experimental Features
The Trace SDK contains features that have not yet stabilized in the OpenTelemetry specification. These features are added to the OpenTelemetry Go Trace SDK prior to stabilization in the specification so that users can start experimenting with them and provide feedback.
These features may change in backwards incompatible ways as feedback is applied. See the Compatibility and Stability section for more information.
Features
Self-Observability
The SDK provides a self-observability feature that allows you to monitor the SDK itself.
To opt-in, set the environment variable OTEL_GO_X_SELF_OBSERVABILITY to true.
When enabled, the SDK will create the following metrics using the global MeterProvider:
otel.sdk.span.liveotel.sdk.span.started
Please see the Semantic conventions for OpenTelemetry SDK metrics documentation for more details on these metrics.
Compatibility and Stability
Experimental features do not fall within the scope of the OpenTelemetry Go versioning and stability policy. These features may be removed or modified in successive version releases, including patch versions.
When an experimental feature is promoted to a stable feature, a migration path will be included in the changelog entry of the release. There is no guarantee that any environment variable feature flags that enabled the experimental feature will be supported by the stable version. If they are supported, they may be accompanied with a deprecation notice stating a timeline for the removal of that support.