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

Important

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:

  1. Sign in to the Azure portal.

  2. 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:

    Screenshot of individual App Service resource named DiagService01.

  3. After you've navigated to your resource, click on the Extensions pane and wait for the list of extensions to populate:

    Screenshot of App Service Extensions showing Application Insights extension for Azure App Service installed.

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

    Screenshot of App Service Extensions showing Application Insights extension for Azure App Service with the Delete button highlighted.

  5. Go to the Overview pane of your resource and select Application Insights:

    Screenshot of three buttons. Center button with name Application Insights is selected.

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

    Screenshot of the first-time experience for the Application Insights pane with the Turn on Application Insights button highlighted.

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

    Screenshot of Application Insights App Service Configuration page with Apply button highlighted in red.

  8. After you click Apply, you'll be asked to confirm the changes.

    Note

    The site will be restarted as part of the upgrade process.

    Screenshot of App Service's apply monitoring prompt.

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