.NET プロファイラーの有効化

.NET Profiler をマシン全体にインストールするには

1. お使いの OS とアーキテクチャに対応した最新の .NET Tracer パッケージをダウンロードします。

2. 以下のコマンドのいずれかを実行して、パッケージをインストールし、適切な権限で .NET のログディレクトリ /var/log/datadog/dotnet を作成します。

   Debian または Ubuntu

   sudo dpkg -i ./datadog-dotnet-apm_<TRACER_VERSION>_amd64.deb && /opt/datadog/createLogPath.sh

   CentOS 8+ または Fedora

   sudo rpm -Uvh datadog-dotnet-apm<TRACER_VERSION>-1.x86_64.rpm && /opt/datadog/createLogPath.sh

   Alpine などの musl ベースの分布

   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm<TRACER_VERSION>-musl.tar.gz && sh /opt/datadog/createLogPath.sh

   その他の分布

   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm<TRACER_VERSION>-tar.gz && /opt/datadog/createLogPath.sh

1. .NET Monitoring MSI インストーラーを使って、最新版をインストールまたはアップグレードしてください。Continuous Profiler は 64-bit Windows をサポートしていますので、datadog-dotnet-apm-<VERSION>-x64.msi のようなファイルが必要です。

2. インストーラーを管理者権限で実行します。

3. 自動インスツルメンテーションをアプリケーションにアタッチするために、以下の必要な環境変数を設定します。

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   DD_DOTNET_TRACER_HOME=/opt/datadog
   LD_PRELOAD=/opt/datadog/continuousprofiler/Datadog.Linux.ApiWrapper.x64.so
   DD_PROFILING_ENABLED=1
   DD_ENV=production
   DD_VERSION=1.2.3
   

4. スタンドアロンアプリケーションの場合は、通常通り手動でアプリケーションを再起動します。

5. アプリケーションの起動 1〜2 分後、[Datadog APM > Profiler ページ][1]にプロファイルが表示されます。

3. プロファイラーを構成し、有効にするために必要な環境変数を設定します。IIS アプリケーションのプロファイラーを有効にするには、レジストリの HKLM\System\CurrentControlSet\Services\WAS と HKLM\System\CurrentControlSet\Services\W3SVC ノードで環境変数 DD_PROFILING_ENABLED、DD_ENV、DD_SERVICE および DD_VERSION を設定する必要があります。

   レジストリエディターを使用:

   レジストリエディターで、HKLM\System\CurrentControlSet\Services\WAS と HKLM\System\CurrentControlSet\Services\W3SVC ノード内の Environment という複数文字列値を変更し、以下のように値を設定します。

   .NET Core と .NET 5+ の場合:

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   DD_PROFILING_ENABLED=1
   DD_ENV=production
   DD_VERSION=1.2.3
   

   .NET Framework の場合:

   COR_ENABLE_PROFILING=1
   COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   DD_PROFILING_ENABLED=1
   DD_ENV=production
   DD_VERSION=1.2.3
   

   注: 環境変数は、すべての IIS アプリケーションに適用されます。IIS 10 以降、C:indexWindowsSystem32/inetsrv/config/applicationhost.config ファイルに IIS アプリケーションごとの環境変数が設定できるようになりました。詳細は、Microsoft のドキュメントを参照してください。

4. 管理者権限で以下のコマンドを実行し、IIS を完全に停止・起動します。

   net stop /y was
   net start w3svc
   

   Note: Use stop and start commands. A reset or restart does not always work.

5. アプリケーションの起動 1〜2 分後、Datadog APM > Profiler ページにプロファイルが表示されます。

3. プロファイラーを構成し、有効にするために必要な環境変数を設定します。サービスのプロファイラーを有効にするには、サービスに関連付けられたレジストリキーで環境変数 DD_PROFILING_ENABLED、DD_ENV、DD_SERVICE および DD_VERSION を設定する必要があります。

   レジストリエディターを使用:

   レジストリエディターで、HKLM\System\CurrentControlSet\Services\MyService キーに Environment 複数の文字列値を作成します。

   .NET Core と .NET 5+ の場合:

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   DD_PROFILING_ENABLED=1
   DD_SERVICE=MyService
   DD_ENV=production
   DD_VERSION=1.2.3
   

   .NET Framework の場合:

   COR_ENABLE_PROFILING=1
   COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   DD_PROFILING_ENABLED=1
   DD_SERVICE=MyService
   DD_ENV=production
   DD_VERSION=1.2.3
   

   PowerShell スクリプトを使用:

   .NET Core と .NET 5+ の場合:

   [string[]] $v = @(
       "CORECLR_ENABLE_PROFILING=1",
       "CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}",
       "DD_PROFILING_ENABLED=1",
       "DD_SERVICE=MyService",
       "DD_ENV=production",
       "DD_VERSION=1.2.3"
   )
   Set-ItemProperty HKLM:SYSTEM\CurrentControlSet\Services\MyService -Name Environment -Value $v
   

   .NET Framework の場合:

   [string[]] $v = @(
       "COR_ENABLE_PROFILING=1",
       "COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}",
       "DD_PROFILING_ENABLED=1",
       "DD_SERVICE=MyService",
       "DD_ENV=production",
       "DD_VERSION=1.2.3"
   )
   Set-ItemProperty HKLM:SYSTEM\CurrentControlSet\Services\MyService -Name Environment -Value $v
   

4. アプリケーションの起動 1〜2 分後、Datadog APM > Profiler ページにプロファイルが表示されます。

3. コンソール、ASP.NET (Core)、Windows Forms、WPF などの非サービスアプリケーションでプロファイラーを構成して有効にするために、必要な環境変数を設定します。スタンドアロンアプリケーションのプロファイラーを有効にするには、DD_PROFILING_ENABLED、DD_ENV、DD_SERVICE および DD_VERSION 環境変数を設定する必要があります。推奨される方法は、これらを設定しアプリケーションを起動するバッチファイルを作成し、そのバッチファイルを使用してアプリケーションを実行することです。

   .NET Core と .NET 5+ の場合:

   SET CORECLR_ENABLE_PROFILING=1
   SET CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   SET DD_PROFILING_ENABLED=1
   SET DD_SERVICE=MyService
   SET DD_ENV=production
   SET DD_VERSION=1.2.3
   
   REM start the application here
   

   .NET Framework の場合:

   SET COR_ENABLE_PROFILING=1
   SET COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   SET DD_PROFILING_ENABLED=1
   SET DD_SERVICE=MyService
   SET DD_ENV=production
   SET DD_VERSION=1.2.3
   
   REM start the application here
   

4. アプリケーションの起動 1〜2 分後、Datadog APM > Profiler ページにプロファイルが表示されます。