{"id":29744466,"url":"https://github.com/alibaba/loongsuite-go-agent","last_synced_at":"2026-03-03T05:02:19.400Z","repository":{"id":223405072,"uuid":"751766102","full_name":"alibaba/loongsuite-go-agent","owner":"alibaba","description":"OpenTelemetry Compile-Time Instrumentation for Golang","archived":false,"fork":false,"pushed_at":"2026-02-25T08:13:55.000Z","size":138183,"stargazers_count":789,"open_issues_count":37,"forks_count":105,"subscribers_count":11,"default_branch":"main","last_synced_at":"2026-02-25T12:57:02.808Z","etag":null,"topics":["apm","go","instrumentation","metrics","observability","opentelemetry","tracing"],"latest_commit_sha":null,"homepage":"https://alibaba.github.io/loongsuite-go-agent/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alibaba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-02T09:29:44.000Z","updated_at":"2026-02-25T11:35:34.000Z","dependencies_parsed_at":"2025-12-14T22:04:05.910Z","dependency_job_id":null,"html_url":"https://github.com/alibaba/loongsuite-go-agent","commit_stats":{"total_commits":141,"total_committers":9,"mean_commits":"15.666666666666666","dds":0.5177304964539007,"last_synced_commit":"6a4f0ea0178b88d1bccad74a56e7bd0ef0e6b699"},"previous_names":["alibaba/opentelemetry-go-auto-instrumentation","alibaba/loongsuite-go-agent"],"tags_count":32,"template":false,"template_full_name":null,"purl":"pkg:github/alibaba/loongsuite-go-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Floongsuite-go-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Floongsuite-go-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Floongsuite-go-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Floongsuite-go-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/loongsuite-go-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Floongsuite-go-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30032363,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T03:27:35.548Z","status":"ssl_error","status_checked_at":"2026-03-03T03:27:09.213Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apm","go","instrumentation","metrics","observability","opentelemetry","tracing"],"created_at":"2025-07-26T05:01:15.503Z","updated_at":"2026-03-03T05:02:19.395Z","avatar_url":"https://github.com/alibaba.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"![](docs/public/anim-logo.svg)\n\n[![](https://shields.io/badge/-Docs-blue?logo=readthedocs)](https://alibaba.github.io/loongsuite-go-agent/)  \u0026nbsp;\n[![](https://shields.io/badge/-商业版-blue?logo=alibabacloud)](https://help.aliyun.com/zh/arms/application-monitoring/getting-started/monitoring-the-golang-applications) \u0026nbsp;\n\n**Loongsuite Go Agent** provides an automatic solution for Golang applications that want to\nleverage OpenTelemetry to enable effective observability. No code changes are\nrequired in the target application, the instrumentation is done at compile\ntime. Simply adding `otel` prefix to `go build` to get started :rocket:\n\n# Installation\n\n### Prebuilt Binaries\n\n- [![Download](https://shields.io/badge/-Linux_AMD64-blue?logo=ubuntu)](https://github.com/alibaba/loongsuite-go-agent/releases/latest/download/otel-linux-amd64)\n- [![Download](https://shields.io/badge/-Linux_ARM64-blue?logo=ubuntu)](https://github.com/alibaba/loongsuite-go-agent/releases/latest/download/otel-linux-arm64)\n- [![Download](https://shields.io/badge/-MacOS_AMD64-blue?logo=apple)](https://github.com/alibaba/loongsuite-go-agent/releases/latest/download/otel-darwin-amd64)\n- [![Download](https://shields.io/badge/-MacOS_ARM64-blue?logo=apple)](https://github.com/alibaba/loongsuite-go-agent/releases/latest/download/otel-darwin-arm64)\n- [![Download](https://shields.io/badge/-Windows_AMD64-blue?logo=wine)](https://github.com/alibaba/loongsuite-go-agent/releases/latest/download/otel-windows-amd64.exe)\n\n**This is the recommended way to install the tool.**\n\n### Install via Bash\nFor Linux and MacOS users, the following script will install `otel` in `/usr/local/bin/otel` by default:\n```bash\n$ sudo curl -fsSL https://cdn.jsdelivr.net/gh/alibaba/loongsuite-go-agent@main/install.sh | sudo bash\n```\n\n### Build from Source\n\n```bash\n$ make         # build only\n$ make install # build and install\n```\n\n# Getting Started\n\nMake sure the tool is installed:\n```bash\n$ # You may use \"otel-linux-amd64\" instead of \"otel\"\n$ otel version\n```\n\nJust adding `otel` prefix to `go build` to build your project:\n\n```bash\n$ otel go build\n$ otel go build -o app cmd/app\n$ otel go build -gcflags=\"-m\" cmd/app\n```\n\nThat's the whole process! The tool will automatically instrument your code with OpenTelemetry, and you can start to observe your application. :telescope:\n\nThe detailed usage of `otel` tool can be found in [**Usage**](./docs/user/config.md).\n\n\u003e [!NOTE]\n\u003e If you find any compilation failures while `go build` works, it's likely a bug.\n\u003e Please feel free to file a bug\n\u003e at [GitHub Issues](https://github.com/alibaba/loongsuite-go-agent/issues)\n\u003e to help us enhance this project.\n\n# Examples\n\n- [demo](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/demo) - End-to-end example with OpenTelemetry tracing and metrics\n- [zap logging](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/log) - Auto-instrumentation for `github.com/uber-go/zap` logging\n- [benchmark](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/benchmark) - Performance testing and overhead measurement\n- [sql injection](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/sqlinject) - Custom code injection for SQL injection detection\n- [nethttp](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/nethttp) - HTTP monitoring with request/response instrumentation\n- [kratos-demo](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/kratos-demo) - Integration with the Kratos framework\n- [kafka-demo](https://github.com/alibaba/loongsuite-go-agent/tree/main/example/kafka-demo) - Kafka Consumer Message monitoring\n\n# Supported Libraries\n\u003cdetails\u003e\n \u003csummary\u003eList of Supported Libraries\u003c/summary\u003e\n\n| Library            | Repository Url                                  | Min Version | Max Version |\n|--------------------|-------------------------------------------------|-------------|-------------|\n| amqp091            | https://github.com/rabbitmq/amqp091-go          | v1.10.0     | -           |\n| clickhouse/v2      | https://github.com/ClickHouse/clickhouse-go/v2  | v2.13.0     | -           |\n| database/sql       | https://pkg.go.dev/database/sql                 | -           | -           |\n| dubbo-go           | https://github.com/apache/dubbo-go              | v3.3.0      | -           |\n| echo               | https://github.com/labstack/echo                | v4.0.0      | -           |\n| elasticsearch      | https://github.com/elastic/go-elasticsearch     | v8.4.0      | v8.15.0     |\n| eino               | https://github.com/cloudwego/eino               | v0.3.51     | -           |\n| fasthttp           | https://github.com/valyala/fasthttp             | v1.45.0     | v1.65.0     |\n| fiber              | https://github.com/gofiber/fiber                | v2.43.0     | v2.52.12    |\n| gin                | https://github.com/gin-gonic/gin                | v1.7.0      | v1.10.1     |\n| go-kit/log         | https://github.com/go-kit/log                   | v0.1.0      | v0.2.1      |\n| go-micro           | https://github.com/micro/go-micro               | v5.0.0      | v5.3.0      |\n| go-restful         | https://github.com/emicklei/go-restful          | v3.7.0      | v3.12.1     |\n| gocql              | https://github.com/gocql/gocql                  | v1.3.0      | -           |\n| gopg               | https://github.com/go-pg/pg                     | v10.10.0    | v10.14.0    |\n| gorestful/v3       | https://github.com/emicklei/go-restful/v3       | v3.7.0      | v3.12.1     |\n| gorm               | https://github.com/go-gorm/gorm                 | v1.22.0     | v1.25.9     |\n| gorilla/mux        | https://github.com/gorilla/mux                  | v1.3.0      | v1.8.1      |\n| grpc               | https://google.golang.org/grpc                  | v1.44.0     | -           |\n| hertz              | https://github.com/cloudwego/hertz              | v0.8.0      | -           |\n| iris               | https://github.com/kataras/iris                 | v12.2.0     | v12.2.11    |\n| k8s client-go      | https://github.com/kubernetes/client-go         | v0.33.3     | -           |\n| kitex              | https://github.com/cloudwego/kitex              | v0.5.1      | -           |\n| kratos             | https://github.com/go-kratos/kratos             | v2.6.3      | -           |\n| langchaingo        | https://github.com/tmc/langchaingo              | v0.1.13     | -           |\n| log                | https://pkg.go.dev/log                          | -           | -           |\n| logrus             | https://github.com/sirupsen/logrus              | v1.5.0      | v1.9.3      |\n| mcp                | https://github.com/mark3labs/mcp-go             | v0.20.0     | -           |\n| mongodb            | https://github.com/mongodb/mongo-go-driver      | v1.11.1     | v1.15.1     |\n| nacos              | https://github.com/nacos-group/nacos-sdk-go/v2  | v2.0.0      | v2.2.9      |\n| net/http           | https://pkg.go.dev/net/http                     | -           | -           |\n| ollama             | https://github.com/ollama/ollama                | v0.3.14     | -           |\n| redigo             | https://github.com/gomodule/redigo              | v1.9.0      | v1.9.3      |\n| redis (go-redis)   | https://github.com/redis/go-redis               | v9.0.5      | v9.5.1      |\n| redis v8           | https://github.com/go-redis/redis/v8            | v8.11.0     | v8.11.5     |\n| rocketmq           | https://github.com/apache/rocketmq-client-go/v2 | v2.0.0      | -           |\n| rpcx               | https://github.com/smallnest/rpcx               | v1.8.2      | -           |\n| rueidis            | https://github.com/redis/rueidis                | v1.0.30     | -           |\n| segmentio/kafka-go | https://github.com/segmentio/kafka-go           | v0.4.0      | -           |\n| sentinel           | https://github.com/alibaba/sentinel-golang      | v1.0.4      | -           |\n| slog               | https://pkg.go.dev/log/slog                     | -           | -           |\n| sqlx               | https://github.com/jmoiron/sqlx                 | v1.3.0      | v1.4.0      |\n| trpc-go            | https://github.com/trpc-group/trpc-go           | v1.0.0      | -           |\n| zap                | https://github.com/uber-go/zap                  | v1.20.0     | v1.27.0     |\n| zerolog            | https://github.com/rs/zerolog                   | v1.10.0     | v1.33.0     |\n| go-openai          | https://github.com/sashabaranov/go-openai       | v1.30.0     | -           |\n| openai-go          | https://github.com/openai/openai-go             | v1.5.0      | -           |\n| franz-go           | https://github.com/twmb/franz-go                | v1.18.0     | -           |\n\n\u003c/details\u003e\n\nWe are progressively open-sourcing the libraries we have supported, and your contributions are \u003ckbd\u003eVery Welcome\u003c/kbd\u003e\n\n\u003e [!IMPORTANT]\n\u003e 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.\n\u003e\n\u003e Please refer to [this document](./docs/dev/overview.md) to get started.\n\n# Community\n\nWe are looking forward to your feedback and suggestions. You can join\nour [DingTalk group](https://qr.dingtalk.com/action/joingroup?code=v1,k1,PBuICMTDvdh0En8MrVbHBYTGUcPXJ/NdT6JKCZ8CG+w=\u0026_dt_no_comment=1\u0026origin=11)\nto engage with us.\n\n| DingTalk | Star History |\n| :---: | :---: |\n| \u003cimg src=\"./docs/public/dingtalk.png\" height=\"200\" /\u003e | \u003cimg src=\"https://api.star-history.com/svg?repos=alibaba/loongsuite-go-agent\u0026type=Date\" height=\"200\" /\u003e |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Floongsuite-go-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Floongsuite-go-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Floongsuite-go-agent/lists"}