This project provides an automatic solution for Golang applications that want to leverage OpenTelemetry to enable effective observability. No code changes are required in the target application, the instrumentation is done at compile time. Simply adding otel prefix to go build to get started 🚀

Installation

Install via Bash

For Linux and MacOS users, install the tool by running the following command

$ sudo curl -fsSL https://cdn.jsdelivr.net/gh/alibaba/opentelemetry-go-auto-instrumentation@main/install.sh | sudo bash

It will be installed in /usr/local/bin/otel by default.

Precompiled Binary

Please download the latest precompiled release version from the Release page.

Build From Source

Checkout the source code and build the tool by running the following command:

$ make install

Getting Started

Add otel prefix to go build to build your project:

$ otel go build
$ otel go build -o app cmd/app
$ otel go build -gcflags="-m" cmd/app

The arguments for the tool itself should be placed before go build:

$ otel -help                      # print help doc
$ otel -debug go build            # enable debug mode
$ otel -verbose go build          # print verbose log
$ otel -rule=custom.json go build # use custom rule

You can also explore these examples to get hands-on experience.

Also there are several documents that you may find useful for either understanding the project or contributing to it.

Note

If you find any compilation failures while go build works, it's likely a bug. Please feel free to file a bug at GitHub Issues to help us enhance this project.

Supported Libraries

Plugin Name	Repository Url	Min Supported Version	Max Supported Version
database/sql	https://pkg.go.dev/database/sql	-	-
echo	https://github.com/labstack/echo	v4.0.0	v4.12.0
fasthttp	https://github.com/valyala/fasthttp	v1.45.0	v1.57.0
gin	https://github.com/gin-gonic/gin	v1.7.0	v1.10.0
go-redis	https://github.com/redis/go-redis	v9.0.5	v9.5.1
go-redis v8	https://github.com/redis/go-redis	v8.11.0	v8.11.5
gorm	https://github.com/go-gorm/gorm	v1.22.0	v1.25.9
grpc	https://google.golang.org/grpc	v1.44.0	v1.67.0
hertz	https://github.com/cloudwego/hertz	v0.8.0	v0.9.2
kratos	https://github.com/go-kratos/kratos	v2.6.3	v2.8.2
log	https://pkg.go.dev/log	-	-
logrus	https://github.com/sirupsen/logrus	v1.5.0	v1.9.3
mongodb	https://github.com/mongodb/mongo-go-driver	v1.11.1	v1.15.2
mux	https://github.com/gorilla/mux	v1.3.0	v1.8.1
net/http	https://pkg.go.dev/net/http	-	-
redigo	https://github.com/gomodule/redigo	v1.9.0	v1.9.2
slog	https://pkg.go.dev/log/slog	-	-
zap	https://github.com/uber-go/zap	v1.20.0	v1.27.0
fiber	https://github.com/gofiber/fiber	v2.43.0	v2.52.5

We are progressively open-sourcing the libraries we have supported, and your contributions are very welcome 💖!

Important

The framework you expected is not in the list? Don't worry, you can easily inject your code into any frameworks/libraries that are not officially supported.

Please refer to this document to get started.

Community

We are looking forward to your feedback and suggestions. You can join our DingTalk group to engage with us.