compatibility.md

Compatibility

opentelemetry-go-auto-instrumentation ensures compatibility with the current supported versions of the Go language:

Each major Go release is supported until there are two newer major releases. For example, Go 1.5 was supported until the Go 1.7 release, and Go 1.6 was supported until the Go 1.8 release.

For versions of Go that are no longer supported upstream, opentelemetry-go-auto-instrumentation will stop ensuring compatibility with these versions in the following manner:

• A minor release of opentelemetry-go-auto-instrumentation will be made to add support for the new supported release of Go.
• The following minor release of opentelemetry-go-auto-instrumentation will remove compatibility testing for the oldest (now archived upstream) version of Go. This, and future, releases of opentelemetry-go-auto-instrumentation may include features only supported by the currently supported versions of Go.

This project is tested on the following systems.

OS	Go Version	Architecture
Ubuntu	1.23	amd64
Ubuntu	1.22	amd64
Ubuntu	1.23	386
Ubuntu	1.22	386
Linux	1.23	arm64
Linux	1.22	arm64
macOS 13	1.23	amd64
macOS 13	1.22	amd64
macOS	1.23	arm64
macOS	1.22	arm64
Windows	1.23	amd64
Windows	1.22	amd64
Windows	1.23	386
Windows	1.22	386

While this project should work for other systems, no compatibility guarantees are made for those systems currently.

OpenTelemetry Compatibility

To address issues such as trace interruption caused by missing context, we need to instrument OpenTelemetry (OTel) itself with this otel. This means that if users explicitly add OTel dependencies, the version of those dependencies must match the otel's requirements, otherwise, the tool will not function properly. Currently, the mapping of the otel to the supported OTel versions is as follows:

Tool Version	OTel Version	OTel Contrib Version
0.1.0-RC	v1.28.0	-
v0.2.0	v1.30.0	v0.55.0
v0.3.0	v1.31.0	v.056.0

Limitations

• Go vendor build is not supported.