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

Azure Portalの拡張機能を使用して.NETエージェントをインストールするには、以下を行います。

注記

拡張機能を利用できない場合は、Azure App Serviceで.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エージェントをインストールできます。

重要

エージェントの新しいバージョンが利用可能な場合は、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*変数が使用されます。

: