argos

Argos是一款面向Go微服务的声明式OpenTelemetry插桩库，围绕明确的零分配纪律构建。README将其定位为Go生态中另两种方案的替代：Java风格的-javaagent字节码插桩在Go中没有对等实现，而"零代码"方案（eBPF）需要提升权限、较新的Linux内核，且仅覆盖有限的库集。Argos采用低代码路径：启动时一次初始化调用，随后对实际使用的每个客户端库提供显式的即插即用包装器，无猴子补丁，热路径上无反射。 设置与生命周期 单次argos.Run调用将Init、SIGINT/SIGTERM触发关闭和Shutdown绑定在一起，接受WithServiceName等功能选项。README指出，当需要更多控制时也可使用更低层的Init/Shutdown配对。配置可通过功能选项提供，或从YAML文件加载。根模块公开Trace/TraceFunc辅助函数、Resource、Propagation、Logger（含全局环境日志），以及argostest包。默认情况下，traces和metrics通过OTLP导出至localhost:4317并在无collector运行时开放失败（fail open），确保请求仍可正常工作。 集成覆盖 每个厂商SDK包装器均位于独立的Go模块中，拥有自己的go.mod，因此导入其中一个不会带入其他模块的传递依赖。已记录的覆盖范围包括：HTTP服务器（net/http、chi、gin、echo、fiber、gorilla/mux）、任意http.RoundTripper作为HTTP客户端、任意database/sql驱动、GORM、go-redis v9、MongoDB驱动v2、用于Cassandra的gocql、用于Kafka的Sarama、用于RabbitMQ的amqp091-go、Azure Service Bus、GCP Pub/Sub v2、gRPC、pkg/sftp和net/smtp。据悉，每个模块均附带真实测试、基线与插桩后的基准对比，并通过golangci-lint、gosec和govulncheck检查。对于尚未覆盖的库，项目提供了贡献模板和决策树。根模块刻意保持零厂商SDK依赖。 示例与工具 文档记录了八个可运行的微服务示例，每个均有自己的docker-compose.yml和README。其中六个示例将一个路由与数据或消息栈配对（例如gin + GORM/PostgreSQL + Kafka，或fiber + Cassandra + SFTP）；inventory-api和inventory-worker构成一个协作对，其请求产生跨越两个进程的单条trace。cmd/doctor CLI扫描Go项目的imports并建议尚未接入的任何匹配Argos集成；-strict参数将建议转为CI失败项，-init则脚手架化starter argos.config.yaml及main.go片段。仓库采用Go workspace多模块布局，包含核心模块、集成模块、cmd/doctor、samples、examples、基于mkdocs-material的文档站，以及带有Grafana LGTM栈、OTel Collector和各示例后端系统的Docker部署。Make目标涵盖构建、测试、基准、lint、格式化、安全扫描以及启停遥测或后端栈。 稳定性与已知限制 所有模块仍处于v0.x阶段，因此任一模块的公开API可能在次版本号之间发生变化，但已有发行版仍保持可解析性。项目要求与证据均以明确的前提条件描述：需要Go 1.26或更高版本，更早版本不受支持。可选的捕获和掩码功能尚不完全稳固——capture.MaskSQL已通过持续性模糊测试验证，该测试发现并修复了一个真实bug；HTTP客户端、HTTP服务器和gRPC集成中的header与body捕获虽由单元测试覆盖，但未经历同等程度的模糊测试。inventory-api/inventory-worker对的1小时浸泡测试在混合成功与错误流量（约24.5万次请求）下，涵盖HTTP、gRPC、SQL、Redis、Kafka、MongoDB和Cassandra，未出现goroutine或内存增长，但这仅作为被测试集成模块的证据，而非 blanket保证——RabbitMQ、GCP Pub/Sub、Azure Service Bus、SFTP和SMTP没有专门的浸泡测试，超过一小时的运行亦未被覆盖。基准测试为短时突发型，而非持续负载验证。项目采用MIT许可证。