El rastreador Datadog .NET es compatible con todos los lenguajes basados en .NET (por ejemplo, C#, F#, Visual Basic).

El rastreador .NET es de código abierto. Para más información, consulta el repositorio del rastreador .NET.

Tiempos de ejecución de .NET Framework compatibles

El rastreador .NET es compatible con la instrumentación automática y personalizada en las siguientes versiones de .NET Framework. También admite .NET Core y .NET 5+. El rastreador .NET no admite código que se ejecute en entornos de confianza parcial.

Versión de .NET FrameworkFin del soporte de MicrosoftNivel de compatibilidadVersión del paqueteFin del soporte de Datadog
4.8.1Disponible para el público en generalÚltima versión
4.8Disponible para el público en generalÚltima versión
4.7.2Disponible para el público en generalÚltima versión
4.7Disponible para el público en generalÚltima versión
4.6.2Disponible para el público en generalÚltima versión
4.6.104/26/2022Disponible para el público en generalÚltima versión
4.604/26/2022Fin del soporte (EOL)< 2.0.0 (por ejemplo, 1.31.2)04/26/2022
4.5.204/26/2022Fin del soporte (EOL)< 2.0.0 (por ejemplo, 1.31.2)04/26/2022
4.5.101/12/2016Fin del soporte (EOL)< 2.0.0 (por ejemplo, 1.31.2)04/26/2022
4.501/12/2016Fin del soporte (EOL)< 2.0.0 (por ejemplo, 1.31.2)04/26/2022

Puedes encontrar información adicional en la política de ciclo de vida de .NET Framework de Microsoft y en la política de compatibilidad del tiempo de ejecución de .NET.

Nota: A la hora de decidir qué versión del rastreador utilizar para una instrumentación automática, utiliza la versión de .NET Framework instalada en el servidor de aplicaciones. Por ejemplo, si compilas tu aplicación para que apunte a .NET Framework 4.5.1, pero la aplicación se ejecuta en un servidor que tiene instalado .NET Framework 4.8, utiliza la última versión del rastreador. Para determinar qué versión de .NET Framework está instalada en un equipo, sigue las directrices proporcionadas por Microsoft.

Arquitecturas de procesador compatibles

El rastreador de .NET es compatible con la instrumentación automática en las siguientes arquitecturas:

Arquitecturas de procesadoresNivel de compatibilidadVersión del paquete
Windows x86 (win-x86)Disponible para el público en generalÚltima versión
Windows x64 (win-x64)Disponible para el público en generalÚltima versión

Integraciones

La última versión del rastreador .NET puede instrumentar automáticamente las siguientes bibliotecas:

Marco o bibliotecaPaquete NuGetNombre de la integración
.NET RemotingIntegradoRemoting
ADO.NETTodas las integraciones de AdoNetAdoNet
AerospikeAerospike.Client 4.0.0+Aerospike
ASP.NET (incluidos los formularios web)IntegradoAspNet
ASP.NET MVCMicrosoft.AspNet.Mvc 4.0+AspNetMvc
API Web ASP.NET 2Microsoft.AspNet.WebApi 5.1+AspNetWebApi2
Amazon DynamoDBAWSSDK.DynamoDBv2 3.0+AwsDynamoDb
Amazon KinesisAWSSDK.Kinesis 3.0+AwsKinesis
Amazon SNSAWSSDK.SNS 3.0+AwsSns
Amazon SQSAWSSDK.SQS 3.0+AwsSqs
CosmosDbMicrosoft.Azure.Cosmos 3.6.0+CosmosDb
CouchbaseCouchbaseNetClient 2.2.8+Couchbase
ElasticsearchElasticsearch.Net 5.3.0+ElasticsearchNet
GraphQL .NETGraphQL 2.3.0+GraphQL
gRPCGrpc.Core 2.3.0+Grpc
HotChocolateHotChocolate 11.0.0+HotChocolate
HttpClient/HttpMessageHandlerIntegradoHttpMessageHandler
IBM MQamqmdnetstd 9.0.0+IbmMq
KafkaConfluent.Kafka 1.4+Kafka
MongoDBMongoDB.Driver.Core 2.1.0+MongoDb
MSMQIntegradoMsmq
MySqlMySql.Data 6.7.0+
MySqlConnector 0.61.0+
MySql
OracleOracle.ManagedDataAccess 4.122.0+Oracle
PostgreSQLNpgsql 4.0+Npgsql
Process"System.Diagnostics.Process" 4.0+Process
RabbitMQRabbitMQ.Client 3.6.9+,RabbitMQ
Redis (cliente de ServiceStack)ServiceStack.Redis 4.0.48+ServiceStackRedis
Redis (cliente de StackExchange)StackExchange.Redis 1.0.187+StackExchangeRedis
SQLiteSystem.Data.Sqlite 2.0.0+
Microsoft.Data.Sqlite 1.0.0+
Sqlite
SQL ServerSystem.Data 4.0.0+
System.Data.SqlClient 4.0.0+
Microsoft.Data.SqlClient 1.0.0+
SqlClient
WCF (servidor)IntegradoWcf
WebClient/WebRequestIntegradoWebRequest

¿No ves la biblioteca que buscas? En primer lugar, comprueba si la biblioteca produce datos de observabilidad compatibles con OpenTelemetry (por ejemplo, rastreo basado en actividad). Si no es así, Datadog añade continuamente compatibilidad adicional. Consulta al equipo de Datadog para obtener ayuda.

Integraciones basadas en OpenTelemetry

Algunas bibliotecas proporcionan Rastreo basado en actividad integrado. Este es el mismo mecanismo en el que se basa OpenTelemetry.

Para estas bibliotecas, establece DD_TRACE_OTEL_ENABLED en true, y el rastreador .NET capturará automáticamente sus trazas. Esto es compatible desde la versión 2.21.0.

La siguiente lista de bibliotecas se han probado con esta configuración:

Marco o bibliotecaPaquete NuGetNombre de la integraciónInstrucciones específicas
Azure Service BusAzure.Messaging.ServiceBus 7.14.0+AzureServiceBusConsulta la sección Azure SDK

SDK de Azure

El SDK de Azure proporciona soporte integrado para OpenTelemetry. Actívalo al establecer la variable de entorno AZURE_EXPERIMENTAL_ENABLE_ACTIVITY_SOURCE en true o al establecer el conmutador de contexto Azure.Experimental.EnableActivitySource en true en el código de tu aplicación. Consulta la documentación del SDK de Azure para obtener más detalles.

Versiones compatibles del Datadog Agent

Versión del Datadog AgentVersión del paquete
7.xÚltima versión
6.xÚltima versión
5.xÚltima versión

Política de compatibilidad del tiempo de ejecución de .NET

El rastreador .NET depende del sistema operativo del host, del tiempo de ejecución de .NET Framework, de determinadas bibliotecas de .NET Framework, y del Datadog Agent/API. Estos sistemas de software de terceros son compatibles con versiones específicas de .NET Framework. Cuando el software externo deja de ser compatible con una versión de .NET Framework, el rastreador .NET también limita su compatibilidad con esa versión.

Niveles de compatibilidad

NivelCompatibilidad dada
No compatibleSin implementación. Para solicitudes especiales, contacta con el servicio de atención al cliente.
Fase betaImplementación inicial. Puede que aún no contenga todas las funciones. La compatibilidad de nuevas funciones y correcciones de errores y de seguridad se proporciona en la medida de lo posible.
Disponible para el público en general (GA)Implementación completa de todas las funciones. Compatibilidad completa para nuevas funciones, correcciones de errores y seguridad.
MantenimientoImplementación completa de las funciones existentes. No recibe nuevas funciones. Compatible solo con las correcciones de errores y seguridad.
Fin del soporte (EOL)Sin compatibilidad.

Versionado del paquete

Datadog APM para .NET Framework practica el versionado semántico. Las actualizaciones de versión implican los siguientes cambios en la compatibilidad del tiempo de ejecución:

  • Las actualizaciones de versiones principales (por ejemplo, de 1.0.0 a 2.0.0) pueden cambiar la compatibilidad para cualquier tiempo de ejecución de Fase beta/Disponible para el público en general a Mantenimiento/Fin del soporte.
  • Las actualizaciones de versiones secundarias (por ejemplo, de 1.0.0 a 1.1.0) no reducirán el nivel de compatibilidad con un tiempo de ejecución, pero pueden añadir compatibilidad con otros.
  • Las actualizaciones de la versión del parche (por ejemplo, de 1.0.0 a 1.0.1) no modificarán la compatibilidad con ningún tiempo de ejecución.

Leer más