Skip to content

Commit 8a4b53b

Browse files
Merge pull request #282207 from AaronMaxwell/aaronmax-asp-net-auto-added-clarification
UUF Feedback 288973
2 parents db7974a + fa1f147 commit 8a4b53b

File tree

1 file changed

+13
-11
lines changed

1 file changed

+13
-11
lines changed

articles/azure-monitor/app/asp-net.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.devlang: csharp
88

99
# Configure Application Insights for your ASP.NET website
1010

11-
This procedure configures your ASP.NET web app to send telemetry to the [Application Insights](./app-insights-overview.md) feature of the Azure Monitor service. It works for ASP.NET apps that are hosted either in your own IIS servers on-premises or in the cloud.
11+
This procedure configures your ASP.NET web app to send telemetry to the [Application Insights](./app-insights-overview.md) feature of the Azure Monitor service. It works for ASP.NET apps that are hosted either in your own Internet Information Servers (IIS) on-premises or in the cloud.
1212

1313
[!INCLUDE [azure-monitor-app-insights-otel-available-notification](../includes/azure-monitor-app-insights-otel-available-notification.md)]
1414

@@ -55,7 +55,7 @@ This section guides you through automatically adding Application Insights to a t
5555

5656
## Add Application Insights manually
5757

58-
This section guides you through manually adding Application Insights to a template-based ASP.NET web app. This section assumes that you're using a web app based on the standard MVC web app template for the ASP.NET Framework.
58+
This section guides you through manually adding Application Insights to a template-based ASP.NET web app. This section assumes that you're using a web app based on the standard Model, View, and Controller (MVC) web app template for the ASP.NET Framework.
5959

6060
1. Add the following NuGet packages and their dependencies to your project:
6161

@@ -65,7 +65,7 @@ This section guides you through manually adding Application Insights to a templa
6565

6666
2. In some cases, the *ApplicationInsights.config* file is created for you automatically. If the file is already present, skip to step 4.
6767

68-
If it's not created automatically, you need to create it yourself. In the root directory of an ASP.NET application, create a new file called *ApplicationInsights.config*.
68+
Create it yourself if it's missing. In the root directory of an ASP.NET application, create a new file called *ApplicationInsights.config*.
6969

7070
3. Copy the following XML configuration into your newly created file:
7171

@@ -220,7 +220,7 @@ This section guides you through manually adding Application Insights to a templa
220220
<ConnectionString>Copy connection string from Application Insights Resource Overview</ConnectionString>
221221
```
222222

223-
5. At the same level of your project as the *ApplicationInsights.config* file, create a folder called *ErrorHandler* with a new C# file called *AiHandleErrorAttribute.cs*. The contents of the file will look like this:
223+
5. At the same level of your project as the *ApplicationInsights.config* file, create a folder called *ErrorHandler* with a new C# file called *AiHandleErrorAttribute.cs*. The contents of the file look like this:
224224

225225
```csharp
226226
using System;
@@ -351,7 +351,7 @@ This section guides you through manually adding Application Insights to a templa
351351

352352
```
353353

354-
You have now successfully configured server-side application monitoring. If you run your web app, you'll see telemetry begin to appear in Application Insights.
354+
At this point, you successfully configured server-side application monitoring. If you run your web app, you see telemetry begin to appear in Application Insights.
355355

356356
## Add client-side monitoring
357357

@@ -443,18 +443,20 @@ To remove Application Insights, you need to remove the NuGet packages and refere
443443

444444
1. If trace collection is enabled, first uninstall the Microsoft.ApplicationInsights.TraceListener package by using the [NuGet Package Manager](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-a-package) but don't remove any dependencies.
445445
1. Uninstall the Microsoft.ApplicationInsights.Web package and remove its dependencies by using the [NuGet Package Manager](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-a-package) and its [Uninstall options](/nuget/consume-packages/install-use-packages-visual-studio#uninstall-options) within the [NuGet Package Manager Options control](/nuget/consume-packages/install-use-packages-visual-studio#nuget-package-manager-options-control).
446-
1. To fully remove Application Insights, check and manually delete the added code or files along with any API calls you added in your project. For more information, see [What is created when you add the Application Insights SDK?](#what-is-created-when-you-add-the-application-insights-sdk).
446+
1. To fully remove Application Insights, check and manually delete the added code or files along with any API calls you added in your project. For more information, see [What is automatically created when you add the Application Insights SDK?](#what-is-automatically-created-when-you-add-the-application-insights-sdk).
447447

448-
### What is created when you add the Application Insights SDK?
448+
### What is automatically created when you add the Application Insights SDK?
449449

450-
When you add Application Insights to your project, it creates files and adds code to some of your files. Solely uninstalling the NuGet Packages won't always discard the files and code. To fully remove Application Insights, you should check and manually delete the added code or files along with any API calls you added in your project.
450+
When you add Application Insights to your project, it automatically creates files and adds code to some of your files. Solely uninstalling the NuGet Packages doesn't always discard the files and code. To fully remove Application Insights, you should check and manually delete the added code or files along with any API calls you added in your project.
451451

452452
When you add Application Insights Telemetry to a Visual Studio ASP.NET project, it adds the following files:
453453

454454
- ApplicationInsights.config
455455
- AiHandleErrorAttribute.cs
456456

457-
The following pieces of code are added:
457+
The following pieces of code are automatically added:
458+
459+
458460

459461
- [Your project's name].csproj
460462

@@ -489,7 +491,7 @@ The following pieces of code are added:
489491

490492
- Layout.cshtml
491493

492-
If your project has a Layout.cshtml file the code below is added.
494+
If your project has a Layout.cshtml file, the following code is added.
493495

494496
```html
495497
<head>
@@ -547,7 +549,7 @@ For the latest updates and bug fixes, [consult the release notes](./release-note
547549

548550
## Release Notes
549551

550-
For version 2.12 and newer: [.NET SDKs (Including ASP.NET, ASP.NET Core, and Logging Adapters)](https://github.com/Microsoft/ApplicationInsights-dotnet/releases)
552+
For version 2.12 and newer: [.NET Software Development Kits (SDKs) including ASP.NET, ASP.NET Core, and Logging Adapters](https://github.com/Microsoft/ApplicationInsights-dotnet/releases)
551553
552554
Our [Service Updates](https://azure.microsoft.com/updates/?service=application-insights) also summarize major Application Insights improvements.
553555

0 commit comments

Comments
 (0)