以Go探针方式接入
更新时间 2025-10-13 15:26:26
最近更新时间: 2025-10-13 15:26:26
在监控Go应用之前,您需要通过客户端将应用数据上报至应用性能监控APM服务端。本文介绍如何通过OpenTelemetry Go探针上报Go应用数据。
前提条件
完成应用性能监控vpce接入。
Go 版本大于等于1.23。
请确保依赖库以及框架满足最低版本要求。
接入步骤
步骤1:下载探针
登录应用性能监控控制台。
在菜单栏中选择应用列表,点击接入应用,选择GO > Go探针。
在下载Agent步骤中选择对应的架构,目前只支持linux系统 x86 和 arm64架构,点击即可下载对应的探针。
步骤2:编译应用
解压并赋与解压后的otel文件执行权限。
unzip goagent.zip chmod +x otel
对 Go 编译命令添加 otel 前缀,完成应用编译。例如 go build ... 命令将修改为./otel go build ...。注意:需要确保编译环境的go版本 >= go mod里面指定的go版本。
./otel go build -o app
步骤3:添加环境变量,运行服务
OTEL_EXPORTER_OTLP_ENDPOINT={ENDPOINT}
OTEL_SERVICE_NAME=..
OTEL_EXPORTER_OTLP_PROTOCOL=grpc
OTEL_TRACES_EXPORTER=otlp
license={TOKEN}
./app
OTEL_SERVICE_NAME :应用名,多个使用相同 serviceName 接入的应用进程,在 APM 中会表现为相同应用下的多个实例。应用名最长63个字符,只能包含小写字母、数字及分隔符“ - ”,且必须以小写字母开头,数字或小写字母结尾。
OTEL_EXPORTER_OTLP_ENDPOINT:上报地址,注意这里不管哪种协议接入都必须添加http://
前缀,地址可通过步骤4拿到。
步骤4:查看接入点信息及鉴权信息
应用列表的接入指引会根据您所在资源池提供“通过 HTTP 上报数据”和“通过 gRPC 上报数据”的ENDPOINT(天翼云vpc网络接入点)、鉴权TOKEN信息。
步骤5:接入验证
通过以上步骤,最后就在APM控制台的应用列表页面选择目标应用,查看监控数据。