Repolode
DataDog

DataDog/dd-trace-go

Datadog 官方 Go 客户端库,提供 APM 链路追踪、持续性能剖析和应用安全监控。

Star
861
Fork
558
未关闭 Issue
299
最近提交
8小时前

这是什么?

dd-trace-go 是 Datadog 面向 Go 应用的客户端库,覆盖应用性能监控(APM)、持续性能剖析和应用安全管理三类产品。tracer 包可以对任意 Go 代码进行埋点追踪,contrib 目录下的一系列嵌套模块则可自动追踪 net/http、gorilla/mux、database/sql 等常用库。

profiler 包会定期采集 CPU、内存和同步相关的 Go 性能剖析数据,并按函数和行号拆分后发送到 Datadog API。应用安全管理功能内置于 APM tracer 中,通过设置 DD_APPSEC_ENABLED 环境变量即可开启,用于检测 SSRF、SQL 注入、XSS 等应用层攻击。

多数用户只需安装 tracer 和 profiler 两个包,再按需添加服务所用库对应的 contrib 模块。项目支持 Go 最近两个大版本以及官方一级移植平台。

核心功能

  • 01跨 Web 服务器、数据库和微服务追踪请求,也支持对自定义代码打点。
  • 02通过 contrib 模块为常用 Go 库提供开箱即用的自动埋点。
  • 03持续采集 CPU、内存和同步的性能剖析数据,精确到函数和行号。
  • 04通过环境变量开启应用内攻击检测,覆盖 SSRF、SQL 注入和 XSS。
  • 05支持 Go 最近两个大版本及官方一级移植平台。

适用场景

  • 定位 Go 后端微服务中的慢请求和性能瓶颈。
  • 在生产环境中追踪 Go 服务的 CPU 与内存热点,降低延迟和基础设施成本。
  • 在使用 Datadog 监控的 Go Web 应用中增加应用内的注入和 SSRF 攻击检测。

快速上手

  1. 1

    安装核心追踪包

    go get github.com/DataDog/dd-trace-go/v2/ddtrace/tracer
  2. 2

    安装持续性能分析包

    go get github.com/DataDog/dd-trace-go/v2/profiler

使用前须知

  • 需要 Datadog 账户和 Agent 才能查看收集的数据。
  • 仅官方支持 Go 的两个最新版本及一类移植平台。
  • 许可证显示为 NOASSERTION,使用前请自行核查仓库的许可证条款。

标签

常见问题

dd-trace-go 是什么?
Datadog 官方 Go 客户端库,提供 APM 链路追踪、持续性能剖析和应用安全监控。 dd-trace-go 是 Datadog 面向 Go 应用的客户端库,覆盖应用性能监控(APM)、持续性能剖析和应用安全管理三类产品。tracer 包可以对任意 Go 代码进行埋点追踪,contrib 目录下的一系列嵌套模块则可自动追踪 net/http、gorilla/mux、database/sql 等常用库。
dd-trace-go 可以免费使用吗?用的什么许可证?
dd-trace-go 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
dd-trace-go 还在维护吗?
活跃维护中。dd-trace-go 最近一次提交是在 2026年10月21日。
dd-trace-go 适合用来做什么?
定位 Go 后端微服务中的慢请求和性能瓶颈。 在生产环境中追踪 Go 服务的 CPU 与内存热点,降低延迟和基础设施成本。 在使用 Datadog 监控的 Go Web 应用中增加应用内的注入和 SSRF 攻击检测。
dd-trace-go 怎么安装和运行?
安装核心追踪包: go get github.com/DataDog/dd-trace-go/v2/ddtrace/tracer 安装持续性能分析包: go get github.com/DataDog/dd-trace-go/v2/profiler
在哪里获取 dd-trace-go?
源代码和安装说明在 GitHub 上:https://github.com/DataDog/dd-trace-go

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目