The Datadog .NET Tracer supports all .NET-based languages (for example, C#, F#, Visual Basic).
.NET トレーサーはオープンソースです。詳細については、.NET トレーサーリポジトリを参照してください。
サポートされている .NET フレームワークのランタイム
The .NET Tracer supports automatic and custom instrumentation on the following .NET Framework versions. It also supports .NET Core and .NET 5+. The .NET Tracer does not support code running in partial trust environments.
| .NET Framework バージョン | マイクロソフトサポート終了 | サポートレベル | パッケージバージョン | Datadog サポート終了 |
|---|
| 4.8.1 | | GA | 最新 | |
| 4.8 | | GA | 最新 | |
| 4.7.2 | | GA | 最新 | |
| 4.7 | | GA | 最新 | |
| 4.6.2 | | GA | 最新 | |
| 4.6.1 | 04/26/2022 | GA | 最新 | |
| 4.6 | 04/26/2022 | EOL | < 2.0.0 (例: 1.31.2) | 04/26/2022 |
| 4.5.2 | 04/26/2022 | EOL | < 2.0.0 (例: 1.31.2) | 04/26/2022 |
| 4.5.1 | 01/12/2016 | EOL | < 2.0.0 (例: 1.31.2) | 04/26/2022 |
| 4.5 | 01/12/2016 | EOL | < 2.0.0 (例: 1.31.2) | 04/26/2022 |
Additional information can be found in Microsoft’s .NET Framework Lifecycle Policy and in .NET runtime support policy.
注: 自動インスツルメンテーションに使用するトレーサーのバージョンを決定する場合、アプリケーションサーバーにインストールされている .NET Framework のバージョンを使用します。たとえば、.NET Framework 4.5.1 をターゲットとしてアプリケーションをコンパイルしたが、アプリケーションは .NET Framework 4.8 がインストールされているサーバー上で実行されている場合、トレーサーの最新バージョンを使用します。マシンにインストールされている .NET Framework のバージョンを確認するには、
Microsoft が提供するガイダンスに従います。
対応プロセッサアーキテクチャー
.NET トレーサーは、次のアーキテクチャーの自動インスツルメンテーションをサポートします:
| プロセッサアーキテクチャー | サポートレベル | パッケージバージョン |
|---|
Windows x86 (win-x86) | GA | 最新 |
Windows x64 (win-x64) | GA | 最新 |
インテグレーション
最新版 .NET トレーサーでは、以下のライブラリの自動インスツルメンテーションが可能です。
| フレームワークまたはライブラリ | NuGet パッケージ | インテグレーション名 |
|---|
| .NET Remoting | 組み込み | Remoting |
| ADO.NET | すべての AdoNet インテグレーション | AdoNet |
| Aerospike | Aerospike.Client 4.0.0+ | Aerospike |
| ASP.NET (Web Forms を含む) | 組み込み | AspNet |
| ASP.NET MVC | Microsoft.AspNet.Mvc 4.0+ | AspNetMvc |
| ASP.NET Web API 2 | Microsoft.AspNet.WebApi 5.1+ | AspNetWebApi2 |
| 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.Core 2.3.0+ | Grpc |
| HotChocolate | HotChocolate 11.0.0+ | HotChocolate |
| HttpClient / HttpMessageHandler | 組み込み | HttpMessageHandler |
| IBM MQ | amqmdnetstd 9.0.0+ | IbmMq |
| Kafka | Confluent.Kafka 1.4+ | Kafka |
| MongoDB | MongoDB.Driver.Core 2.1.0+ | MongoDb |
| MSMQ | 組み込み | Msmq |
| 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 |
| 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 |
| WCF (サーバー) | 組み込み | Wcf |
| WebClient / WebRequest | 組み込み | 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.
サポートされている Datadog Agent バージョン
.NET runtime support policy
The .NET Tracer depends on the host operating system, .NET Framework runtime, certain .NET Framework libraries, and the Datadog Agent/API. These third party software systems support specific versions of .NET Framework. When the external software no longer supports a version of .NET Framework, the .NET Tracer also limits its support for that version.
サポートレベル
| レベル | サポート内容 |
|---|
| 非対応 | 実装していません。特別なご要望はカスタマーサポートにお問い合わせください。 |
| ベータ版 | 初期実装です。まだすべての機能が含まれていない可能性があります。新機能のサポート、バグやセキュリティの修正は、ベストエフォートで提供されます。 |
| 一般提供 (GA) | 全機能の完全実装。新機能、バグ、セキュリティフィックスを完全サポート。 |
| メンテナンス | 既存機能の完全実装。新機能は受けません。バグフィックス、セキュリティフィックスのみの対応となります。 |
| サポート終了 (EOL) | サポートはありません。 |
パッケージのバージョニング
Datadog APM for .NET Framework は、セマンティックバージョニングを実践しています。
バージョンの更新は、ランタイムサポートの以下の変更を意味します。
- メジャーバージョンアップ (例えば
1.0.0 から 2.0.0) により、ランタイムのサポートがベータ版/GAからメンテナンス/EOL に変更される場合があります。 - マイナーバージョンアップ (例えば
1.0.0 から 1.1.0) は、あるランタイムのサポートレベルを下げることはありませんが、あるランタイムのサポートは追加されるかもしれません。 - パッチバージョンアップ (例えば
1.0.0 から 1.0.1) によって、ランタイムのサポートが変更されることはありません。
参考資料
