Skip to main content

Install the .NET Core agent with Azure App Service

Before you begin, check the system requirements and supported technologies to be sure installation will work and ensure best performance.

To complete an express installation of the .NET Core agent using Azure Portal Extensions:

  1. Create an Azure account, if you don't have one already.

  2. Create a .NET Core web application and deploy it to Azure App Service.

  3. Publish your application to Azure, and confirm that it works as expected without Contrast.

  4. Ensure that your application is deployed using a Windows plan. (Linux plans do not support Site Extensions.)


    If you do not have access to the site extension, you can install the .NET Core agent manually with NuGet.

  5. In the Azure Portal, select your hosted application.

  6. Select Configuration under Settings to configure settings that allow the agent to connect to Contrast.

  7. Select New application setting and add the following values for your application:




    Replace with your agent username.


    Replace with your agent service key.


    Replace with your agent API key.


    Defaults to Replace with another URL, if you're using a Contrast application that's hosted elsewhere.

  8. Select Extensions.

    Image shows Azure Portal with Extensions selected.
  9. Select Add.

  10. Select the Contrast .NET Core Site Extension for Azure App Service. This is the extension for .NET Core applications.

  11. Select OK, and agree to the terms and conditions.

  12. Wait a few seconds and confirm the site extension installed correctly.

  13. Go back to the application overview and Restart the application.

  14. Navigate to the application, and confirm the 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 .NET Core 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 CORECLR_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 CORECLR_PROFILER* variables will be used to load the Contrast agent.