Skip to content

Commit 159a410

Browse files
committed
Removing troubleshooting section, adding notes
1 parent 0a93e61 commit 159a410

File tree

1 file changed

+14
-42
lines changed

1 file changed

+14
-42
lines changed

articles/azure-monitor/app/remove-application-insights.md

Lines changed: 14 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -16,23 +16,27 @@ To remove Application Insights, you'll need to remove the NuGet packages and ref
1616

1717
# [.NET](#tab/net)
1818

19-
1. To open the Package Management Console, in the top menu select Tools > NuGet Package Manager > Package Manager Console.
19+
1. To open the Package Management Console, in the top menu select Tools > NuGet Package Manager > Package Manager Console.
2020

2121
![In the top menu click Tools > NuGet Package Manager > Package Manager Console](./media/remove-application-insights/package-manager.png)
22+
23+
> [!NOTE]
24+
> If trace collection is enabled you need to first uninstall Microsoft.ApplicationInsights.TraceListener. Enter `Uninstall-package Microsoft.ApplicationInsights.TraceListener` then follow the steps below to remove Microsoft.ApplicationInsights.Web
25+
2226
1. Enter the following command: `Uninstall-Package Microsoft.ApplicationInsights.Web -RemoveDependencies`
2327

24-
After entering the command, the Application Insights package and all of its dependencies will be uninstalled from the project.
28+
After entering the command, the Application Insights package and all of its dependencies will be uninstalled from the project.
2529

2630
![Enter command in console](./media/remove-application-insights/package-management-console.png)
2731

2832
# [.NET Core](#tab/netcore)
2933

30-
1. To open the Package Management Console, in the top menu select Tools > NuGet Package Manager > Package Manager Console.
34+
1. To open the Package Management Console, in the top menu select Tools > NuGet Package Manager > Package Manager Console.
3135

3236
![In the top menu click Tools > NuGet Package Manager > Package Manager Console](./media/remove-application-insights/package-manager.png)
3337

3438
1. Enter the following command: ` Uninstall-Package Microsoft.ApplicationInsights.AspNetCore -RemoveDependencies`
35-
After entering the command, the Application Insights package and all of its dependencies will be uninstalled from the project
39+
After entering the command, the Application Insights package and all of its dependencies will be uninstalled from the project.
3640

3741
---
3842

@@ -41,11 +45,14 @@ To remove Application Insights, you'll need to remove the NuGet packages and ref
4145
# [.NET](#tab/net)
4246

4347
1. In the *Solution Explore* on the right, right click on **Solution** and select **Manage NuGet Packages for Solution**
44-
You'll then see a screen that allows you to edit all the NuGet packages that are part of the project.
48+
You'll then see a screen that allows you to edit all the NuGet packages that are part of the project.
4549

4650
![Right click Solution, in the Solution Explore, then select Manage NuGet Packages for Solution](./media/remove-application-insights/manage-nuget-framework.png)
51+
52+
> [!NOTE]
53+
> If trace collection is enabled you need to first uninstall Microsoft.ApplicationInsights.TraceListener without remove dependency selected and then follow the steps below to uninstall Microsoft.ApplicationInsights.Web with remove dependency selected.
4754
48-
1. Click on the "Microsoft.ApplicationInsights.Web" package. On the right, check the checkbox next to *Project* to select all projects.
55+
1. Click on the "Microsoft.ApplicationInsights.Web" package. On the right, check the checkbox next to *Project* to select all projects.
4956

5057
1. To remove all dependencies when uninstalling, select the **Options** dropdown button below the section where you selected project.
5158

@@ -54,7 +61,7 @@ To remove Application Insights, you'll need to remove the NuGet packages and ref
5461
1. Select **Uninstall**
5562

5663
![Check remove dependencies, then uninstall](./media/remove-application-insights/uninstall-framework.png)
57-
64+
5865
A dialog box will display that shows all of the dependencies to be removed from the application. Select **ok** to remove them.
5966

6067
![Check remove dependencies, then uninstall](./media/remove-application-insights/preview-uninstall-framework.png)
@@ -214,41 +221,6 @@ When you add Application Insights Telemetry to a Visual Studio ASP.NET Core temp
214221

215222
---
216223

217-
## Troubleshooting
218-
219-
# [.NET](#tab/net)
220-
221-
- Unable to install because another NuGet packages depends on it error.
222-
223-
You will need to uninstall the NuGet package or packages that depend on "Microsoft.ApplicationInsights.Web" first. If you have multiple packages that depend on each other, you need to start with the package that nothing depends on first.
224-
225-
For example, if you have trace collection enabled you may receive an error like the one below when uninstalling Microsoft.ApplicationInsights.Web.
226-
227-
![Error of being able to uninstall Microsoft.ApplicationInsights.Web because Microsoft.ApplicationInsights.TraceListener depends on in](./media/remove-application-insights/uninstall-error1.png)
228-
229-
If that is case you will first uninstall the "Microsoft.ApplicationInsights.TraceListener" package, and then try uninstalling the "Microsoft.ApplicationInsights.Web" again.
230-
231-
If you end up with another error that you can't uninstall "Microsoft.ApplicationInsights.TraceListener" because another package or packages depend on it you can look through those packages and find one that doesn't does not depend on anything to be uninstalled first.
232-
233-
![Error of being able to uninstall Microsoft.ApplicationInsights.TraceListener because Microsoft.ApplicationInsights.Dependency Collector, Microsoft.ApplicationInsights.PerfCounterCollector, and Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel all depend on Microsoft.ApplicationInsights.WindowsServer depends on it](./media/remove-application-insights/uninstall-error2.png)
234-
235-
However in this case Microsoft.ApplicationInsights.Dependency Collector, Microsoft.ApplicationInsights.PerfCounterCollector, and Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel all depend on Microsoft.ApplicationInsights.WindowsServer but Microsoft.ApplicationInsights.WindowsServer depends on Microsoft.ApplicationInsights.Web.
236-
237-
Go back to uninstall Microsoft.ApplicationInsights.Web but this time in *Uninstall Options* select "Force uninstall even if there are dependencies on it" ("Remove dependencies" should still be selected). This will uninstall the package even if it's still being referenced in the project. This option could lead to broken reference in your project; if that happens you make need to [reinstall](https://docs.microsoft.com/nuget/consume-packages/reinstalling-and-updating-packages) those other packages. Then uninstall "Microsoft.ApplicationInsights.TraceListener".
238-
239-
![Select force uninstall](./media/remove-application-insights/force-uninstall.png)
240-
241-
- How to uninstall Microsoft.ApplicationInsights.TraceListener
242-
243-
If you would like to only uninstall Microsoft.ApplicationInsights.TraceListener, follow the steps in "Unable to uninstall because another NuGet package depends on it error" but instead force uninstalling Microsoft.ApplicationInsights.Web, force uninstall "Microsoft.ApplicationInsights.TraceListener".
244-
245-
246-
# [.NET Core](#tab/netcore)
247-
248-
There are currently no known issues with uninstalling the ASP.NET Core SDKs if the steps above are followed.
249-
250-
---
251-
252224
## Next Steps
253225

254226
- [Azure Monitor](https://docs.microsoft.com/azure/azure-monitor/overview)

0 commit comments

Comments
 (0)