Upgrading the Snapshot Debugger
To provide the best possible security for your data, Microsoft is moving away from TLS 1.0 and TLS 1.1, which have been shown to be vulnerable to determined attackers. If you're using an older version of the site extension, it will require an upgrade to continue working. This document outlines the steps needed to upgrade your Snapshot debugger to the latest version.
You can follow two primary upgrade paths, depending on how you enabled the Snapshot Debugger:
- Via site extension
- Via an SDK/NuGet added to your application
This article discusses both upgrade paths.
Upgrading the site extension
Older versions of Application Insights used a private site extension called Application Insights extension for Azure App Service. The current Application Insights experience is enabled by setting App Settings to light up a pre-installed site extension. To avoid conflicts, which may cause your site to stop working, it is important to delete the private site extension first. See step 4 below.
If you enabled the Snapshot debugger using the site extension, you can upgrade using the following procedure:
Sign in to the Azure portal.
Go to to your resource that has Application Insights and Snapshot debugger enabled. For example, for a Web App, go to to the App Service resource:
After you've navigated to your resource, click on the Extensions pane and wait for the list of extensions to populate:
If any version of Application Insights extension for Azure App Service is installed, select it and click Delete. Confirm Yes to delete the extension and wait for the delete to complete before moving to the next step.
Go to the Overview pane of your resource and select Application Insights:
If this is the first time you've viewed the Application Insights pane for this App Service, you'll be prompted to turn on Application Insights. Select Turn on Application Insights.
In the Application Insights settings pane, switch the Snapshot Debugger setting toggles to On and select Apply.
If you decide to change any Application Insights settings, the Apply button on the bottom of the pane will be activated.
After you click Apply, you'll be asked to confirm the changes.
The site will be restarted as part of the upgrade process.
Click Yes to apply the changes and wait for the process to complete.
The site has now been upgraded and is ready to use.
Upgrading Snapshot Debugger using SDK/Nuget
If the application is using a version of
Microsoft.ApplicationInsights.SnapshotCollector below version 1.3.1, it will need to be upgraded to a newer version to continue working.