互換性

Go Datadog Trace ライブラリはオープンソースです。詳細については、GitHub リポジトリをご覧ください。

Go 向け Datadog Trace Library には、Go バージョンに関する サポート方針 が定められています。最新 2 リリースの Go は完全サポートの対象で、3 番目に新しいリリースはメンテナンス対象です。それより古いバージョンでも動作することはありますが、標準ではサポートされません。個別の要望がある場合は、サポートに連絡 してください。

要件

Go Tracer のサポート

Datadog では、すべてのユーザーに Go Tracer の v2 を推奨しています。v1 を利用している場合は、移行ガイド を参照して v2 へアップグレードしてください。

バージョンプレビュー一般提供 (GA)メンテナンスサポート終了 (EOL)
v12024-11-272025-06-04TBDTBD
v12018-06-062018-06-062025-06-042025-12-31
v02016-12-122016-12-122018-06-062019-06-06
Levelサポート内容
非サポート実装していません。特別なご要望は Datadog サポートにお問い合わせください。
プレビュー初期実装です。まだすべての機能が含まれていない可能性があります。新機能のサポート、バグやセキュリティの修正は、ベストエフォートで提供されます。
一般提供 (GA)全機能の完全実装。新機能、バグやセキュリティの修正を完全サポート。
メンテナンス既存機能の完全実装。新機能は受けません。バグフィックス、セキュリティフィックスのみの対応となります。
サポート終了 (EOL)サポートはありません。

インテグレーション

フレームワークの互換性

次のヘルパーパッケージのいずれかを使用して、Go トレーサーと次のリストのウェブフレームワークを統合します。

Note: This documentation uses v2 of the Go tracer, which Datadog recommends for all users. If you are using v1, see the migration guide to upgrade to v2.

Go Tracer の v1 と v2 では、サポート対象のフレームワークが異なります。

: インテグレーション ドキュメント には、サポート対象パッケージとその API の詳細な一覧に加え、使用例も掲載されています。

ライブラリの互換性

Go トレーサーには、次のデータストアとライブラリのサポートが含まれています。

ライブラリサポートの種類例とドキュメント
AWS SDK完全対応github.com/DataDog/dd-trace-go/contrib/aws/aws-sdk-go/aws/v2
AWS SDK v2完全対応github.com/DataDog/dd-trace-go/contrib/aws/aws-sdk-go-v2/aws/v2
Elasticsearch完全対応github.com/DataDog/dd-trace-go/contrib/olivere/elastic.v5/v2
Cassandra完全対応github.com/DataDog/dd-trace-go/contrib/gocql/gocql/v2
GraphQL完全対応github.com/DataDog/dd-trace-go/contrib/graph-gophers/graphql-go/v2
HTTP完全対応github.com/DataDog/dd-trace-go/contrib/net/http/v2
HTTP router完全対応github.com/DataDog/dd-trace-go/contrib/julienschmidt/httprouter/v2
Redis (go-redis)完全対応github.com/DataDog/dd-trace-go/contrib/go-redis/redis/v2
Redis (go-redis-v8)完全対応github.com/DataDog/dd-trace-go/contrib/go-redis/redis.v8/v2
Redis (redigo)完全対応github.com/DataDog/dd-trace-go/contrib/garyburd/redigo/v2
Redis (new redigo)完全対応github.com/DataDog/dd-trace-go/contrib/gomodule/redigo/v2
SQL完全対応github.com/DataDog/dd-trace-go/contrib/database/sql/v2
SQLx完全対応github.com/DataDog/dd-trace-go/contrib/jmoiron/sqlx/v2
MongoDB完全対応github.com/DataDog/dd-trace-go/contrib/go.mongodb.org/mongo-driver/mongo/v2
MongoDB (mgo)完全対応github.com/DataDog/dd-trace-go/contrib/globalsign/mgo/v2
BuntDB完全対応github.com/DataDog/dd-trace-go/contrib/tidwall/buntdb/v2
LevelDB完全対応github.com/DataDog/dd-trace-go/contrib/syndtr/goleveldb/leveldb/v2
miekg/dns完全対応github.com/DataDog/dd-trace-go/contrib/miekg/dns/v2
Kafka (confluent)完全対応github.com/DataDog/dd-trace-go/contrib/confluentinc/confluent-kafka-go/v2
Kafka (sarama)完全対応github.com/DataDog/dd-trace-go/contrib/IBM/sarama/v2
Google API完全対応github.com/DataDog/dd-trace-go/contrib/google.golang.org/api/v2
go-restful完全対応github.com/DataDog/dd-trace-go/contrib/emicklei/go-restful.v3/v2
Twirp完全対応github.com/DataDog/dd-trace-go/contrib/twitchtv/twirp/v2
Vault完全対応github.com/DataDog/dd-trace-go/contrib/hashicorp/vault/v2
Consul完全対応github.com/DataDog/dd-trace-go/contrib/hashicorp/consul/v2
Gorm v2完全対応github.com/DataDog/dd-trace-go/contrib/gorm.io/gorm.v1/v2
Kubernetes完全対応github.com/DataDog/dd-trace-go/contrib/k8s.io/client-go/kubernetes/v2
Memcache完全対応github.com/DataDog/dd-trace-go/contrib/bradfitz/gomemcache/memcache/v2

