Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Introduce EventCounters overview article and tutorial doc #19635

Merged
merged 28 commits into from
Aug 7, 2020
Merged
Show file tree
Hide file tree
Changes from 25 commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
12e6b37
Initial bits of the EventCounter articles
IEvangelist Jul 22, 2020
b9895aa
Added event counter articles to TOC
IEvangelist Jul 22, 2020
b5aa379
Low hanging fruit from acrolinx
IEvangelist Jul 22, 2020
2618fee
Sweeping edit pass on overview, cleared about 40 issues
IEvangelist Jul 22, 2020
634a9ec
Pre-commit hook, applied automatic markdownlint CLI fixes
IEvangelist Jul 22, 2020
40d7a48
More updates
IEvangelist Jul 22, 2020
8d3d576
Compressed images, and minor tweaks
IEvangelist Jul 22, 2020
3f048af
Add next steps
IEvangelist Jul 23, 2020
9bdc324
Introduced code files under snippets, minor updates from review
IEvangelist Jul 31, 2020
3e56a0f
Apply suggestions from code review
IEvangelist Jul 27, 2020
46b87fb
Oops, updates from merge
IEvangelist Jul 31, 2020
250cbc4
Apply suggestions from code review
IEvangelist Jul 31, 2020
5ea2375
Minor updates, and added SVG
IEvangelist Jul 31, 2020
a261bbe
More working updates
IEvangelist Jul 31, 2020
1d60d51
fixed SVG image, added background color for dark theme
IEvangelist Jul 31, 2020
38bbfdf
More updates... still working to address all the feedback
IEvangelist Jul 31, 2020
f30fea0
Again updates, and new additions
IEvangelist Jul 31, 2020
4846be2
More tweaks
IEvangelist Jul 31, 2020
324e95c
Incremental updates
IEvangelist Aug 4, 2020
892f886
Fixed range
IEvangelist Aug 4, 2020
8b46613
Updates on the overview article
IEvangelist Aug 5, 2020
d8f791d
More updates, getting closer to finalizing the tutorial
IEvangelist Aug 5, 2020
5d75aee
removed bad merge
IEvangelist Aug 6, 2020
60c255e
Forcefully update ever-changing TOC from master
IEvangelist Aug 6, 2020
c514623
Make actions more conceptual for the overview
IEvangelist Aug 6, 2020
d0a9253
Apply suggestions from code review
IEvangelist Aug 7, 2020
42cb5a0
Updates
IEvangelist Aug 7, 2020
0d1ebda
Pre-commit hook, applied automatic markdownlint CLI fixes
IEvangelist Aug 7, 2020
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 34 additions & 13 deletions docs/core/diagnostics/dotnet-counters.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,11 +38,11 @@ dotnet-counters [-h|--help] [--version] <command>
## Commands

| Command |
| --------------------------------------------------- |
|-----------------------------------------------------|
| [dotnet-counters collect](#dotnet-counters-collect) |
| [dotnet-counters list](#dotnet-counters-list) |
| [dotnet-counters monitor](#dotnet-counters-monitor) |
| [dotnet-counters ps](#dotnet-counters-ps) |
| [dotnet-counters ps](#dotnet-counters-ps) |

## dotnet-counters collect

Expand Down Expand Up @@ -101,18 +101,39 @@ dotnet-counters list [-h|--help]

```console
> dotnet-counters list

Showing well-known counters only. Specific processes may support additional counters.
System.Runtime
cpu-usage Amount of time the process has utilized the CPU (ms)
working-set Amount of working set used by the process (MB)
gc-heap-size Total heap size reported by the GC (MB)
gen-0-gc-count Number of Gen 0 GCs / sec
gen-1-gc-count Number of Gen 1 GCs / sec
gen-2-gc-count Number of Gen 2 GCs / sec
exception-count Number of Exceptions / sec
Showing well-known counters only. Specific processes may support additional counters.

System.Runtime
cpu-usage Amount of time the process has utilized the CPU (ms)
working-set Amount of working set used by the process (MB)
gc-heap-size Total heap size reported by the GC (MB)
gen-0-gc-count Number of Gen 0 GCs / min
gen-1-gc-count Number of Gen 1 GCs / min
gen-2-gc-count Number of Gen 2 GCs / min
time-in-gc % time in GC since the last GC
gen-0-size Gen 0 Heap Size
gen-1-size Gen 1 Heap Size
gen-2-size Gen 2 Heap Size
loh-size LOH Heap Size
alloc-rate Allocation Rate
assembly-count Number of Assemblies Loaded
exception-count Number of Exceptions / sec
threadpool-thread-count Number of ThreadPool Threads
monitor-lock-contention-count Monitor Lock Contention Count
threadpool-queue-length ThreadPool Work Items Queue Length
threadpool-completed-items-count ThreadPool Completed Work Items Count
active-timer-count Active Timers Count

Microsoft.AspNetCore.Hosting
requests-per-second Request rate
total-requests Total number of requests
current-requests Current number of requests
failed-requests Failed number of requests
```

> [!NOTE]
> The `Microsoft.AspNetCore.Hosting` counters are displayed when there are processes identified that support these counters, for example; when an ASP.NET Core application is running on the host machine.

## dotnet-counters monitor

Displays periodically refreshing values of selected counters.
Expand Down Expand Up @@ -166,7 +187,7 @@ dotnet-counters monitor [-h|--help] [-p|--process-id] [--refreshInterval] [count
GC Heap Size (MB) 811
```

- Monitor `EventCounter` values from user-defined `EventSource`. For more information, see [Tutorial: How to measure performance for very frequent events using EventCounters](https://github.com/dotnet/runtime/blob/master/src/libraries/System.Diagnostics.Tracing/documentation/EventCounterTutorial.md).
- Monitor `EventCounter` values from user-defined `EventSource`. For more information, see [Tutorial: Measure performance using EventCounters in .NET Core](event-counter-perf.md).

```console
> dotnet-counters monitor --process-id 1902 Samples-EventCounterDemos-Minimal
Expand Down
Loading