IISでの.NET トレースの設定

Instana AutoTrace, を有効にするには、以下の手順を実行してください：

1. 次の例のように、エージェント configuration.yaml ・ファイルを変更してください：

   # netcore Tracing
   com.instana.plugin.netcore:
     tracing:
       enabled: true

2. I IS ワーカープロセスが計測機能を確実に読み込むように、IIS のリセットを実行します：

   iisreset

   注： IISをリセットしない場合、IISワーカーには監視機能が適用されず、IISでホストされているアプリケーションのトレースを行うことができません。 アプリケーションが以前に計測対象となっていた場合でも、IISをリセットする必要があります。

3. アプリケーションを開始します。 検出の起動中に、センサーは自動的にトレース機能を有効にします。

IISでホストされている.NET Core アプリケーションの場合、ファイル Web.config に環境変数を追加することで、トレースを手動で設定できます。

手動でトレースを有効にするには、以下の手順を実行してください：

1. アプリケーションに以下のパッケージをインストールしてください：

   • Instana.Tracing.Core
   • Instana.Tracing.Core.Rewriter.Windows

   パッケージが NuGet.org を通じて配布されている場合、アプリケーションを再コンパイルすることなくインストールできます。 以下の方法の 1 つを使用します。

   • nuget.exe 利用可能：計測対象のプロジェクトをコンパイルせずに、を使用して nuget.exe パッケージを復元します。
   • nuget.exe 利用不可：パッケージを直接ダウンロードし、解凍した後、次の手順に従って、解凍したファイルが格納されている場所を指すように環境変数を設定してください。
   注： このパッケージを Instana.Tracing.Core.Rewriter.Windows プロジェクトに追加するか、公開前に追加することができます。

2. アプリケーションのファイル Web.config に、以下の環境変数を追加してください：

   <aspNetCore>
       <environmentVariables>
           <environmentVariable name="CORECLR_ENABLE_PROFILING" value="1" />
           <environmentVariable name="CORECLR_PROFILER" value="{FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}" />
           <environmentVariable name="CORECLR_PROFILER_PATH_64" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x64.dll" />
           <environmentVariable name="CORECLR_PROFILER_PATH_32" value="[Path_to_your_app]/instana_tracing/CoreRewriter_x86.dll" />
           <environmentVariable name="DOTNET_STARTUP_HOOKS" value="[Path_to_your_app]/Instana.Tracing.Core.dll" />
       </environmentVariables>
   </aspNetCore>

   を、アプリケーションディレクトリの実際のパスに置き換えて [Path_to_your_app] ください。

3. 変数を追加したら、次の iisreset コマンドを実行してIISワーカープロセスを再読み込みしてください：

   iisreset

   注： IISをリセットしない場合、IISワーカーには監視機能が適用されず、IISでホストされているアプリケーションのトレースを行うことができません。 アプリケーションが以前に計測対象となっていた場合でも、IISをリセットする必要があります。