Go Compatibility Requirements

Compatibility

The Go Datadog Trace library is open source. View the GitHub repository for more information.

The Go Datadog Trace Library has a version support policy defined for Go versions. The two latest releases of Go are fully supported, while the third newest release is considered in maintenance. Older versions may function, but no support is provided by default. For special requests, contact support.

You must be running Datadog Agent v5.21.1+.

Integrations

Framework compatibility

Integrate the Go tracer with the following list of web frameworks using one of the following helper packages.

Note: The integrations documentation provides a detailed overview of the supported packages and their APIs, along with usage examples.

FrameworkSupport TypeGoDoc Datadog Documentation
GinFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gin-gonic/gin
Gorilla MuxFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux
gRPCFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc
gRPC v1.2Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc.v12
chiFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/go-chi/chi
echo v4Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo.v4
echo v3Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo
FiberFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gofiber/fiber.v2

Library compatibility

The Go tracer includes support for the following data stores and libraries.

LibrarySupport TypeExamples and Documentation
AWS SDKFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go/aws
ElasticsearchFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/olivere/elastic
CassandraFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gocql/gocql
GraphQLFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go
HTTPFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/net/http
HTTP routerFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/julienschmidt/httprouter
Redis (go-redis)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis
Redis (go-redis-v8)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis.v8
Redis (redigo)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/garyburd/redigo
Redis (new redigo)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gomodule/redigo
SQLFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql
SQLxFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/jmoiron/sqlx
MongoDBFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/go.mongodb.org/mongo-driver/mongo
[MongoDB (mgo)73Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/globalsign/mgo
BuntDBFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/tidwall/buntdb
LevelDBFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/syndtr/goleveldb/leveldb
miekg/dnsFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns
Kafka (confluent)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/confluentinc/confluent-kafka-go
Kafka (sarama)Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/Shopify/sarama
Google APIFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/api
go-restfulFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/emicklei/go-restful
TwirpFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/twitchtv/twirp
VaultFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/vault
ConsulFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/consul
GormFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/jinzhu/gorm
Gorm v2Fully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/gorm.io/gorm.v1
KubernetesFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/k8s.io/client-go/kubernetes
MemcacheFully Supportedgopkg.in/DataDog/dd-trace-go.v1/contrib/bradfitz/gomemcache/memcache

Packages must be imported with:

import "gopkg.in/DataDog/dd-trace-go.v1/contrib/<PACKAGE_DIR>/<PACKAGE_NAME>"

Further Reading

Additional helpful documentation, links, and articles: