Requisitos de compatibilidad de Go

Compatibilidad

La biblioteca de rastreo de Go Datadog es de código abierto; consulta el repositorio GitHub para más información.

La biblioteca de traces (trazas) de Go Datadog tiene una política de compatibilidad de versiones definida para las versiones de Go. Las dos últimas versiones de Go son totalmente compatibles, mientras que la tercera versión más reciente se considera en mantenimiento. Las versiones más antiguas pueden funcionar, pero no se proporciona compatibilidad predeterminada. Para solicitudes especiales, ponte en contacto con asistencia técnica.

Requisitos

Compatibilidad del rastreador de Go

Datadog recomienda la v2 del rastreador de Go para todos los usuarios. Si utilizas la v1, consulta la guía de migración para actualizar a la v2.

VersiónVista previaDisponibilidad general (GA)MantenimientoFin de vida (EOL)
v227-11-202404-06-2025TBDTBD
v106-06-201806-06-201804-06-202531-12-2025
v012-12-201612-12-201606-06-201806-06-2019
NivelCompatibilidad brindada
Sin compatibilidadSin implementación. Ponte en contacto con asistencia técnica de Datadog para solicitudes especiales.
Vista previaImplementación inicial. Puede que aún no contenga todas las funciones. La compatibilidad con las nuevas funciones y la corrección de errores y problemas de seguridad se realiza en la medida de lo posible.
Disponibilidad general (GA)Implementación completa de todas las funciones. Compatibilidad completa para nuevas funciones y correcciones de errores y seguridad.
MantenimientoImplementación completa de las funciones existentes. No recibe nuevas funciones. Compatibilidad solo para correcciones de errores y seguridad.
Fin de vida (EOL)Sin compatibilidad.

integraciones

Compatibilidad del marco

Integra el rastreador de Go con la siguiente lista de marcos web utilizando uno de los siguientes paquetes de ayuda.

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.

