Install the .NET Framework agent for Azure App Service

Complete the following steps for express installation of the .NET agent using Azure Portal Extensions.


If you don't have access to the site extension, you can manually install the .NET Framework agent with Azure App Service.Install the .NET Framework agent for Azure App Service manually

  1. Create an application hosted on Azure App Service.

    To do this you must have an Azure account and create an ASP.NET Framework web app. Publish your application to Azure, and confirm that it works as expected without Contrast.

  2. Find your keys and configure the agent with YAML.

  3. Add the site extension to the hosted application.

    Select Extensions > Add > Contrast.NET Site Extension.

    Select OK and agree to the terms and conditions. Confirm that the site extension installed correctly.

    Go back to the application overview and select Restart.

  4. Confirm that your application is reporting to Contrast.


You can also install the agent from the Site Extensions area of your application management SCM (Kudu) site.


If a new version of the agent is available, it's indicated in the Azure Portal or Kudu dashboard. You must stop the site before starting the update; otherwise, the update may fail.


The site extension sets a number of environment variables, including:


If the CLR instrumentation engine (CIE) is configured for the application (for example, because Application Insights is enabled), Azure should automatically overwrite the COR_PROFILER* variables to point to the profiler of the CIE.

The CIE will then use the MicrosoftInstrumentationEngine_* variables to load the Contrast agent.

If the CIE is not configured for the application, the standard COR_PROFILER* variables will be used to load the Contrast agent.