Install the .NET Core agent for Azure App Service (express)

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.)

  5. Configure settings that allow the agent to connect to Contrast by adding the following values in the Application Settings section of the Configuration blade 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.

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

  7. Select Extensions.

  8. Select Add.

  9. Select the Contrast .NET Core Site Extension. This is the extension for .NET Core applications.

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

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

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

  13. 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.