Azure App Serviceで.NET Frameworkエージェントをインストール

注記

拡張機能を利用できない場合は、NuGetを使用して.NET Frameworkエージェントを手動でインストールできます。

Azure Portalの拡張機能を使用して.NET Frameworkエージェントをインストールするには:

  1. Azure App Serviceでホストするアプリケーションを作成します。

    これを行うには、Azureアカウントを持っており、ASP.NET FrameworkのWebアプリケーションを作成する必要があります。アプリケーションをAzureに公開し、Contrastエージェントなしで想定通りに機能することを確認します。

  2. エージェントキーを検索し、YAMLを使用してエージェントを設定します。

  3. ホストするアプリケーションにサイトの拡張機能を追加します。

    拡張機能 > 追加 > Contrast.NET Site Extensionを選択します。

    法律条項に同意して、OKボタンをクリックします。拡張機能が正しくインストールされていることを確認します。

    アプリケーションの概要に戻り、再起動を選択します。

  4. アプリケーションの検査結果がContrastに報告されていることを確認します。

ヒント

アプリケーションのSCMサイト(Kudu)の「Site Extensions」メニューからもContrastエージェントをインストールできます。

重要

Contrastエージェントの新しいバージョンが利用可能な場合、 Azure PortalまたはKuduのダッシュボードに通知されます。エージェントの更新を行う前にサイトを停止してください。停止しない場合、更新が失敗する可能性があります。

注記

サイトの拡張機能により、以下のような環境変数がいくつか設定されます。

COR_ENABLE_PROFILING=1
COR_PROFILER={EFEB8EE0-6D39-4347-A5FE-4D0C88BC5BC1}
COR_PROFILER_PATH_32=D:\home\siteextensions\Contrast.Net.Azure.SiteExtension\ContrastAppService\ContrastProfiler-32.dll
COR_PROFILER_PATH_64=D:\home\siteextensions\Contrast.Net.Azure.SiteExtension\ContrastAppService\ContrastProfiler-64.dll
CONTRAST_INSTALL_DIRECTORY=D:\home\siteextensions\Contrast.Net.Azure.SiteExtension\ContrastAppService\
MicrosoftInstrumentationEngine_ConfigPath32_ContrastX86Config=D:\home\siteextensions\Contrast.Net.Azure.SiteExtension\ContrastCieProfiler-32.config
MicrosoftInstrumentationEngine_ConfigPath64_ContrastX64Config=D:\home\siteextensions\Contrast.Net.Azure.SiteExtension\ContrastCieProfiler-64.config

CLR Instrumentation Engine(CIE)がアプリケーションに設定されている場合(例えば、Application Insightsが有効になっているために)、Azureは自動的にCOR_PROFILER*変数を上書きし、CIEのプロファイラを指すようにします。

そして、CIEはMicrosoftInstrumentationEngine_*変数を使用してContrastエージェントをロードするようになります。

CIEがアプリケーションに設定されていない場合、Contrastエージェントのロードに標準のCOR_PROFILER*変数が使用されます。