.NET¶

.NET Tracer をマシン全体にインストールするには、次の手順を実行します。

1. .NET Tracer MSI インストーラーをダウンロードします。OS（x64 または x86）に一致するアーキテクチャの MSI インストーラーを選択してください。
2. 管理者権限で .NET Tracer MSI インストーラーを実行します。 また、PowerShell で次のコマンドを実行して MSI インストーラーを自動化することもできます。Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-apm.msi'。

.NET Tracer をマシン全体にインストールするには、次の手順を実行します。

1. .NET Tracer MSI インストーラーをダウンロードします。OS（x64 または x86）に一致するアーキテクチャの MSI インストーラーを選択してください。
2. OS に応じて以下の該当するインストールパッケージを実行し、適切な権限で .NET トレーサーのログディレクトリ /var/log/datadog/dotnet を作成します。

   Debian or Ubuntu
   sudo dpkg -i ./datadog-dotnet-apm_<TRACER_VERSION>_amd64.deb && /opt/datadog/createLogPath.sh
   CentOS or Fedora
   sudo rpm -Uvh datadog-dotnet-apm<TRACER_VERSION>-1.x86_64.rpm && /opt/datadog/createLogPath.sh
   Alpine or other musl-based distributions
   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm-<TRACER_VERSION>-musl.tar.gz && sh /opt/datadog/createLogPath.sh
   Other distributions
   sudo tar -C /opt/datadog -xzf datadog-dotnet-apm<TRACER_VERSION>-tar.gz && /opt/datadog/createLogPath.sh

シェルのない slim または distroless Docker イメージに .NET Tracer をインストールするには、Dockerfile で次のコマンドを使用します。

• ADD を使って tracer ファイルをコンテナに配置します。
• COPY --chown=$APP_UID を使い、空のフォルダをソースとしてログディレクトリを作成します。

例えば、Dockerfile には次のように記述できます。

ADD datadog-dotnet-apm-<TRACER_VERSION>.tar.gz /opt/datadog/
COPY --chown=$APP_UID --from=<OTHER_STAGE> /empty/ /var/log/datadog/dotnet/

アプリに .NET Tracer を追加する

1. NuGet package を使用して、アプリに Datadog.Trace.Bundle を追加します。

Internet Information Services (IIS)：

1. .NET Tracer MSI インストーラーは必要な環境変数をすべて追加します。ここでは追加の環境変数を設定する必要があります。
2. IIS でホストされているアプリケーションを自動検出するには、管理者として次のコマンドを実行し、IIS を完全に停止してから起動します。

   net stop /y was
   net start w3svc
   

IIS 以外のアプリ

1. アプリケーションに自動計測を追加するため、次の必要な環境変数を設定します。

   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   

2. アプリケーションを再起動します。

1. アプリケーションに自動計測を追加するために必要な環境変数を設定します。

   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  
   

2. アプリケーションを再起動します

.NET アプリにカスタムインストルメンテーションを追加します。

1. アプリケーションコード内で、Datadog.Trace.Tracer.Instance プロパティを通じてグローバルトレーサーにアクセスし、新しい span を作成します。

MSI のインストール後は、追加設定なしで IIS サイトを自動検出できます。すべての IIS サイトに継承される追加の環境変数を設定するには、次の手順を実行します。

1. レジストリエディタを開き、HKLM\System\CurrentControlSet\Services\WAS レジストリキーの Environment という名前のマルチ文字列値を見つけて、環境変数を 1 行ずつ追加します。たとえば、ログ注入と runtime metrics を追加するには、値データに次の行を追加します。
   

   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. 次のコマンドを実行して IIS を再起動します。

   net stop /y was
   net start w3svc
   # さらに、WAS の停止時に停止される他のサービスも起動します。
   

   

コンソールアプリケーションを自動検出するには、アプリケーションの起動前にバッチファイルから環境変数を設定します。

rem 環境変数を設定
SET CORECLR_ENABLE_PROFILING=1
rem v2.14.0+ 以降で、tracer を MSI でインストールした場合を除く
SET CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}

rem 追加の Datadog 環境変数を設定
SET DD_LOGS_INJECTION=true
SET DD_RUNTIME_METRICS_ENABLED=true

rem アプリケーションを起動
dotnet.exe example.dll

アプリケーションの起動前に、bash で必要な環境変数を設定します。

# 環境変数を設定
export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
export CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
export DD_DOTNET_TRACER_HOME=/opt/datadog

# 追加の Datadog 環境変数を設定
export DD_LOGS_INJECTION=true
export DD_RUNTIME_METRICS_ENABLED=true

# アプリケーションを起動
dotnet example.dll

Docker container で環境変数を設定します。

# 環境変数を設定
ENV CORECLR_ENABLE_PROFILING=1
ENV CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
ENV CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
ENV DD_DOTNET_TRACER_HOME=/opt/datadog

# 追加の Datadog 環境変数を設定
ENV DD_LOGS_INJECTION=true
ENV DD_RUNTIME_METRICS_ENABLED=true

# アプリケーションを起動
CMD ["dotnet", "example.dll"]

systemctl で .NET アプリケーションをサービスとして実行する場合、特定のサービスに読み込む必要のある環境変数を追加できます。

1. 次の内容を含む environment.env ファイルを作成します。

   # 環境変数を設定
   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
   
   # 追加の Datadog 環境変数を設定
   DD_LOGS_INJECTION=true
   DD_RUNTIME_METRICS_ENABLED=true
   

2. サービスの設定ファイルで、サービスブロック内から EnvironmentFile として参照します。

   EnvironmentFile=/path/to/environment.env
   ExecStart=<command used to start the application>
   

3. .NET サービスを再起動します。

systemctl で .NET アプリケーションをサービスとして実行する場合、systemctl で実行されるすべてのサービスに対して読み込む環境変数を設定することもできます。

1. systemctl set-environment を実行して必要な環境変数を設定します。

   systemctl set-environment CORECLR_ENABLE_PROFILING=1
   systemctl set-environment CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
   systemctl set-environment CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
   systemctl set-environment DD_DOTNET_TRACER_HOME=/opt/datadog
   
   # 追加の Datadog 環境変数を設定
   systemctl set-environment DD_LOGS_INJECTION=true
   systemctl set-environment DD_RUNTIME_METRICS_ENABLED=true
   

2. systemctl show environment を実行して、環境変数が正しく設定されたことを確認します。

3. アプリケーションサービスを再起動します。