在監控Go應用之前，您需要通過客戶端將應用數據上報至應用性能監控APM服務端。本文介紹如何通過OpenTelemetry Go探針上報Go應用數據。

前提條件

• 完成應用性能監控vpce接入。

• Go 版本大于等于1.23。

• 請確保依賴庫以及框架滿足最低版本要求。

接入步驟

步驟1：下載探針

1. 登錄應用性能監控控制臺。

2. 在菜單欄中選擇應用列表，點擊接入應用，選擇GO > Go探針。

3. 在下載Agent步驟中選擇對應的架構，目前只支持linux系統 x86 和 arm64架構，點擊即可下載對應的探針。

步驟2：編譯應用

1. 解壓并賦與解壓后的otel文件執行權限。

   unzip goagent.zip
   chmod +x otel

2. 對 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：上報地址，注意這里不管哪種協議接入都必須添加//前綴，地址可通過步驟4拿到。

步驟4：查看接入點信息及鑒權信息

應用列表的接入指引會根據您所在資源池提供“通過 HTTP 上報數據”和“通過 gRPC 上報數據”的ENDPOINT(天翼云vpc網絡接入點)、鑒權TOKEN信息。

步驟5：接入驗證

通過以上步驟，最后就在APM控制臺的應用列表頁面選擇目標應用，查看監控數據。