.NET Core 互換性要件

.NET トレーサーは、すべての .NET ベースの言語 (例えば、C#、F#、Visual Basic など) をサポートしています。オープンソースです。詳細は、.NET トレーサーのリポジトリを参照してください。

サポートされている .NET Core のランタイム

.NET トレーサーは、以下の .NET Core バージョンでの自動インスツルメンテーションに対応しています。また、.NET Framework にも対応しています。

バージョンマイクロソフトサポート終了サポートレベルパッケージバージョン
.NET 7GA最新版 (>= 2.20.0)
.NET 6GA最新版 (>= 2.0.0)
.NET 5GA最新版 (>= 2.0.0)
.NET Core 3.112/03/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非推奨

その他の情報は、マイクロソフトの .NET コアライフサイクルポリシー、APM .NET Core バージョン終了のお知らせおよび .NET Core APM のランタイムサポートポリシーに記載されています。

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

.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
AWS SQSAWSSDK.SQS 3.0+AwsSqs
CosmosDbMicrosoft.Azure.Cosmos.Client 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
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
WCF (サーバー)組み込みWcf
WebClient / WebRequestSystem.Net.Requests 4.0+WebRequest

希望するフレームワークが見つかりませんか？Datadog では継続的にサポートを追加しています。サポートが必要な場合は、Datadog チームにお問い合わせください。

.NET Core バージョン終了のお知らせ

.NET トレーサーは .NET コア 2.0、2.1、2.2、3.0 で動作しますが、これらのバージョンはサポートが終了しており、Microsoft ではサポートされていません。詳細については、Microsoft のサポートポリシーを参照してください。Datadog では、.NET Core 3.1、.NET 5、.NET 6、または .NET 7 の最新のパッチバージョンを使用することをお勧めします。古いバージョンの .NET Core では、自動インスツルメンテーションを有効にすると、次のようなランタイム問題が発生することがあります。

問題影響を受ける .NET Core バージョンソリューション詳細
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

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

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

.NET Core APM のランタイムサポートポリシー

Datadog APM for .NET Core は、ホスト OS、.NET Core ランタイム、特定の .NET Core ライブラリ、Datadog Agent/API に依存しています。これらのサードパーティソフトウェアシステムは、.NET Core の特定のバージョンをサポートしています。外部ソフトウェアが .NET Core のバージョンをサポートしなくなった場合、Datadog APM for .NET Core もそのバージョンのサポートを制限します。

サポートレベル

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

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

Datadog APM for .NET Core は、セマンティックバージョニングを実践しています。 バージョンの更新は、ランタイムサポートの以下の変更を意味します。

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

その他の参考資料

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

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