This is an initial set of docs for using EventSource. The goal was to capture most of the beginner + intermediate material from https://github.com/Microsoft/dotnet-samples/blob/master/Microsoft.Diagnostics.Tracing/EventSource/docs/EventSource.md For brevity I dropped some info about lesser used functionality (event localization and ETW channel support) while adding some more info on usage outside the PerfView+ETW ecosystem. I also added information on ActivityIDs which I haven't found documented anywhere. After this PR goes in I'd like to trim the EventSource class api-docs and add a link to this content as the main place to show overall usage. I also want to add a link to this content from the dotnet-samples github page and mark that one as being no longer maintained. This PR is intended to address dotnet/diagnostics#2908 - EventSource start/stop dotnet/diagnostics#2904 - "fast" eventsource dotnet/diagnostics#2902 - custom EventSource with dotnet-trace+vs dotnet/diagnostics#1347 - activity ids It partially covers dotnet/diagnostics#2445 - special case LogAlways behavior but I think we should do more in the API docs before marking that one complete

Writing "fast" EventSource with WriteEventCore API "best practices". #2904

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions