Repolode
Submit
alibaba

alibaba/loongsuite-go

A compile-time OpenTelemetry instrumentation tool for Go that adds tracing and metrics via an `otel go build` prefix, without changing application code.

View on GitHubWebsite
Stars
907
Forks
131
Open issues
31
Last commit
20 days ago

What is it?

LoongSuite Go Agent is a tool that adds OpenTelemetry observability to Go applications at compile time. Instead of editing source code, you build the project with the `otel` prefix (for example `otel go build`), and the tool injects instrumentation into supported libraries during compilation.

It covers a broad set of commonly used Go libraries, including net/http, gin, gorm, go-redis, grpc, Kafka clients, and several LLM SDKs such as openai-go and anthropic-sdk-go. The project also provides a way to inject custom code into libraries it does not officially support, and includes examples for logging with zap, SQL injection detection, and Kafka consumer monitoring.

Prebuilt binaries are available for Linux, macOS and Windows, and a shell install script is provided. Requires Go 1.25 or later for both the tool and the instrumented application. The project was contributed to the OpenTelemetry community and has been incubated as opentelemetry-go-compile-instrumentation.

Key features

  • 01Adds instrumentation at compile time through the `otel go build` command, with no source changes.
  • 02Supports a wide range of Go libraries including HTTP frameworks, ORMs, Redis clients, gRPC and message queues.
  • 03Includes instrumentation for several LLM SDKs such as openai-go and langchaingo.
  • 04Allows custom code injection into libraries that are not officially supported.
  • 05Provides prebuilt binaries for Linux, macOS and Windows.

Use cases

  • Adding distributed tracing to an existing Go service without touching its code.
  • Monitoring HTTP, database and Redis calls in a Go microservice.
  • Observing LLM API calls made from Go applications.
  • Measuring the overhead of instrumentation before rolling it out.

Quick start

  1. 1

    Download a prebuilt otel binary from the releases page for your platform

  2. 2

    Or build and install the tool from source

    make install
  3. 3

    Check that the tool is installed

    otel version
  4. 4

    Build your project with the otel prefix

    otel go build

Things to know

  • Requires Go 1.25+ for both the tool and the instrumented application.
  • If go build succeeds but otel go build fails, the README treats it as a likely bug.

In collections

OpenTelemetry & observability platforms

Topics

#opentelemetry#observability#tracing#golang#instrumentation#apm#metrics#go

FAQ

What is loongsuite-go?
A compile-time OpenTelemetry instrumentation tool for Go that adds tracing and metrics via an `otel go build` prefix, without changing application code. LoongSuite Go Agent is a tool that adds OpenTelemetry observability to Go applications at compile time. Instead of editing source code, you build the project with the `otel` prefix (for example `otel go build`), and the tool injects instrumentation into supported libraries during compilation.
Is loongsuite-go free to use? What license does it have?
loongsuite-go is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is loongsuite-go still maintained?
Actively maintained. The last commit to loongsuite-go was on Oct 19, 2026.
What can I use loongsuite-go for?
Adding distributed tracing to an existing Go service without touching its code. Monitoring HTTP, database and Redis calls in a Go microservice. Observing LLM API calls made from Go applications. Measuring the overhead of instrumentation before rolling it out.
How do I install loongsuite-go?
Download a prebuilt otel binary from the releases page for your platform Or build and install the tool from source: make install Check that the tool is installed: otel version Build your project with the otel prefix: otel go build
Where can I get loongsuite-go?
The source code and installation instructions are on GitHub: https://github.com/alibaba/loongsuite-go

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects