alibaba/loongsuite-go

这是什么？

核心功能

• 01通过 otel go build 命令在编译期插桩，无需修改源代码。
• 02支持多种 Go 库，涵盖 HTTP 框架、ORM、Redis 客户端、gRPC 和消息队列。
• 03提供 openai-go、langchaingo 等 LLM SDK 的插桩支持。
• 04可向官方未支持的库注入自定义代码。
• 05提供 Linux、macOS、Windows 的预编译二进制文件。

适用场景

• 在不改动现有 Go 服务代码的前提下增加分布式链路追踪。
• 监控 Go 微服务中的 HTTP、数据库和 Redis 调用。
• 观测 Go 应用中对大模型 API 的调用情况。
• 在推广插桩前评估其性能开销。

快速上手

1. 1

   从发布页面下载适合你平台的预编译 otel 二进制文件

2. 2

   或者从源码构建并安装该工具

   make install
3. 3

   检查工具是否已安装

   otel version
4. 4

   在 go build 前加上 otel 前缀来构建你的项目

   otel go build

使用前须知

• !工具和被插桩的应用都需要 Go 1.25 及以上版本。
• !如果 go build 能成功但 otel go build 失败，README 认为这很可能是一个缺陷。

收录于专题

标签

常见问题

loongsuite-go 是什么？

面向 Go 的编译期 OpenTelemetry 插桩工具，只需在 go build 前加 otel 即可接入链路追踪与指标，无需修改业务代码。 LoongSuite Go Agent 是一个在编译期为 Go 应用接入 OpenTelemetry 可观测能力的工具。无需修改源代码，用 otel 前缀执行构建（例如 otel go build）即可，工具会在编译过程中向受支持的库注入插桩代码。

loongsuite-go 可以免费使用吗？用的什么许可证？

loongsuite-go 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

loongsuite-go 还在维护吗？

活跃维护中。loongsuite-go 最近一次提交是在 2026年10月19日。

loongsuite-go 适合用来做什么？

在不改动现有 Go 服务代码的前提下增加分布式链路追踪。 监控 Go 微服务中的 HTTP、数据库和 Redis 调用。 观测 Go 应用中对大模型 API 的调用情况。 在推广插桩前评估其性能开销。

loongsuite-go 怎么安装和运行？

从发布页面下载适合你平台的预编译 otel 二进制文件 或者从源码构建并安装该工具: make install 检查工具是否已安装: otel version 在 go build 前加上 otel 前缀来构建你的项目: otel go build

在哪里获取 loongsuite-go？

源代码和安装说明在 GitHub 上：https://github.com/alibaba/loongsuite-go