go/opentelemetry-go
go/opentelemetry-go
1
0
Fork 0
mirror of https://github.com/open-telemetry/opentelemetry-go.git synced 2025-01-16 02:47:20 +02:00
Code Issues Releases Activity
814a41388b
opentelemetry-go/sdk/internal/x
History
David Ashpole 6e2f72f698
Enable exemplars by default (#5778) 
Part of https://github.com/open-telemetry/opentelemetry-go/issues/5249.

Addresses
https://github.com/open-telemetry/opentelemetry-go/issues/5249#issuecomment-2088725450

This removes handling of the `OTEL_GO_X_EXEMPLAR` environment variable.

Instead of changing the default for the existing environment variable to
enable it by default, i'm just removing it entirely. Users can still
disable the feature by setting the filter to always_off. Since we will
continue to support that configuration, it seems better to direct users
there, rather than give them a temporary equivalent.
2024-09-11 15:07:14 -04:00
..
README.md Add the sdk/internal/x package (#5444) 2024-06-05 09:00:57 -07:00
x_test.go Enable exemplars by default (#5778) 2024-09-11 15:07:14 -04:00
x.go Add the sdk/internal/x package (#5444) 2024-06-05 09:00:57 -07:00

README.md

Experimental Features

The SDK contains features that have not yet stabilized in the OpenTelemetry specification. These features are added to the OpenTelemetry Go SDK prior to stabilization in the specification so that users can start experimenting with them and provide feedback.

These feature may change in backwards incompatible ways as feedback is applied. See the Compatibility and Stability section for more information.

Features

Resource

OpenTelemetry resource semantic conventions include many attribute definitions that are defined as experimental. To have experimental semantic conventions be added by resource detectors set the OTEL_GO_X_RESOURCE environment variable. The value set must be the case-insensitive string of "true" to enable the feature. All other values are ignored.

Examples

Enable experimental resource semantic conventions.

export OTEL_GO_X_RESOURCE=true

Disable experimental resource semantic conventions.

unset OTEL_GO_X_RESOURCE

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.