IIS で実行されている .NET アプリケーションのみをインスツルメントするには、以下の手順を実行します。

1. Windows ホスト上の管理者 PowerShell セッションから、以下のいずれかのコマンドを実行します。<YOUR_DD_API_KEY> をユーザーの Datadog API キー に置き換えます。

   PowerShell インストーラーを使用します。

   [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; $env:DD_API_KEY = '<YOUR_DD_API_KEY>'; $env:DD_SITE = '<span class="js-region-param region-param" data-region-param="dd_site"></span>'; $env:DD_APM_INSTRUMENTATION_ENABLED = 'iis'; $env:DD_APM_INSTRUMENTATION_LIBRARIES = 'dotnet:3'; (New-Object System.Net.WebClient).DownloadFile('https://install.datadoghq.com/datadog-installer-x86_64.exe', 'C:\Windows\SystemTemp\datadog-installer-x86_64.exe'); C:\Windows\SystemTemp\datadog-installer-x86_64.exe
   

   Alternatively, install with the MSI:

   $p = Start-Process -Wait -PassThru msiexec -ArgumentList '/qn /norestart /i "https://windows-agent.datadoghq.com/datadog-agent-7-latest.amd64.msi" /log C:\Windows\SystemTemp\install-datadog.log APIKEY="<YOUR_DD_API_KEY>" SITE="<span class="js-region-param region-param" data-region-param="dd_site"></span>" DD_APM_INSTRUMENTATION_ENABLED="iis" DD_APM_INSTRUMENTATION_LIBRARIES="dotnet:3"'
   if ($p.ExitCode -ne 0) { Write-Host "msiexec failed with exit code $($p.ExitCode) please check the logs at C:\Windows\SystemTemp\install-datadog.log" -ForegroundColor Red }
   

   To install a different .NET version, change dotnet:3, or omit DD_APM_INSTRUMENTATION_LIBRARIES to install the latest.

   Note: The Chocolatey installation method does not preserve the SSI settings and cannot be used to enable SSI.

2. Restart the IIS applications you want instrumented. (You do not need to restart the entire IIS server.)

The Agent then automatically loads the Datadog .NET SDK into supported application processes to enable distributed tracing.

Generate the command from Datadog: To get a command pre-filled with your API key and site, go to Install the Datadog Agent on Windows and, in the Customize your observability coverage section, toggle Application Performance Monitoring (APM). To pin the .NET SDK version, select Customize Library Versions under Instrumentation Configuration. Then copy and run the generated command.

Windows ホスト全体で Java および .NET アプリケーションをインスツルメントするには、以下の手順を実行します。

1. Datadog で、Windows に Datadog Agent をインストールする に移動します。

2. Customize your observability coverage セクションで、Application Performance Monitoring (APM) を切り替えます。

3. (オプション) SDK バージョンを設定します。

   デフォルトでは、シングルステップインスツルメンテーションはサポートされている最新バージョンの Datadog .NET および Java SDK をインストールします。特定のバージョンを固定する必要がある場合:

   1. Instrumentation Configuration で、Customize Library Versions を選択します。
   2. .NET で、使用するバージョンを選択します。

4. 提供されたインストールコマンドをコピーし、Windows ホストで実行します。Datadog は、プレビューに登録された後、アプリ内でこのコマンドを生成します。

5. インスツルメンテーションルールを構成します。

   ホスト全体の SSI は、ホスト上のすべての Java アプリケーションと、IIS で実行されているすべての .NET アプリケーションを自動的にインスツルメントします。IIS の外部で実行されている .NET アプリケーションをインスツルメントするには、それらを許可するインスツルメンテーションルールを定義する必要があります。インスツルメンテーションルールを使用して、ホスト上のどの Java アプリケーションまたは IIS 内のどの .NET アプリケーションをインスツルメントするかを詳細に制御することもできます。

6. インスツルメントするサービスを再起動します。