利用可能な計装

OpenTelemetry .NET 自動計装は、さまざまなライブラリをサポートしています。

計装

すべての計装は、すべてのシグナルタイプ（トレース、メトリクス、ログ）に対してデフォルトで有効になっています。

特定のシグナルタイプに対するすべての計装を無効にするには、環境変数 OTEL_DOTNET_AUTO_{SIGNAL}_INSTRUMENTATION_ENABLED を false に設定します。

より細かく制御するには、特定のシグナルタイプに対する個別の計装を無効にすることもできます。 環境変数 OTEL_DOTNET_AUTO_{SIGNAL}_{0}_INSTRUMENTATION_ENABLED を false に設定してください。 ここで {SIGNAL} はシグナルのタイプ（例: TRACES）、{0} は大文字小文字を区別する計装の名前です。

トレース計装

ステータス: Mixed。 トレースは安定版ですが、安定したセマンティック規約がないため、個々の計装ライブラリは Experimental ステータスです。

[1]: DbCommand メソッドをカバーする汎用的な ADO.NET 計装です。 オーバーライドされたメソッドの実装のみをカバーします。 通常、多くの実装は C# の new キーワードを利用しているため、そのようなケースには固有の実装が必要です。 この計装は、SQLCLIENT、NPGSQL、MYSQLDATA、MYSQLCONNECTOR、ORACLEMDA、SQLITE などの固有の計装でカバーされるライブラリは対象外です。

[2]: System.Data.Common（≥4.0.0 および <11.0.0）、.NET Framework 用の System.Data（≥2.0.0 および <5.0.0）、および netstandard（≥2.0.0 および <3.0.0）をサポートしています。

[3]: 統合パイプラインモードのみサポートされています。

[4]: ASP.NET (.NET Framework) MVC / WebApi は ARM64 ではサポートされていません。

[5]: 2021年10月1日以降にリリースされた Azure. 接頭辞のパッケージ。

[6]: Elastic.Clients.Elasticsearch バージョン ≥8.0.0 および <8.10.0。 バージョン ≥8.10.0 は Elastic.Transport 計装でサポートされます。

[7]: Confluent.Kafka は、Windows および Linux の ARM64 ではバージョン ≥1.8.2 から、macOS では ≥1.9.2 からサポートされています。

[8]: MongoDB.Driver は 3.7.0 未満のバージョンでのみバイトコード計装が必要です。 3.7.0+ ではソース計装のみを使用します。

[9]: RabbitMq.Client は 5.* および 6.* バージョンでのみバイトコード計装が必要です。 7.0.0+ ではソース計装のみを使用します。

[10]: System.Data.SqlClient は非推奨です。

[11]: Microsoft.Data.SqlClient v3.* は、イシューにより .NET Framework ではサポートされていません。 System.Data.SqlClient はバージョン 4.8.5 からサポートされています。

メトリクス計装

ステータス: Mixed。 メトリクスは安定版ですが、安定したセマンティック規約がないため、個々の計装は Experimental ステータスです。

[1]: ASP.NET メトリクスは、AspNet トレース計装も有効な場合にのみ生成されます。

[2]: System.Data.SqlClient は非推奨です。

[3]: Microsoft.Data.SqlClient v3.* は、イシューにより .NET Framework ではサポートされていません。 System.Data.SqlClient はバージョン 4.8.5 からサポートされています。

ログ計装

ステータス: Experimental。

[1]: ASP.NET Core アプリケーションでは、環境変数 ASPNETCORE_HOSTINGSTARTUPASSEMBLIES を OpenTelemetry.AutoInstrumentation.AspNetCoreBootstrapper に設定することで、.NET CLR プロファイラーを使用せずに LoggingBuilder 計装を有効にできます。

[2]: この計装はトレースコンテキスト注入とログブリッジの両方を提供します。

計装オプション

[1]: .NET Framework 上の SqlCommand の IL リライトを有効にし、SqlClient 計装で db.query.text および db.query.summary が設定されるために必要な CommandText が利用可能であることを保証します。 以前は CommandText はストアドプロシージャに対してのみ利用可能でした。 この設定を有効にすると、生のクエリに対しても利用可能になります。 これにより SqlEventSource が発行するイベントの動作が変更されます。 このメカニズムが使用されている場合、アプリケーションの他の部分に影響を与える可能性があります。