본문 바로가기
WIKI 기술 지식 베이스

Go 호환성 요구사항 (Go Compatibility Requirements)

원문 보기 위키 갱신

Go Datadog Trace 라이브러리의 호환성 요구사항을 안내해요.

출처: 문서

본문

호환성 (Compatibility)

Go Datadog Trace 라이브러리는 오픈소스예요. 자세한 내용은 GitHub 저장소를 참고하세요.

Go Datadog Trace 라이브러리에는 Go 버전에 대해 정의된 버전 지원 정책이 있어요. Go의 가장 최신 릴리스 두 개는 완전히 지원되고, 그 다음으로 최신인 릴리스는 유지보수(maintenance) 단계로 간주돼요. 더 오래된 버전은 동작할 수 있지만 기본적으로 지원이 제공되지 않아요. 특별한 요청은 지원팀에 문의하세요.

요구사항 (Requirements)

Go 트레이서 지원 (Go Tracer support)

Datadog는 모든 사용자에게 Go 트레이서의 v2를 권장해요. v1을 사용 중이라면 마이그레이션 가이드를 참고해 v2로 업그레이드하세요.

버전 Preview GA(General Availability) 유지보수 EOL(End-of-life)
v2 2024-11-27 2025-06-04 TBD TBD
v1 2018-06-06 2018-06-06 2025-06-04 2025-12-31
v0 2016-12-12 2016-12-12 2018-06-06 2019-06-06
수준 제공되는 지원
미지원 (Unsupported) 구현이 없어요. 특별 요청은 Datadog 지원에 문의하세요.
Preview 초기 구현이에요. 아직 모든 기능을 포함하지 않을 수 있어요. 새 기능 지원과 버그·보안 수정은 최선 노력(best-effort) 기준으로 제공돼요.
GA(General Availability) 모든 기능의 완전한 구현이에요. 새 기능과 버그·보안 수정에 대한 전체 지원을 제공해요.
유지보수 (Maintenance) 기존 기능의 완전한 구현이에요. 새 기능은 받지 않아요. 버그·보안 수정 지원만 제공해요.
EOL(End-of-life) 지원이 없어요.

통합 (Integrations)

프레임워크 호환성 (Framework compatibility)

다음 웹 프레임워크 목록을 헬퍼 패키지 중 하나를 사용해 Go 트레이서와 통합하세요.

참고: 이 문서는 모든 사용자에게 권장되는 Go 트레이서의 v2를 사용해요. v1을 사용 중이라면 마이그레이션 가이드를 참고해 v2로 업그레이드하세요.

지원되는 프레임워크는 Go 트레이서 v1과 v2 사이에서 변경되었어요.

참고: 통합 문서는 지원 패키지와 API, 사용 예시에 대한 자세한 개요를 제공해요.

프레임워크 지원 유형 GoDoc Datadog 문서
Gin 완전 지원 github.com/DataDog/dd-trace-go/contrib/gin-gonic/gin/v2
Gorilla Mux 완전 지원 github.com/DataDog/dd-trace-go/contrib/gorilla/mux/v2
gRPC 완전 지원 github.com/DataDog/dd-trace-go/contrib/google.golang.org/grpc/v2
chi 완전 지원 github.com/DataDog/dd-trace-go/contrib/go-chi/chi/v2
echo v4 완전 지원 github.com/DataDog/dd-trace-go/contrib/labstack/echo.v4/v2
Fiber 완전 지원 github.com/DataDog/dd-trace-go/contrib/gofiber/fiber.v2/v2
라이브러리 호환성 (Library compatibility)

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/kafka.v2/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+는 HELLO, MIGRATE, ACL SETUSER 같은 명령에서 인라인 인증을 지원해요.

  • Datadog Trace Agent: 인증 매개변수가 트레이스 메타데이터에서 자동으로 난독화되도록 보장하는 최소 권장 버전은 7.76.1이에요.
  • Datadog Lambda Extension(서버리스 환경): 최소 필요 버전은 v28.0.0이에요.

패키지는 다음으로 임포트해야 해요:

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

참고: 통합 문서는 지원 패키지와 API, 사용 예시에 대한 자세한 개요를 제공해요.

프레임워크 지원 유형 GoDoc Datadog 문서
Gin 수동 또는 컴파일 타임 gopkg.in/DataDog/dd-trace-go.v1/contrib/gin-gonic/gin
Gorilla Mux 수동 또는 컴파일 타임 🔹 gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux
gRPC 수동 또는 컴파일 타임 gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc
gRPC v1.2 수동 gopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc.v12
chi 수동 또는 컴파일 타임 gopkg.in/DataDog/dd-trace-go.v1/contrib/go-chi/chi
echo v4 수동 또는 컴파일 타임 gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo.v4
echo v3 수동 gopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo
Fiber 수동 또는 컴파일 타임 gopkg.in/DataDog/dd-trace-go.v1/contrib/gofiber/fiber.v2

🔹 컴파일 타임 계측은 라이브러리 내에서 직접 수행되며, //orchestrion:ignore 지시문으로 로컬에서 제외할 수 없어요.

라이브러리 호환성 (Library compatibility)

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/<PACKAGE_DIR>/<PACKAGE_NAME>"

더 알아보기 (Learn more)