跳到主要内容

Go 探针支持列表

操作系统​

  • 支持内核版本高于2.6.32，GLIBC版本高于2.12的Linux x86_64发行版
  • 支持内核版本高于2.6.32，GLIBC版本高于2.17的linux ARM64发行版
  • 不支持Windows操作系统

Go 编译时版本​

不支持C和Go混合编译方式 https://go.dev/doc/install/gccgo

仅支持官方Release版本 https://go.dev/dl/#stable

Linux AMD64：go1.13.0 - go1.22.12, go1.23.0 - go1.23.12, go1.24.0 - go1.24.10, go1.25.0 - go1.25.4

Linux ARM64：go1.16.0 - go1.22.12, go1.23.0 - go1.23.12, go1.24.0 - go1.24.10, go1.25.0 - go1.25.4

Go 编译选项​

  • 支持动态链接(CGO_ENABLED=1)和静态链接(CGO_ENABLED=0)的Go应用
  • 支持glibc库和muslc库编译的Go应用
  • 支持没有符号表的应用 (strip 或 -ldflags="-s" 或 -ldflags="-s -w")
  • 支持开启竞态条件检测的编译模式(-race)
  • 支持地址空间布局随机化的编译模式(Position Independent Executable, PIE) (-buildmode=pie)
  • 不支持的编译选项: -linkshared
  • 不支持使用了听云 Go SDK 或 阿里云 ARMS SDK 的Go应用

部署环境​

  • 支持部署在普通主机的Go应用
  • 支持部署在虚机内的Go应用
  • 支持部署在Docker容器内的Go应用, 仅支持包含c库的镜像，不支持没有c库的镜像, 详见 安装和使用
  • 支持部署在Kubernetes Pod内的Go应用，不支持激进模式部署, 详见 安装和使用

功能范围​

  • 支持采集Go内置的HTTP(s)协议的服务请求（暂不支持HTTP/2协议）
  • 支持采集GRPC协议的服务请求
  • 支持采集数据库调用
  • 支持采集Go内置的HTTP Client组件（暂不支持HTTP/2协议）及跨应用
  • 支持采集GRPC Client组件及跨应用
  • 支持采集ClickHouse、Redis、Kafka组件调用
  • 支持采集日志组件记录的错误日志 和 日志溯源
  • 支持采集自定义 HTTP Request Header / HTTP Response Header
  • 不支持跨协程Span关联
  • 不支持的功能：自定义嵌码、用户溯源、前端RUM Browser嵌码
  • 暂时不支持的功能：探针端请求命名、采集SQL参数、在进程列表中展示Go进程

框架​

框架支持版本
net/http 内置HTTP框架go1.13 ~ go1.25
google.golang.org/grpc GRPC框架v1.14.0 ~ v1.74.2
github.com/gin-gonic/gin gin框架v1.1 ~ v1.10.0
github.com/astaxie/beego beego框架v2.0 ~ v2.3.0
github.com/labstack/echo/v4 echo框架v4.0 ~ v4.12.0
github.com/kataras/iris/v12 iris框架v12.0 ~ v12.2.10
github.com/go-kratos/kratos kratos框架v2.0.0 ~ v2.9.1

注: 不支持将模块下载为本地副本再引用的方式，例如将GRPC框架下载到本地然后使用replace方式替换，这样会导致探针无法识别框架版本

组件​

数据库组件支持版本备注
Database/SQL内置数据库APIgo1.13 ~ go1.25
github.com/go-sql-driver/mysqlv1.0.0 ~ v1.7.1
github.com/mattn/go-sqlite3v1.1.0 ~ v1.14.23
github.com/lib/pqv1.0.0 ~ v1.10.9
github.com/sijms/go-ora/v2v2.1.19 ~ v2.9.0
github.com/ClickHouse/clickhouse-go/v2v2.3.0 ~ v2.40.3原生驱动接口
github.com/ClickHouse/clickhouse-go/v2v2.3.0 ~ v2.40.3Go 标准 database/sql 接口
github.com/go-redis/redis/v7v7.0.0 ~ v7.4.1
github.com/go-redis/redis/v8v8.0.0 ~ v8.11.5
github.com/go-redis/redis/v9v9.0.0 ~ v9.14.0
MQ组件支持版本备注
github.com/segmentio/kafka-gov0.4.1 ~ v0.4.49仅支持生产者
日志组件支持版本备注
github.com/sirupsen/logrusv1.7.1 ~ v1.9.3支持日志溯源 [注1]
go.uber.org/zapv1.0.0 ~ v1.27.0支持日志溯源
github.com/golang/glogv1.1.0 ~ v1.2.5不支持日志溯源

注1: 由于 Logrus 框架中存在竞争条件问题 ，v1.7.0及以下版本不受支持

注2: 不支持将模块下载为本地副本再引用的方式，例如将mysql组件下载到本地然后使用replace方式替换，这样会导致探针无法识别组件版本

探针运行原理及影响​

原理：使用bin/agentinject启动Go应用, agentinject利用ptrace技术替换Go应用中相关的函数并获取性能数据，agentinject会作为主进程运行，同时启动traceagent进程接收Go应用产生的trace数据并转发到Collector。

启动后，agentinject会监听Go应用的信号事件，当agentinject被kill退出时，Go应用也会被连带kill退出；当Go应用被kill时，agentinject检测到应用退出后也会同时退出。

