Edit

Upgrade the Snapshot Debugger

  • Article

Important

Microsoft is moving away from TLS 1.0 and TLS 1.1 due to vulnerabilities. If you're using an older version of the site extension, you need to upgrade your instance of Snapshot Debugger to the latest version.

Depending on how you enabled the Snapshot Debugger, you can follow two primary upgrade paths:

  • Via site extension
  • Via an SDK/NuGet added to your application

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 preinstalled site extension. To avoid conflicts, which might cause your site to stop working, delete the private site extension first. See step 4 in the following procedure.

If you enabled the Snapshot Debugger by using the site extension, you can upgrade by following these steps:

  1. Sign in to the Azure portal.

  2. Go to your resource that has Application Insights and Snapshot Debugger enabled. For example, for a web app, go to the Azure App Service resource.

    Screenshot that shows an individual App Service resource named DiagService01.

  3. Select the Extensions pane. Wait for the list of extensions to populate.

    Screenshot that shows App Service Extensions showing the 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 select Delete. Confirm Yes to delete the extension. Wait for the delete process to finish before you move to the next step.

    Screenshot that shows App Service Extensions showing Application Insights extension for Azure App Service with the Delete button.

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

    Screenshot that shows selecting the Application Insights button.

  6. If this is the first time you've viewed the Application Insights pane for this app service, you're prompted to turn on Application Insights. Select Turn on Application Insights.

    Screenshot that shows the Turn on Application Insights button.

  7. On 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 is activated.

    Screenshot that shows Application Insights App Service Configuration page with the Apply button highlighted.

  8. After you select Apply, you're asked to confirm the changes.

    Note

    The site restarts as part of the upgrade process.

    Screenshot that shows the App Service Apply monitoring settings prompt.

  9. Select Yes to apply the changes and wait for the process to finish.

The site is now upgraded and is ready to use.

Next steps