.NET のダイナミックインスツルメンテーションを有効にする

Docs > ダイナミックインスツルメンテーション > ダイナミックインスツルメンテーションを有効にする > .NET のダイナミックインスツルメンテーションを有効にする

ダイナミックインスツルメンテーションは、Datadog のトレーシングライブラリをサポートする機能です。すでに APM を使用してアプリケーションのトレースを収集している場合は、Agent とトレーシングライブラリが必要なバージョンであることを確認し、ステップ 4 のダイナミックインスツルメンテーションの有効化に直接進みます。

前提条件

For a better experience, Datadog recommends enabling autocomplete and search (open beta).

インストール

Install or upgrade your Agent to version 7.45.0 or higher.
まだ APM を有効にしていない場合は、Agent の構成で DD_APM_ENABLED 環境変数を true に設定し、ポート 8126/TCP をリッスンします。
Install or upgrade the .NET tracing libraries to version 2.54.0, by following the relevant instructions for .NET Framework or .NET Core.
Note: Dynamic Instrumentation is available in the dd-trace-dotnet library in versions 2.54.0 and later.
DD_DYNAMIC_INSTRUMENTATION_ENABLED 環境変数を true に設定し、ダイナミックインスツルメンテーションを有効にしてサービスを稼働させます。DD_SERVICE、DD_ENV、DD_VERSION の統合サービスタグを指定すると、プローブをフィルターしたりグループ化したり、アクティブなクライアントをこれらの次元でターゲットにすることができるようになります。
ダイナミックインスツルメンテーションを有効にした状態でサービスを起動すると、APM > ダイナミックインスツルメンテーションページでダイナミックインスツルメンテーションの利用を開始することができます。

構成

以下の環境変数を使用してダイナミックインスツルメンテーションを構成します。

環境変数	タイプ	説明
`DD_DYNAMIC_INSTRUMENTATION_ENABLED`	Boolean	ダイナミックインスツルメンテーションを有効にするには、`true` に設定します。
`DD_SERVICE`	文字列	サービス名 (例: `web-backend`)。
`DD_ENV`	文字列	環境名 (例: `production`)。
`DD_VERSION`	文字列	サービスのバージョン。
`DD_TAGS`	文字列	生成されたデータに適用するタグ。タグは `<key>:<value>` をカンマで区切ったリストである必要があります。例: `layer:api,team:intake`