Go-通过自动插桩接入

loongsuite-go-agent 是一套基于编译期增强的 Go 自动插桩方案。业务应用无需修改代码，只需在编译阶段为原始 go build 命令增加 otel 前缀，即可为应用注入 OpenTelemetry 埋点能力，并通过标准 OTLP 协议将链路、指标等可观测数据上报至 APM 后端。该方案对于 Go 系常用依赖库和框架，包括 Gin、GORM、gRPC 等，提供了自动埋点支持，其他支持自动埋点的依赖库和框架请参见：完整列表

步骤1：获取接入点和Token

• http协议接入点： http://apm-collector.bj.baidubce.com
• Authentication：UFSpMM*FrVBqtPDK

步骤2：下载或安装插桩工具

推荐使用官方预编译二进制或安装脚本。

安装脚本方式：

1sudo curl -fsSL https://cdn.jsdelivr.net/gh/alibaba/loongsuite-go-agent@main/install.sh | sudo bash

安装完成后，执行以下命令确认工具可用：

1otel version

说明：如果未安装到系统 PATH，也可以直接下载对应平台的二进制文件，例如 otel-linux-amd64、otel-darwin-arm64，下载地址

步骤3：编译应用

对 Go 编译命令添加 otel 前缀，完成应用编译。例如，go build ... 命令将修改为./otel go build ...。

1otel go build -o app

如果使用的是本地下载的工具文件，则执行：

1./otel-linux-amd64 go build -o app

步骤4：配置运行环境变量

1export OTEL_EXPORTER_OTLP_HEADERS="Authentication=<Authentication>"
2export OTEL_SERVICE_NAME="<serviceName>"
3export OTEL_EXPORTER_OTLP_ENDPOINT="<endpoint>"

字段说明：

接入验证

完成以上接入步骤后，Go 应用将向 APM 服务端上报监控数据。在有正常流量的情况下，APM应用性能监控>应用列表 中将展示接入的应用，单击应用名称 进入应用详情页。