.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 && sudo /opt/datadog/createLogPath.sh

   CentOS 7+ または Fedora

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

   Alpine などの musl ベースの分布

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

   その他の分布

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

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

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

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

.NET Profiler をアプリケーション単位でインストールするには

1. Datadog.Trace.Bundle NuGet パッケージをアプリケーションに追加します。

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 ページにプロファイルが表示されます。

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

   v2.14.0 より、MSI を使用してトレーサーをインストールした場合、CORECLR_PROFILER または COR_PROFILER を設定する必要がありません。

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

   レジストリエディターで、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_SERVICE、DD_ENV、DD_VERSION 環境変数を追加することができます。

   v2.14.0 より、MSI を使用してトレーサーをインストールした場合、CORECLR_PROFILER または COR_PROFILER を設定する必要がありません。

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

   レジストリエディターで、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_SERVICE、DD_ENV、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 ページにプロファイルが表示されます。

2. プロファイリングをアプリケーションにアタッチするために、以下の必要な環境変数を設定します。

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   CORECLR_PROFILER_PATH=<System-dependent path>
   DD_PROFILING_ENABLED=1
   LD_PRELOAD=<System-dependent path>
   DD_SERVICE=MyService
   DD_ENV=production
   DD_VERSION=1.2.3
   DD_DOTNET_TRACER_HOME=<APP_DIRECTORY>/datadog
   

   <APP_DIRECTORY> のプレースホルダーの値は、アプリケーションの .dll ファイルがあるディレクトリへのパスです。環境変数 CORECLR_PROFILER_PATH の値は、アプリケーションが動作しているシステムに応じて変化します。

   オペレーティングシステムとプロセスアーキテクチャ｜CORECLR_PROFILER_PATH の値	LD_PRELOAD の値
   Alpine Linux x64	<APP_DIRECTORY>/datadog/linux-musl-x64/Datadog.Trace.ClrProfiler.Native.so	<APP_DIRECTORY>/datadog/linux-musl-x64/Datadog.Linux.ApiWrapper.x64.so
   Linux x64	<APP_DIRECTORY>/datadog/linux-x64/Datadog.Trace.ClrProfiler.Native.so	<APP_DIRECTORY>/datadog/linux-x64/Datadog.Linux.ApiWrapper.x64.so
   Linux ARM64	<APP_DIRECTORY>/datadog/linux-arm64/Datadog.Trace.ClrProfiler.Native.so	<APP_DIRECTORY>/datadog/linux-arm64/Datadog.Linux.ApiWrapper.x64.so
   Windows x64	<APP_DIRECTORY>\datadog\win-x64\Datadog.Trace.ClrProfiler.Native.dll	N/A
   Windows x86	<APP_DIRECTORY>\datadog\win-x86\Datadog.Trace.ClrProfiler.Native.dll	N/A

3. Linux 上で動作する Docker イメージの場合、createLogPath.sh スクリプトを実行するように構成します。

   RUN /<APP_DIRECTORY>/datadog/createLogPath.sh
   

   Docker のサンプルは dd-trace-dotnet リポジトリで公開されています。

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