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

Internet Information Services (IIS) でホストされている.NET Framework アプリケーションのトレース設定は、 Instana AutoTrace を使用して行うことができます。 Instana エージェントは、IISでホストされているアプリケーションに対して、環境変数を自動的に設定し、トレースコンポーネントを登録します。

このトピックでは、以下の内容を取り上げます:

準備

IISで.NET Framework のトレースを設定するには、次の手順を実行してください:

  • ホストマシン上で Instana エージェントが実行されていることを確認してください。 「 Windows へのエージェントのインストール」 を参照してください。
  • ホストマシン上で InstanaPCP が実行されていることを確認してください。 InstanaPCP これにより、 Instana エージェントが.NET Framework アプリケーションと通信できるようになります。 InstanaPCP.exeInstanaPCP が実行されているかどうかを確認するには、 Windows でタスクマネージャーを開き、.を探してください。
  • お使いのアプリケーションが、.NET Framework 4.5.2 以降で動作することを確認してください。
  • サポート情報を確認してください。

トレースの使用可能化

IISでホストされている.NET アプリケーションの場合、 Instana ホストエージェントをインストールすると、 Instana トレース拡張機能(CLR Tracer)が自動的にインストールされます。 InstanaPCP レジストリに.NET Framework の自動トレースに必要な環境変数を自動的に設定し、 Instana のトレースDLLをグローバル・アセンブリ・キャッシュ(GAC)にインストールします。

IISでホストされているアプリケーションのトレースを有効にするには、次の手順を実行してください:

  1. エージェント configuration.yaml ファイルでトレースが有効になっていることを確認してください:

    # .NET Full Framework tracing
    com.instana.plugin.clr:
      tracing:
        enabled: true
    注: センサーおよびトレース拡張機能は、デフォルトで有効になっています。
  2. true(任意):アプリケーションがマルチドメイン構成の場合は、環境変数を INSTANA_NET_ENABLE_MULTIDOMAIN に設定してください。

  3. Instana エージェントと InstanaPCP アプリケーションが起動したら、次の iisreset コマンドを実行してください:

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