Los marcos admitidos han cambiado entre la v1 y la v2 del rastreador de Go

    Nota: La documentación de integraciones proporciona una información general detallada de los paquetes admitidos y sus API, junto con ejemplos de uso.

    FrameworkTipo de soporte técnicoDocumentación de GoDoc Datadog
    [Gin] 6Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gin-gonic/gin/v2
    Gorilla MuxTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gorilla/mux/v2
    gRPCTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/google.golang.org/grpc/v2
    chiTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/go-chi/chi/v2
    echo v4Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/labstack/echo.v4/v2
    FiberTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gofiber/fiber.v2/v2

    Compatibilidad de la biblioteca

    El rastreador Go incluye compatibilidad con los siguientes almacenes de datos y bibliotecas.

    BibliotecaTipo de soporte técnicoEjemplos y documentación
    AWS SDKTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/aws/aws-sdk-go/aws/v2
    AWS SDK v2Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/aws/aws-sdk-go-v2/aws/v2
    ElasticsearchTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/olivere/elastic.v5/v2
    CassandraTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gocql/gocql/v2
    GraphQLTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/graph-gophers/graphql-go/v2
    HTTPTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/net/http/v2
    Enrutador HTTPTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/julienschmidt/httprouter/v2
    Redis (go-redis)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/go-redis/redis/v2
    Redis (go-redis-v8)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/go-redis/redis.v8/v2
    Redis (redigo)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/garyburd/redigo/v2
    Redis (nuevo redigo)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gomodule/redigo/v2
    SQLTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/database/sql/v2
    SQLxTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/jmoiron/sqlx/v2
    MongoDBTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/go.mongodb.org/mongo-driver/mongo/v2
    MongoDB (mgo)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/globalsign/mgo/v2
    BuntDBTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/tidwall/buntdb/v2
    LevelDBTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/syndtr/goleveldb/leveldb/v2
    miekg/dnsTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/miekg/dns/v2
    Kafka (confluente)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/confluentinc/confluent-kafka-go/v2
    Kafka (sarama)Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/IBM/sarama/v2
    API de GoogleTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/google.golang.org/api/v2
    go-restfulTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/emicklei/go-restful.v3/v2
    TwirpTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/twitchtv/twirp/v2
    VaultTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/hashicorp/vault/v2
    ConsulTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/hashicorp/consul/v2
    Gorm v2Totalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/gorm.io/gorm.v1/v2
    KubernetesTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/k8s.io/client-go/kubernetes/v2
    MemcacheTotalmente compatiblegithub.com/DataDog/dd-trace-go/contrib/bradfitz/gomemcache/memcache/v2

    Los paquetes deben importarse con:

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

    Nota: La documentación de integraciones proporciona una información general detallada de los paquetes admitidos y sus API, junto con ejemplos de uso.

    FrameworkTipo de soporte técnicoDocumentación de GoDoc Datadog
    [Gin] 6Manual o en el momento de la compilacióngopkg.in/DataDog/dd-trace-go.v1/contrib/gin-gonic/gin
    Gorilla MuxManual o en el momento de la compilación🔹gopkg.in/DataDog/dd-trace-go.v1/contrib/gorilla/mux
    gRPCManual o en el momento de la compilacióngopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc
    gRPC v1.2Manualgopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/grpc.v12
    chiManual o en el momento de la compilacióngopkg.in/DataDog/dd-trace-go.v1/contrib/go-chi/chi
    echo v4Manual o en el momento de la compilacióngopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo.v4
    echo v3Manualgopkg.in/DataDog/dd-trace-go.v1/contrib/labstack/echo
    FiberManual o en el momento de la compilacióngopkg.in/DataDog/dd-trace-go.v1/contrib/gofiber/fiber.v2

    🔹 La instrumentación en el momento de la compilación se realiza directamente dentro de la biblioteca y no puede excluirse localmente mediante la directiva //orchestrion:ignore.

    Compatibilidad de la biblioteca

    El rastreador Go incluye compatibilidad con los siguientes almacenes de datos y bibliotecas.

    BibliotecaTipo de soporte técnicoEjemplos y documentación
    AWS SDKTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go/aws
    AWS SDK v2Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/aws/aws-sdk-go-v2/aws
    ElasticsearchTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/olivere/elastic
    CassandraTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/gocql/gocql
    GraphQLTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/graph-gophers/graphql-go
    HTTPTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/net/http
    Enrutador HTTPTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/julienschmidt/httprouter
    Redis (go-redis)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis
    Redis (go-redis-v8)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/go-redis/redis.v8
    Redis (redigo)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/garyburd/redigo
    Redis (nuevo redigo)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/gomodule/redigo
    SQLTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql
    SQLxTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/jmoiron/sqlx
    MongoDBTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/go.mongodb.org/mongo-driver/mongo
    MongoDB (mgo)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/globalsign/mgo
    BuntDBTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/tidwall/buntdb
    LevelDBTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/syndtr/goleveldb/leveldb
    miekg/dnsTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/miekg/dns
    Kafka (confluente)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/confluentinc/confluent-kafka-go
    Kafka (sarama)Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/Shopify/sarama
    API de GoogleTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/google.golang.org/api
    go-restfulTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/emicklei/go-restful
    TwirpTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/twitchtv/twirp
    VaultTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/vault
    ConsulTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/hashicorp/consul
    GormTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/jinzhu/gorm
    Gorm v2Totalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/gorm.io/gorm.v1
    KubernetesTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/k8s.io/client-go/kubernetes
    MemcacheTotalmente compatiblegopkg.in/DataDog/dd-trace-go.v1/contrib/bradfitz/gomemcache/memcache

    Los paquetes deben importarse con:

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

    Referencias adicionales

    Más enlaces, artículos y documentación útiles:

    Instrumentar tu aplicaciónDOCUMENTACIÓN more more