Migrating from v1 to v2 of the Go Tracer

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.
This documentation assumes that you are using version v1.x of the Go tracer. If you are already using v2.x, see Go Custom Instrumentation using the Datadog API instead.

This guide explains how to migrate from Go Tracer v1.x to v2. See Go tracer support.

Version 2 of the Go tracer introduces significant API improvements:

  • Removes interfaces to enable future flexibility
  • Isolates integrations to prevent false positives from security scanners
  • Enforces library patterns to prevent misuse

To simplify the migration process, Datadog provides a migration tool that handles essential code updates automatically.

Migration tool features

The migration tool automatically updates your tracing code when upgrading from dd-trace-go v1.x to v2.0. It makes the following changes:

  • Updates import URLs from dd-trace-go.v1 to dd-trace-go/v2.
  • Moves imports and using certain types from ddtrace/tracer to ddtrace.
  • Converts Span and SpanContext calls to use pointers.
  • Replaces unsupported WithServiceName() calls with WithService().
  • Updates TraceID() calls to TraceIDLower() for obtaining uint64 trace IDs.

Using the migration tool

Run these commands to use the migration tool:

go get github.com/DataDog/dd-trace-go/v2/tools/v2check
go run github.com/DataDog/dd-trace-go/v2/tools/v2check/main.go

For more information about the migration, see the godoc page for dd-trace-go v2.

Further reading

추가 유용한 문서, 링크 및 기사:

Get started with v1 of the Go TracerDOCUMENTATION more more