.NET and .NET Core Compatibility Requirements

Docs > APM > アプリケーションインスツルメンテーション > 互換性要件 > .NET and .NET Core Compatibility Requirements

The Datadog .NET Tracer supports all .NET-based languages (for example, C#, F#, Visual Basic). It has beta support for trimmed apps.

.NET トレーサーはオープンソースです。詳細については、.NET トレーサーリポジトリを参照してください。

Supported .NET and .NET Core runtimes

The .NET Tracer supports automatic instrumentation on the following .NET and .NET Core versions. It also supports .NET Framework.

.NET Version	マイクロソフトサポート終了	サポートレベル	パッケージバージョン
.NET 8		GA	latest (>= 2.42.0)
.NET 7	05/14/2024	GA	最新版 (>= 2.20.0)
.NET 6		GA	最新版 (>= 2.0.0)
.NET 5	05/10/2022	GA	最新版 (>= 2.0.0)
.NET Core 3.1	12/13/2022	GA	最新
.NET Core 2.1	08/21/2021	GA	最新
.NET Core 3.0	03/03/2020	EOL	非推奨
.NET Core 2.2	12/23/2019	EOL	非推奨
.NET Core 2.0	10/01/2018	EOL	非推奨

Additional information can be found in Microsoft’s .NET and .NET Core Lifecycle Policy, End of life .NET runtime versions, and .NET runtime support policy.

対応プロセッサアーキテクチャー

.NET トレーサーは、次のアーキテクチャーの自動インスツルメンテーションをサポートします:

プロセッサアーキテクチャー	サポートレベル	パッケージバージョン
Windows x86 (`win-x86`)	GA	最新
Windows x64 (`win-x64`)	GA	最新
Linux x64 (`linux-x64`)	GA	最新
Alpine Linux x64 (`linux-musl-x64`)	GA	最新
Linux ARM64 (`linux-arm64`)	GA	.NET 5+ のみ、バージョン 1.27.0 で追加

インテグレーション

最新版 .NET トレーサーでは、以下のライブラリの自動インスツルメンテーションが可能です。

フレームワークまたはライブラリ	NuGet パッケージ	インテグレーション名
ADO.NET	すべての AdoNet インテグレーション	`AdoNet`
Aerospike	`Aerospike.Client` 4.0.0+	`Aerospike`
ASP.NET Core	`Microsoft.AspNetCore` `Microsoft.AspNetCore.App` 2.0+ および 3.0+	`AspNetCore`
Azure Functions	`Microsoft.Azure.Webjobs` 3.0+	`AzureFunctions`
Amazon DynamoDB	`AWSSDK.DynamoDBv2` 3.0+	`AwsDynamoDb`
Amazon Kinesis	`AWSSDK.Kinesis` 3.0+	`AwsKinesis`
Amazon SNS	`AWSSDK.SNS` 3.0+	`AwsSns`
Amazon SQS	`AWSSDK.SQS` 3.0+	`AwsSqs`
CosmosDb	`Microsoft.Azure.Cosmos` 3.6.0+	`CosmosDb`
Couchbase	`CouchbaseNetClient` 2.2.8+	`Couchbase`
Elasticsearch	`Elasticsearch.Net` 5.3.0+	`ElasticsearchNet`
GraphQL .NET	`GraphQL` 2.3.0+	`GraphQL`
gRPC	`Grpc.Net.Client`2.30.0+ (.NET Core 3.0+ のみ) `Grpc.Core` 2.30.0+ `Grpc.AspNetCore` 2.30.0+	`Grpc`
HotChocolate	`HotChocolate` 11.0.0+	`HotChocolate`
HttpClient / HttpMessageHandler	`System.Net.Http` 4.0+	`HttpMessageHandler`
Kafka	`Confluent.Kafka` 1.4+	`Kafka`
IBM MQ	`amqmdnetstd` 9.0.0+	`IbmMq`
MongoDB	`MongoDB.Driver.Core` 2.1.0+	`MongoDb`
MySql	`MySql.Data` 6.7.0+ `MySqlConnector` 0.61.0+	`MySql`
Oracle	`Oracle.ManagedDataAccess` 4.122.0+	`Oracle`
PostgreSQL	`Npgsql` 4.0+	`Npgsql`
プロセス	`"System.Diagnostics.Process"` 4.0+	`Process`
RabbitMQ	`RabbitMQ.Client` 3.6.9+	`RabbitMQ`
Redis (ServiceStack クライアント)	`ServiceStack.Redis` 4.0.48+	`ServiceStackRedis`
Redis (StackExchange クライアント)	`StackExchange.Redis` 1.0.187+	`StackExchangeRedis`
Service Fabric Remoting	`Microsoft.ServiceFabric.Services.Remoting` 4.0.470+	`ServiceRemoting`
SQLite	`System.Data.Sqlite` 2.0.0+ `Microsoft.Data.Sqlite` 1.0.0+	`Sqlite`
SQL Server	`System.Data` 4.0.0+ `System.Data.SqlClient` 4.0.0+ `Microsoft.Data.SqlClient` 1.0.0+	WebClient / WebRequest
WebClient / WebRequest	`System.Net.Requests` 4.0+	`WebRequest`

Don’t see the library you’re looking for? First, check if the library produces observability data compatible with OpenTelemetry (see Using OpenTelemetry Instrumentation Libraries for more details). If not, Datadog is continually adding additional support. Check with the Datadog team for help.

End of life .NET runtime versions

The .NET Tracer works on .NET Core 2.0, 2.1, 2.2, 3.0, and 3.1, and on .NET 5 and 7, but these versions reached their end of life and are no longer supported by Microsoft. See Microsoft’s support policy for more details. Datadog recommends using the latest patch version of .NET 6 or .NET 8. Older versions of .NET and .NET Core may encounter the following runtime issues when enabling automatic instrumentation:

問題	Affected .NET Versions	ソリューション	詳細
Linux/x64 での JIT コンパイラのバグ	2.0.x、 2.1.0-2.1.11、 2.2.0-2.2.5	.NET Core を最新のパッチバージョンにアップグレードするか、リンク先の問題の手順に従います	DataDog/dd-trace-dotnet/issues/302
`en-US` 以外のロケールでのリソース参照に関するバグ	2.0.0	.NET Core を 2.0.3 以上にアップグレードします	dotnet/runtime/issues/23938
JIT Compiler bug causing crash on shutdown	2.0.0-2.2.x	Upgrade .NET Core to 3.1.0 or above	dotnet/runtime/pull/11885
JIT Compiler bug	2.x, 3.x, 5.x, 6.x, 7.x, 8.0.0-8.0.5	Upgrade .NET to 8.0.6 or above	dotnet/runtime/pull/73760
JIT Compiler bug	All versions of .NET	No current workaround	dotnet/runtime/issues/85777
.NET runtime bug causing crashes when used with runtime metrics	6.0.0-6.0.10	Upgrade .NET 6.0.11 or above, or disable runtime metrics	dotnet/runtime/pull/76431

サポートされている Datadog Agent バージョン

Datadog Agent バージョン	パッケージバージョン
7.x	最新
6.x	最新
5.x	最新

.NET runtime support policy

The .NET Tracer depends on the host operating system, .NET runtime, certain .NET libraries, and the Datadog Agent/API. These third party software systems support specific versions of .NET and .NET Core. When the external software no longer supports a version of .NET, the .NET Tracer also limits its support for that version.

サポートレベル

レベル	サポート内容
非対応	実装していません。特別なご要望はカスタマーサポートにお問い合わせください。
ベータ版	初期実装です。まだすべての機能が含まれていない可能性があります。新機能のサポート、バグやセキュリティの修正は、ベストエフォートで提供されます。
一般提供 (GA)	全機能の完全実装。新機能、バグ、セキュリティフィックスを完全サポート。
メンテナンス	既存機能の完全実装。新機能は受けません。バグフィックス、セキュリティフィックスのみの対応となります。
サポート終了 (EOL)	サポートはありません。

パッケージのバージョニング

The .NET Tracer practices semantic versioning. Version updates imply the following changes to runtime support:

メジャーバージョンアップ (例えば 1.0.0 から 2.0.0) により、ランタイムのサポートがベータ版/GAからメンテナンス/EOL に変更される場合があります。
マイナーバージョンアップ (例えば 1.0.0 から 1.1.0) は、あるランタイムのサポートレベルを下げることはありませんが、あるランタイムのサポートは追加されるかもしれません。
パッチバージョンアップ (例えば 1.0.0 から 1.0.1) によって、ランタイムのサポートが変更されることはありません。