Merge pull request #95572 from pharring/master

Snapshot Debugger Upgrade refresh

Author: GitHubber17

articles/azure-monitor/app/media/snapshot-debugger-upgrade/app-service-resource.png

@@ -4,49 +4,59 @@ description: How to upgrade Snapshot Debugger to the latest version on Azure App
 ms.service:  azure-monitor
 ms.subservice: application-insights
 ms.topic: conceptual
-author: MarioHewardt
-ms.author: marioh
+author: pharring
+ms.author: pharring
 ms.date: 03/28/2019
 
 ms.reviewer: mbullwin
 ---
 
 # 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 are 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. 
+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. 
 There are two primary upgrade paths depending on if you enabled the Snapshot Debugger using a site extension or if you used an SDK/Nuget added to your application. Both upgrade paths are discussed below. 
 
 ## Upgrading the site extension
 
-If you enabled the Snapshot debugger using the site extension, you can easily upgrade using the following procedure:
+> [!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. Navigate to your resource that has Application Insights and Snapshot debugger enabled. For example, for a Web App, navigate to the App Service resource:
 
    ![Screenshot of individual App Service resource named DiagService01](./media/snapshot-debugger-upgrade/app-service-resource.png)
 
-3. Once you have navigated to your resource, click on Application Insights in the Overview blade:
+3. Once you've navigated to your resource, click on the Extensions blade and wait for the list of extensions to populate:
+
+   ![Screenshot of App Service Extensions showing Application Insights extension for Azure App Service installed](./media/snapshot-debugger-upgrade/application-insights-site-extension-to-be-deleted.png)
+
+4. If any version of _Application Insights extension for Azure App Service_ is installed, then 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](./media/snapshot-debugger-upgrade/application-insights-site-extension-delete.png)
+
+5. Go to the Overview blade of your resource and click on Application Insights:
 
    ![Screenshot of three buttons. Center button with name Application Insights is selected](./media/snapshot-debugger-upgrade/application-insights-button.png)
 
-4. A new blade will open with the current settings. Unless you want to take the opportunity to change your settings, you can leave them as is. The **Apply** button on the bottom of the blade is not enabled by default and you will have to toggle one of the settings to activate the button. You don’t have to change any actual settings, rather you can change the setting and then immediately change it back. We recommend toggling the Profiler setting and then selecting **Apply**.
+6. If this is the first time you've viewed the Application Insights blade 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 blade with the Turn on Application Insights button highlighted](./media/snapshot-debugger-upgrade/turn-on-application-insights.png)
+
+7. The current Application Insights settings are displayed. Unless you want to take the opportunity to change your settings, you can leave them as is. The **Apply** button on the bottom of the blade isn't enabled by default and you'll have to toggle one of the settings to activate the button. You don’t have to change any actual settings, rather you can change the setting and then immediately change it back. We recommend toggling the Profiler setting and then selecting **Apply**.
 
    ![Screenshot of Application Insights App Service Configuration page with Apply button highlighted in red](./media/snapshot-debugger-upgrade/view-application-insights-data.png)
 
-5. Once you click **Apply**, you will be asked to confirm the changes.
+8. Once 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. Text box displays message: "We will now apply changes to your app settings and install our tools to link your Application Insights resource to the web app. This will restart the site. Do you want to continue?"](./media/snapshot-debugger-upgrade/apply-monitoring-settings.png)
 
-6. Click **Yes** to apply the changes. During the process a notification will appear showing that changes are being applied:
-
-   ![Screenshot of Apply Changes - Updating extensions message that appears in the upper right corner](./media/snapshot-debugger-upgrade/updating-extensions.png)
-
-Once completed, a **"Changes are applied"** notification will appear.
-
-   ![Screenshot of message stating changes are applied](./media/snapshot-debugger-upgrade/changes-are-applied.png)
+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.