影响：ps进程列表中原本Go应用进程的位置会被agentinject替换，Go应用进程的父进程id会变为1，如果Go应用由启停脚本或服务维护，请务必在测试环境验证启停脚本或服务的有效性并做适当修改。

例如:

不带探针启动应用：

[nb@go-autotest grpc3]$ ./grpc3-v1.67.1-go-1.21-static &
[3] 604551

然后ps进程:

[nb@go-autotest grpc3]$ ps -ef | grep grpc3-v1.67.1-go-1.21-static
nb        604551  604388  0 11:17 pts/0    00:00:00 ./grpc3-v1.67.1-go-1.21-static

使用探针启动应用：

[nb@go-autotest grpc3]$  ~/tingyun-agent-go/bin/agentinject ./grpc3-v1.67.1-go-1.21-static &
[3] 604551

然后ps进程:

[nb@go-autotest grpc3]$ ps -ef | grep grpc3-v1.67.1-go-1.21-static
nb        604461  604388  0 10:52 pts/0    00:00:00 ~/tingyun-agent-go/bin/agentinject ./grpc3-v1.67.1-go-1.21-static
nb        604463       1  0 10:52 pts/0    00:00:00 ./grpc3-v1.67.1-go-1.21-static

Go SDK支持列表

操作系统​

  • 不支持Windows操作系统
  • 支持CPU架构为ARM64的Linux 操作系统
  • 支持CPU架构为AMD64的Linux 操作系统

Go 编译时版本​

  • Go 1.9 - Go 1.23

框架​

框架Go探针嵌码 import 模块路径支持版本
net/http 内置http框架github.com/TingYunGo/goagentgo1.9 ~ go1.23.x
github.com/gin-gonic/gin gin框架github.com/TingYunGo/goagent/frameworks/gingin v1.3.0 ~ gin v1.7.4
github.com/astaxie/beego beego框架: GOPATH模式github.com/TingYunGo/goagent/frameworks/beego/path/astaxiebeego v1.12.0 ~ beego v2.0.0-beta
github.com/beego/beego beego框架: GOPATH模式github.com/TingYunGo/goagent/frameworks/beego/pathbeego v1.12.0 ~ beego v2.0.1
github.com/beego/beego beego框架v1: GOMOD模式github.com/TingYunGo/goagent/frameworks/beegobeego v1.12.0 ~ beego v1.12.3
github.com/beego/beego/v2 beego框架v2: GOMOD模式github.com/TingYunGo/goagent/frameworks/beego/v2beego v2.0.0 ~ beego v2.0.1
github.com/labstack/echo echo 框架 GOPATH模式github.com/TingYunGo/goagent/frameworks/echoecho v3.3.10 ~ echo v4.6.1
github.com/labstack/echo/v4 echo 框架 V4 GOMOD模式github.com/TingYunGo/goagent/frameworks/echo/v4echo v4.0.0 ~ echo v4.6.1
github.com/kataras/iris/v12 iris 框架 v12.1.xgithub.com/TingYunGo/goagent/frameworks/iris/v12iris v12.1.0 ~ iris v12.1.8
github.com/kataras/iris/v12 iris 框架 v12.2github.com/TingYunGo/goagent/frameworks/iris/v12/2iris v12.2.0-alpha ~ iris v12.2.0-alpha3

组件​

组件Go探针嵌码 import 模块路径支持版本
Database/SQL数据库github.com/TingYunGo/goagent/databasego1.9 ~ go1.23.x
驱动列表:
SQL Server: github.com/denisenkom/go-mssqldb v0.9.0 ~ v0.11.0
MySQL: github.com/go-sql-driver/mysql v1.0.0 ~ v1.6.0
PostgreSQL: github.com/lib/pq v1.0.0 ~ v1.10.3
SQLite: github.com/mattn/go-sqlite3 v1.0.0 ~ v1.14.8
github.com/gomodule/redigo redis: redigogithub.com/TingYunGo/goagent/nosql/redigov1.7.0 ~ v1.8.5
github.com/go-redis/redis redis: go-redis, GOPATH模式github.com/TingYunGo/goagent/nosql/go-redisv6.0.0 ~ v8.11.4
github.com/go-redis/redis redis: go-redis default, GOMOD模式github.com/TingYunGo/goagent/nosql/go-redisv6.0.0 ~ v8.11.4
github.com/go-redis/redis/v7 redis: go-redis v7, GOMOD模式github.com/TingYunGo/goagent/nosql/go-redis/v7v7.0.0 ~ v7.4.1
github.com/go-redis/redis/v8 redis: go-redis v8, GOMOD模式github.com/TingYunGo/goagent/nosql/go-redis/v8v8.0.0 ~ v8.11.4
Go.mongodb.org/mongo-driver/mongo mongodbgithub.com/TingYunGo/goagent/nosql/mongodbv1.1.0 ~ v1.7.3

数据库​

常用的Go语言第三方组件支持的数据库版本如下表所示：

组件支持版本
mssql: github.com/denisenkom/go-mssqldbSQL Server 2008 SP3 +
mysql: github.com/go-sql-driver/mysqlMySQL 5.5+
postgresql: github.com/lib/pqPostgreSQL 9.6+
sqlite: github.com/mattn/go-sqlite3SQLite 3.8.5 ~ 3.36.0
redis: redigo github.com/gomodule/redigoRedis 4.0.0+
redis: go-redis github.com/go-redis/redisRedis 4.0.0+
mongodb: go.mongodb.org/mongo-driver/mongoMongoDB 2.6.1+