few minor adjustments.

Author: cijothomas

articles/azure-monitor/app/eventcounters.md

@@ -15,17 +15,17 @@ ms.author: cithomas
 ---
 # EventCounters introduction
 
-`EventCounter` is .NET/.NET Core mechanism to publish and consume counters or statistics. [This](https://github.com/dotnet/corefx/blob/master/src/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md) document gives an overview of `EventCounters` and examples on how to publish and consume them. EventCounters are supported in all OS Platforms, and can be thought of as a cross-platform equivalent for the [PerformanceCounters](https://docs.microsoft.com/dotnet/api/system.diagnostics.performancecounter) which is only supported in Windows systems.
+`EventCounter` is .NET/.NET Core mechanism to publish and consume counters or statistics. [This](https://github.com/dotnet/corefx/blob/master/src/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md) document gives an overview of `EventCounters` and examples on how to publish and consume them. EventCounters are supported in all OS Platforms - Windows, Linux and MacOS. It can be thought of as a cross-platform equivalent for the [PerformanceCounters](https://docs.microsoft.com/dotnet/api/system.diagnostics.performancecounter) that is only supported in Windows systems.
 
-While users can publish any custom `EventCounters` to meet their needs, the .NET Core 3.0 ecosystem publishes a set of these counters out-of-the-box. The document will walk through the steps required to collect and view `EventCounters` (system defined or user defined) in Azure Application Insights.
+While users can publish any custom `EventCounters` to meet their needs, the .NET Core 3.0 runtime publishes a set of these counters by default. The document will walk through the steps required to collect and view `EventCounters` (system defined or user defined) in Azure Application Insights.
 
-# Using Application Insights to collect EventCounters
+## Using Application Insights to collect EventCounters
 
-Application Insights supports collecting `EventCounters` with its `EventCounterCollectionModule`, which is part of the newly released nuget package [Microsoft.ApplicationInsights.EventCounterCollector](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventCounterCollector). `EventCounterCollectionModule` is automatically enabled when using either [AspNetCore](asp-net-core.md) or [WorkerService](worker-service.md) instructions. `EventCounterCollectionModule` collects counters with a non-configurable collection frequency of 60 seconds.
+Application Insights supports collecting `EventCounters` with its `EventCounterCollectionModule`, which is part of the newly released nuget package [Microsoft.ApplicationInsights.EventCounterCollector](https://www.nuget.org/packages/Microsoft.ApplicationInsights.EventCounterCollector). `EventCounterCollectionModule` is automatically enabled when using either [AspNetCore](asp-net-core.md) or [WorkerService](worker-service.md) instructions. `EventCounterCollectionModule` collects counters with a non-configurable collection frequency of 60 seconds. There are no special permissions required to collect EventCounters.
 
 ## Default counters collected
 
-For apps running in .NET Core 3.0 or higher, the following lists the default set of counters collected automatically by the SDK. These counters can be queried either in Metrics Explorer or using Analytics query. The name of the counters will be of the form "Category|Counter".
+For apps running in .NET Core 3.0, the following set of counters are collected automatically by the SDK. The name of the counters will be of the form "Category|Counter".
 
 |Category | Counter|
 |---------------|-------|
@@ -57,32 +57,31 @@ Note: Counters of category Microsoft.AspNetCore.Hosting are only added in Asp.Ne
 
 ## Customizing counters to be collected
 
-The following shows how to add/remove counters. This would be done in `ConfigureServices` of your application after application insights telemetry collection is enabled using either `AddApplicationInsightsTelemetry()` or `AddApplicationInsightsWorkerService()`. Following is an example code from an Asp.Net Core application. For other type of applications, refer to [this](worker-service.md#configuring-or-removing-default-telemetrymodules) document.
+The following example shows how to add/remove counters. This customization would be done in `ConfigureServices` of your application after application insights telemetry collection is enabled using either `AddApplicationInsightsTelemetry()` or `AddApplicationInsightsWorkerService()`. Following is an example code from an Asp.Net Core application. For other type of applications, refer to [this](worker-service.md#configuring-or-removing-default-telemetrymodules) document.
 
 ```csharp
     using Microsoft.ApplicationInsights.Extensibility.EventCounterCollector;
 
     public void ConfigureServices(IServiceCollection services)
     {
-
         //... other code...
 
-        // The following shows several customizations done to EventCounterCollectionModule.
+        // The following code shows several customizations done to EventCounterCollectionModule.
         services.ConfigureTelemetryModule<EventCounterCollectionModule>(
-                    (module, o) =>
-                    {
-                        // The following removes all default counters.
-                        module.Counters.Clear();
+            (module, o) =>
+            {
+                // This removes all default counters.
+                module.Counters.Clear();
 
-                        // The following adds a user defined counter "MyCounter" from EventSource named "MyEventSource"
-                        module.Counters.Add(new EventCounterCollectionRequest("MyEventSource", "MyCounter"));
+                // This adds a user defined counter "MyCounter" from EventSource named "MyEventSource"
+                module.Counters.Add(new EventCounterCollectionRequest("MyEventSource", "MyCounter"));
 
-                        // The following adds the system counter "gen-0-size" from "System.Runtime"
-                        module.Counters.Add(new EventCounterCollectionRequest("System.Runtime", "gen-0-size"));
-                    }
-                );
+                // This adds the system counter "gen-0-size" from "System.Runtime"
+                module.Counters.Add(new EventCounterCollectionRequest("System.Runtime", "gen-0-size"));
+            }
+        );
 
-        // The following removes EventCounterCollectionModule to disable the module completely.
+        // The following code removes EventCounterCollectionModule to disable the module completely.
         var eventCounterModule = services.FirstOrDefault<ServiceDescriptor>
                     (t => t.ImplementationType == typeof(EventCounterCollectionModule));
         if (eventCounterModule != null)
@@ -94,7 +93,7 @@ The following shows how to add/remove counters. This would be done in `Configure
 
 ## Event counters in Metric Explorer
 
-To view EventCounter metrics in [Metric Explorer](https://docs.microsoft.com/azure/azure-monitor/platform/metrics-charts), select Application Insights resource, and chose Log-based metrics as metric namespace. Then EventCounter metrics gets displayed under PerformanceCounter category.
+To view EventCounter metrics in [Metric Explorer](https://docs.microsoft.com/azure/azure-monitor/platform/metrics-charts), select Application Insights resource, and chose Log-based metrics as metric namespace. Then EventCounter metrics get displayed under PerformanceCounter category.
 
 ![Event counters reported in Application Insights](./media/event-counters/meticsexplorer-counterlist.png)
 
@@ -105,12 +104,12 @@ You can also search and display event counter reports in [Analytics](../../azure
 For example, run the following query to see what counters are collected and available to query:
 
 ```Kusto
-performanceCounters | summarize count(), avg(value) by name
+performanceCounters | summarize avg(value) by name
 ```
 
 ![Event counters reported in Application Insights](./media/event-counters/analytics-event-counters.png)
 
-To get a chart of a specific counter (eg:) over the recent period:
+To get a chart of a specific counter (for example: `ThreadPool Completed Work Item Count`) over the recent period, run the following query.
 
 ```Kusto
 performanceCounters 
@@ -122,7 +121,7 @@ performanceCounters
 
 ![Chat of a single counter in Application Insights](./media/event-counters/analytics-completeditems-counters.png)
 
-Like other telemetry, **performanceCounters** also has a column `cloud_RoleInstance` that indicates the identity of the host server instance on which your app is running. The above query shows the counter value per instance, and hence can be used to compare performance of different server instances.
+Like other telemetry, **performanceCounters** also has a column `cloud_RoleInstance` that indicates the identity of the host server instance on which your app is running. The above query shows the counter value per instance, and can be used to compare performance of different server instances.
 
 ## Alerts
 Like other metrics, you can [set an alert](../../azure-monitor/app/alerts.md) to warn you if an event counter goes outside a limit you specify. Open the Alerts pane and click Add Alert.

articles/azure-monitor/app/media/event-counters/analytics-event-counters.png

@@ -531,7 +531,7 @@ Use this sample if you are using a Console Application written in either .NET Co
 Use this sample if you are in Asp.Net Core 2.1/2.2, and creating background tasks as per official guidance [here](https://docs.microsoft.com/aspnet/core/fundamentals/host/hosted-services?view=aspnetcore-2.2)
 
 [.NET Core 3.0 Worker Service](https://github.com/microsoft/ApplicationInsights-Home/tree/master/Samples/WorkerServiceSDK/WorkerServiceSampleWithApplicationInsights)
-Use this sample     if you have a .NET Core 3.0 Worker Service application as per official guidance [here](https://docs.microsoft.com/aspnet/core/fundamentals/host/hosted-services?view=aspnetcore-3.0&tabs=visual-studio#worker-service-template)
+Use this sample if you have a .NET Core 3.0 Worker Service application as per official guidance [here](https://docs.microsoft.com/aspnet/core/fundamentals/host/hosted-services?view=aspnetcore-3.0&tabs=visual-studio#worker-service-template)
 
 ## Open-source SDK