: Redis 6.0+ では、HELLOMIGRATEACL SETUSER などのコマンドでインライン認証がサポートされています。

  • Datadog Trace Agent: 認証パラメーターが trace メタデータ内で自動的に難読化されるようにするには、7.76.1 が最低要件かつ推奨バージョンです。
  • Datadog Lambda Extension (サーバーレス環境): 最低要件バージョンは v28.0.0 です。

次でパッケージをインポートする必要があります。

import "github.com/DataDog/dd-trace-go/contrib/<PACKAGE_DIR>/<PACKAGE_NAME>/v2"

: インテグレーション ドキュメント には、サポート対象パッケージとその API の詳細な一覧に加え、使用例も掲載されています。

🔹 コンパイル時のインスツルメンテーション組み込みはライブラリ内で直接行われるため、//orchestrion:ignore ディレクティブを使ってローカルに無効化することはできません。

ライブラリの互換性

Go トレーサーには、次のデータストアとライブラリのサポートが含まれています。

ライブラリサポートの種類例とドキュメント
AWS SDK完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go/aws
AWS SDK v2完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go-v2/aws
Elasticsearch完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/olivere/elastic
Cassandra完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/gocql/gocql
GraphQL完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go
HTTP完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/net/http
HTTP router完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/julienschmidt/httprouter
Redis (go-redis)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis
Redis (go-redis-v8)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis.v8
Redis (redigo)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/garyburd/redigo
Redis (new redigo)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/gomodule/redigo
SQL完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql
SQLx完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/jmoiron/sqlx
MongoDB完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/go.mongodb.org/mongo-driver/mongo
MongoDB (mgo)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/globalsign/mgo
BuntDB完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/tidwall/buntdb
LevelDB完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/syndtr/goleveldb/leveldb
miekg/dns完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns
Kafka (confluent)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/confluentinc/confluent-kafka-go
Kafka (sarama)完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/Shopify/sarama
Google API完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/api
go-restful完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/emicklei/go-restful
Twirp完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/twitchtv/twirp
Vault完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/vault
Consul完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/consul
Gorm完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/jinzhu/gorm
Gorm v2完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/gorm.io/gorm.v1
Kubernetes完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/k8s.io/client-go/kubernetes
Memcache完全対応gopkg.in/DataDog/dd-trace-go.v1/contrib/bradfitz/gomemcache/memcache

次でパッケージをインポートする必要があります。

import "gopkg.in/DataDog/dd-trace-go.v1/contrib/<パッケージディレクトリ>/<パッケージ名>"

参考資料

お役に立つドキュメント、リンクや記事: