Go 호환성 요구사항 (Go Compatibility Requirements)
Go Datadog Trace 라이브러리의 호환성 요구사항을 안내해요.
출처: 문서
본문
호환성 (Compatibility)
Go Datadog Trace 라이브러리는 오픈소스예요. 자세한 내용은 GitHub 저장소를 참고하세요.
Go Datadog Trace 라이브러리에는 Go 버전에 대해 정의된 버전 지원 정책이 있어요. Go의 가장 최신 릴리스 두 개는 완전히 지원되고, 그 다음으로 최신인 릴리스는 유지보수(maintenance) 단계로 간주돼요. 더 오래된 버전은 동작할 수 있지만 기본적으로 지원이 제공되지 않아요. 특별한 요청은 지원팀에 문의하세요.
요구사항 (Requirements)
- Datadog Agent v5.21.1 이상.
- 통합을 구성하기 전에 다음 방법 중 하나로 애플리케이션을 계측하세요:
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, 사용 예시에 대한 자세한 개요를 제공해요.
라이브러리 호환성 (Library compatibility)
Go 트레이서는 다음 데이터 저장소와 라이브러리를 지원해요.
참고: 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 트레이서는 다음 데이터 저장소와 라이브러리를 지원해요.
패키지는 다음으로 임포트해야 해요:
import "gopkg.in/DataDog/dd-trace-go.v1/contrib/<PACKAGE_DIR>/<PACKAGE_NAME>"