Skip to content

Latest commit

 

History

History
124 lines (91 loc) · 7.49 KB

ReadMe.md

File metadata and controls

124 lines (91 loc) · 7.49 KB

Home | Examples | Guidance | FAQ | Listeners | Fluent | Core

Documentation

The following trace listeners are provided by the Essential.Diagnostics extensions.

Essential.Diagnostics namespace

Class Description
BufferedEmailTraceListener Writes trace events to an Email message sent at the end of the host process.
ColoredConsoleTraceListener Writes formatted trace events to the console in color based on the type.
EmailTraceListener Writes trace events to Email messages sent asynchronously.
InMemoryTraceListener Writes traces to an in-memory array.
RollingFileTraceListener Trace listener that writes formatted messages to a text file, rolling to a new file based on a filename template (usually including the date).
RollingXmlTraceListener Trace listener that writes E2ETraceEvent XML fragments to a text file, rolling to a new file based on a filename template (usually including the date).
SeqTraceListener Writes trace information to a Seq logging server.
SqlDatabaseTraceListener Writes trace information to a SQL database.

Contains the scope utility classes, abstractions, and templated classes for easy use with dependency injection. This package makes using System.Diagnotics trace sources easier, and can be used either separately (with system trace listeners), or in conjunction with the extended trace listeners above.

Essential.Diagnostics namespace

Class Description
ActivityScope Sets the correlation ActivityId for the life of the scope object, performs a transfer, and logs activity messages.
LogicalOperationScope Sets the correlation LogicalOperation stack for the life of the scope object.

Essential.Diagnostics.Abstractions namespace

Class Description
AssemblyTraceLog<TEventId, TTarget> Implementation of the fluent log interface that is bound to a specific EventId type and with a source named after the target class assembly.
AssemblyTraceSource<TTarget> Enable applications to trace the execution of code and associate trace messages with a source named after the assembly the generic type is from.
GenericEventId General event IDs.
GenericTraceLog Implementation of TraceLog<TEventId> bound to GenericEventId.
ITraceLog<TEventId> Fluent log interface, with strongly typed event IDs.
ITraceSource Defines a set of methods and properties that enable applications to trace the execution of code and associate trace messages with their source.
ITraceSource<TTarget> Defines a set of methods and properties that enable applications to trace the execution of code and associate trace messages with a source related to a specific class.
TraceLog<TEventId> Generic implementation of the fluent log interface.
TraceSourceWrapper Provides a wrapper around TraceSource that implements the ITraceSource interface, enable applications to trace the execution of code and associate trace messages with their source in a decoupled manner.

Core library with base classes, referenced by other packages.

Essential.Diagnostics namespace

Class Description
ExpressionFilter Filter events based on an expression.
TraceConfigurationMonitor Monitors the config file for changes are refreshes trace listeners when required.
TraceFormatter Inserts trace information into a provided template string. Used to provide the advanced formatting for several listeners.
TraceListenerBase Extended trace listener designed to be subclassed with as little as a single template method override.

.NET Framework classes

From the Microsoft .NET Framework.

System.Diagnostics namespace

Class Description
EventTypeFilter Filters based on the level of the TraceEventType, e.g. Warning, Error, etc.
TraceFilter Base trace filter class provided by the .NET framework.
TraceListener Base trace listener class provided by the .NET framework.

System Trace Listeners

Class Description
ConsoleTraceListener Writes trace events to the console
DefaultTraceListener
DelimitedListTraceListener Writes trace events to a file as a delimited list.
DiagnosticMonitorTraceListener Part of Microsoft.WindowsAzure.Diagnostics; writes traces to Azure logs
EventLogTraceListener Writes trace events to the Windows Event Log
EventProviderTraceListener
EventSchemaTraceListener
TextWriterTraceListener Writes trace events to a simple file. Recommended you at least use FileLogTraceListener instead.
WebPageTraceListener Forwards trace events to the ASP.NET trace output.
WMITraceListener^^1^^
XmlWriterTraceListener Writes events in XML format, suitable for import into the Service Trace Viewer utility.

Microsoft.VisualBasic.Logging namespace

Class Description
FileLogTraceListener Writes trace events to a file with advanced options for file rotation and output format.

Enterprise Library Logging Application Block

Class Description
FlatFileTraceListener
FormattedEventLogTraceListener

Note: These trace listeners from the Enterprise Library Logging Application Block can also be used directly with System.Diagnostics (for details see http://msdn.microsoft.com/en-us/library/ff664735%28v=PandP.50%29.aspx).

Guidance on considerations when implementing logging and other instrumentation for your project:

Guidance related to the Essential.Diagnostics project: