Skip to content

Commit 68e9981

Browse files
committed
few minors
1 parent 4059012 commit 68e9981

File tree

2 files changed

+11
-11
lines changed

2 files changed

+11
-11
lines changed

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ The [Application Insights SDK for ASP.NET Core](https://nuget.org/packages/Micro
2828
* **Deployment method**: Framework dependent or self-contained.
2929
* **Web server**: IIS (Internet Information Server) or Kestrel.
3030
* **Hosting platform**: The Web Apps feature of Azure App Service, Azure VM, Docker, Azure Kubernetes Service (AKS), and so on.
31-
* **.NET Core Runtime version**: 1.XX, 2.XX or 3.XX
31+
* **.NET Core Runtime version**: 1.XX, 2.XX, or 3.XX
3232
* **IDE**: Visual Studio, VS Code, or command line.
3333

3434
> [!NOTE]
@@ -124,7 +124,7 @@ Run your application and make requests to it. Telemetry should now flow to Appli
124124

125125
### Live Metrics
126126

127-
[Live Metrics](https://docs.microsoft.com/azure/application-insights/app-insights-live-stream) can be used to quickly verify if Application Insights is setup correctly. While it might take a few minutes before telemetry starts appearing in the portal and analytics, Live Metrics would show CPU usage of the running process in near real-time. It can also show other telemetry like Requests, Dependencies, Traces etc.
127+
[Live Metrics](https://docs.microsoft.com/azure/application-insights/app-insights-live-stream) can be used to quickly verify if Application Insights monitoring is configured correctly. While it might take a few minutes before telemetry starts appearing in the portal and analytics, Live Metrics would show CPU usage of the running process in near real-time. It can also show other telemetry like Requests, Dependencies, Traces etc.
128128

129129
### ILogger logs
130130

@@ -199,7 +199,7 @@ Full List of settings in `ApplicationInsightsServiceOptions`
199199
|---------------|-------|-------
200200
|EnableQuickPulseMetricStream | Enable/Disable LiveMetrics feature | true
201201
|EnableAdaptiveSampling | Enable/Disable Adaptive Sampling | true
202-
|EnableHeartbeat | Enable/Disable Heartbeats feature, which periodically (15 min default) sends a custom metric named 'HeartBeatState' with information about the runtime like .NET Version, Azure Environment information, if applicable, etc. | true
202+
|EnableHeartbeat | Enable/Disable Heartbeats feature, which periodically (15-min default) sends a custom metric named 'HeartBeatState' with information about the runtime like .NET Version, Azure Environment information, if applicable, etc. | true
203203
|AddAutoCollectedMetricExtractor | Enable/Disable AutoCollectedMetrics extractor, which is a TelemetryProcessor that sends pre-aggregated metrics about Requests/Dependencies before sampling takes place. | true
204204
|RequestCollectionOptions.TrackExceptions | Enable/Disable reporting of unhandled Exception tracking by the Request collection module. | false in NETSTANDARD2.0 (because Exceptions are tracked with ApplicationInsightsLoggerProvider), true otherwise.
205205

@@ -249,7 +249,7 @@ public void ConfigureServices(IServiceCollection services)
249249

250250
### Adding telemetry processors
251251

252-
You can add custom telemetry processors to `TelemetryConfiguration` by using the extension method `AddApplicationInsightsTelemetryProcessor` on `IServiceCollection`. You use telemetry processors in [advanced filtering scenarios](https://docs.microsoft.com/azure/azure-monitor/app/api-filtering-sampling#filtering-itelemetryprocessor) to allow for more direct control over what's included or excluded from the telemetry you send to the Application Insights service. Use the following example.
252+
You can add custom telemetry processors to `TelemetryConfiguration` by using the extension method `AddApplicationInsightsTelemetryProcessor` on `IServiceCollection`. You use telemetry processors in [advanced filtering scenarios](https://docs.microsoft.com/azure/azure-monitor/app/api-filtering-sampling#filtering-itelemetryprocessor). Use the following example.
253253

254254
```csharp
255255
public void ConfigureServices(IServiceCollection services)
@@ -273,8 +273,8 @@ The following automatic-collection modules are enabled by default. These modules
273273
* `DependencyTrackingTelemetryModule` - Collects DependencyTelemetry from outgoing http calls and sql calls.
274274
* `PerformanceCollectorModule` - Collects Windows PerformanceCounters.
275275
* `QuickPulseTelemetryModule` - Collects telemetry for showing in Live Metrics portal.
276-
* `AppServicesHeartbeatTelemetryModule` - Collects heart beats (which are send as custom metrics), about Azure App Service environment where application is hosted.
277-
* `AzureInstanceMetadataTelemetryModule` - Collects heart beats (which are send as custom metrics), about Azure VM environment where application is hosted.
276+
* `AppServicesHeartbeatTelemetryModule` - Collects heart beats (which are sent as custom metrics), about Azure App Service environment where application is hosted.
277+
* `AzureInstanceMetadataTelemetryModule` - Collects heart beats (which are sent as custom metrics), about Azure VM environment where application is hosted.
278278
* `EventCounterCollectionModule` - Collects [EventCounters.](#eventcounter). This module is a new feature and is available in SDK Version 2.8.0 and higher.
279279

280280
To configure any default `TelemetryModule`, use the extension method `ConfigureTelemetryModule<T>` on `IServiceCollection`, as shown in the following example.
@@ -347,15 +347,15 @@ If you want to disable telemetry conditionally and dynamically, you may resolve
347347
}
348348
```
349349

350-
Note that the above does not prevent any auto collection modules from collecting telemetry. Only the sending of telemetry to Application Insights gets disabled with the above approach. If a particular auto collection module is not desired, its best to [remove the telemetry module](#configuring-or-removing-default-telemetrymodules)
350+
The above does not prevent any auto collection modules from collecting telemetry. Only the sending of telemetry to Application Insights gets disabled with the above approach. If a particular auto collection module is not desired, it is best to [remove the telemetry module](#configuring-or-removing-default-telemetrymodules)
351351

352352
## Frequently asked questions
353353

354354
### Does Application Insights support ASP.NET Core 3.0?
355355

356356
Yes. Update to [Application Insights SDK for ASP.NET Core](https://nuget.org/packages/Microsoft.ApplicationInsights.AspNetCore) version 2.8.0 or higher. Older versions of the SDK do not support ASP.NET Core 3.0.
357357

358-
Also, if you are using Visual Studio based instructions from [here](#enable-application-insights-server-side-telemetry-visual-studio), please update to the latest version of Visual Studio 2019 (16.3.0) to onboard. Previous versions of Visual Studio do not support automatic onboarding for ASP.NET Core 3.0 apps.
358+
Also, if you are using Visual Studio based instructions from [here](#enable-application-insights-server-side-telemetry-visual-studio), update to the latest version of Visual Studio 2019 (16.3.0) to onboard. Previous versions of Visual Studio do not support automatic onboarding for ASP.NET Core 3.0 apps.
359359

360360
### How can I track telemetry that's not automatically collected?
361361

@@ -388,7 +388,7 @@ For more information about custom data reporting in Application Insights, see [A
388388
389389
### Some Visual Studio templates used the UseApplicationInsights() extension method on IWebHostBuilder to enable Application Insights. Is this usage still valid?
390390

391-
While the extension method `UseApplicationInsights()` is still supported, its marked obsolete in Application Insights SDK version 2.8.0 onwards. It'll be removed in the next major version of the SDK. The recommended way to enable Application Insights telemetry is by using `services.AddApplicationInsightsTelemetry()` because it provides overloads to control some configuration. Also, in ASP.NET Core 3.0 apps, `services.AddApplicationInsightsTelemetry()` is the only way to enable application insights.
391+
While the extension method `UseApplicationInsights()` is still supported, it is marked obsolete in Application Insights SDK version 2.8.0 onwards. It will be removed in the next major version of the SDK. The recommended way to enable Application Insights telemetry is by using `AddApplicationInsightsTelemetry()` because it provides overloads to control some configuration. Also, in ASP.NET Core 3.0 apps, `services.AddApplicationInsightsTelemetry()` is the only way to enable application insights.
392392

393393
### I'm deploying my ASP.NET Core application to Web Apps. Should I still enable the Application Insights extension from Web Apps?
394394

@@ -437,7 +437,7 @@ using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;
437437

438438
### Is this SDK supported for the new .NET Core 3.0 Worker Service template applications?
439439

440-
This SDK requires `HttpContext`, and hence does not work in any non-http applications, including the .NET Core 3.0 Worker Service applications. Refer to [this](worker-service.md) document for enabling application insights in such applications, using the newly release Microsoft.ApplicationInsights.WorkerService SDK.
440+
This SDK requires `HttpContext`, and hence does not work in any non-HTTP applications, including the .NET Core 3.0 Worker Service applications. Refer to [this](worker-service.md) document for enabling application insights in such applications, using the newly release Microsoft.ApplicationInsights.WorkerService SDK.
441441

442442
## Open-source SDK
443443

articles/azure-monitor/app/worker-service.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -292,7 +292,7 @@ The following lists the full telemetry automatically collected by Application In
292292

293293
### Live Metrics
294294

295-
[Live Metrics](https://docs.microsoft.com/azure/application-insights/app-insights-live-stream) can be used to quickly verify if Application Insights is setup correctly. While it might take a few minutes before telemetry starts appearing in the portal and analytics, Live Metrics would show CPU usage of the running process in near real-time. It can also show other telemetry like Requests, Dependencies, Traces etc.
295+
[Live Metrics](https://docs.microsoft.com/azure/application-insights/app-insights-live-stream) can be used to quickly verify if Application Insights monitoring is configured correctly. While it might take a few minutes before telemetry starts appearing in the portal and analytics, Live Metrics would show CPU usage of the running process in near real-time. It can also show other telemetry like Requests, Dependencies, Traces etc.
296296

297297
### ILogger logs
298298

0 commit comments

Comments
 (0)