.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 8GAlatest (>= 2.42.0)
.NET 705/14/2024GA最新版 (>= 2.20.0)
.NET 6GA最新版 (>= 2.0.0)
.NET 505/10/2022GA最新版 (>= 2.0.0)
.NET Core 3.112/13/2022GA最新
.NET Core 2.108/21/2021GA最新
.NET Core 3.003/03/2020EOL非推奨
.NET Core 2.212/23/2019EOL非推奨
.NET Core 2.010/01/2018EOL非推奨

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
AerospikeAerospike.Client 4.0.0+Aerospike
ASP.NET CoreMicrosoft.AspNetCore
Microsoft.AspNetCore.App
2.0+ および 3.0+		AspNetCore
Azure FunctionsMicrosoft.Azure.Webjobs 3.0+AzureFunctions
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.Net.Client2.30.0+ (.NET Core 3.0+ のみ)
Grpc.Core 2.30.0+
Grpc.AspNetCore 2.30.0+		Grpc
HotChocolateHotChocolate 11.0.0+HotChocolate
HttpClient / HttpMessageHandlerSystem.Net.Http 4.0+HttpMessageHandler
KafkaConfluent.Kafka 1.4+Kafka
IBM MQamqmdnetstd 9.0.0+IbmMq
MongoDBMongoDB.Driver.Core 2.1.0+MongoDb
MySqlMySql.Data 6.7.0+
MySqlConnector 0.61.0+		MySql
OracleOracle.ManagedDataAccess 4.122.0+Oracle
PostgreSQLNpgsql 4.0+Npgsql
プロセス"System.Diagnostics.Process" 4.0+Process
RabbitMQRabbitMQ.Client 3.6.9+RabbitMQ
Redis (ServiceStack クライアント)ServiceStack.Redis 4.0.48+ServiceStackRedis
Redis (StackExchange クライアント)StackExchange.Redis 1.0.187+StackExchangeRedis
Service Fabric RemotingMicrosoft.ServiceFabric.Services.Remoting 4.0.470+ServiceRemoting
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+		WebClient / WebRequest
WebClient / WebRequestSystem.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 shutdown2.0.0-2.2.xUpgrade .NET Core to 3.1.0 or abovedotnet/runtime/pull/11885
JIT Compiler bug2.x, 3.x, 5.x, 6.x, 7.x, 8.0.0-8.0.5Upgrade .NET to 8.0.6 or abovedotnet/runtime/pull/73760
JIT Compiler bugAll versions of .NETNo current workarounddotnet/runtime/issues/85777
.NET runtime bug causing crashes when used with runtime metrics6.0.0-6.0.10Upgrade .NET 6.0.11 or above, or disable runtime metricsdotnet/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) によって、ランタイムのサポートが変更されることはありません。

参考資料

お役に立つドキュメント、リンクや記事:

アプリケーションのインスツルメンテーションドキュメント more more カスタムインスツルメンテーションの例ソースコード more more コンテナ化された ASP.NET コアアプリケーションを監視するGITHUB more more