As you mention Enterprise Library supports async logging. To log asynchronously is just a matter of setting the XML configuration to be async (or wrapping a trace listener in an AsynchronousTraceListenerWrapper if using programmatic configuration). Here is the relevant section of the Developers Guide: http://msdn.microsoft.com/en-us/library/dn440731(v=pandp.60).aspx#sec23.
If you download the reference documents there is some additional information:
Another scenario in which messages could be lost is if the buffer is full. Async logging is handled by a long running task and does not spawn a thread for each message so monitoring the thread pool is not useful.
However, if you configure the errors special source you should be able to capture that event along with the original information. The errors special source could use an email trace listener to send emails to support team (for all logging errors) Here is a (sanitized) example of what you would see:
Also If you are starting from scratch you may want to look at the Semantic Logging Application Block.
~~
Randy Levy
entlib.support@live.com
Enterprise Library support engineer
Support How-to
If you download the reference documents there is some additional information:
You can use the asynchronous trace listener in the same way that you would use the wrapped listener in your code.In terms of losing messages during application shutdown you can configure the disposeTimeout and ensure in your application that LogWriters are disposed during an orderly shutdown. However, there is no deterministic guarantee that all messages in the buffer will be written (e.g. power failure, crash, etc.).
The AsynchronousTraceListenerWrapper constructor has three optional parameters in addition to the wrapped listener.
ownsWrappedListener. Indicates whether the wrapper should dispose the wrapped trace listener.
bufferSize. Size of the buffer for asynchronous requests.
maxDegreeOfParallelism. The maximum degree of parallelism for thread safe listeners.
disposeTimeout. The timeout for waiting to complete buffered requests when disposing. When null (the default) the timeout is infinite.
If the buffer overflows, you may lose some messages.
Another scenario in which messages could be lost is if the buffer is full. Async logging is handled by a long running task and does not spawn a thread for each message so monitoring the thread pool is not useful.
However, if you configure the errors special source you should be able to capture that event along with the original information. The errors special source could use an email trace listener to send emails to support team (for all logging errors) Here is a (sanitized) example of what you would see:
----------------------------------------
Logging Errors & Warnings Error: 6352 : Timestamp: 12/2/2014 1:23:03 PM
Message: Tracing to LogSource 'General' failed. Processing for other sources will continue. See summary information below for more information. Should this problem persist, stop the service and check the configuration file(s) for possible error(s) in the configuration of the categories and sinks.
Summary for Enterprise Library Distributor Service:
======================================
-->
Message:
Timestamp: 12/2/2014 1:23:03 PM
Message: Test
Category: General
Priority: -1
EventId: 1
Severity: Information
Title:
ProcessId: 7420
Thread Name:
Win32 ThreadId:6780
Extended Properties:
--> TimeStamp: 12/2/2014 1:23:03 PM
--> FullName: Microsoft.Practices.EnterpriseLibrary.Logging, Version=6.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
Exception Information Details:
======================================
Exception Type: System.InvalidOperationException
Message: The capacity for the asynchronous trace listener named '' is exhausted.
Data: System.Collections.ListDictionaryInternal
TargetSite: Void AddRequest(System.Action`1[System.Diagnostics.TraceListener])
HelpLink: NULL
Source: Microsoft.Practices.EnterpriseLibrary.Logging
HResult: -2146233079
StackTrace Information Details:
======================================
at Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.AsynchronousTraceListenerWrapper.AddRequest(Action`1 request)
at Microsoft.Practices.EnterpriseLibrary.Logging.TraceListeners.AsynchronousTraceListenerWrapper.TraceData(TraceEventCache eventCache, String source, TraceEventType eventType, Int32 id, Object data, ReportTracingError reportError)
at Microsoft.Practices.EnterpriseLibrary.Logging.LogSource.TraceData(TraceEventType eventType, Int32 id, LogEntry logEntry, TraceListenerFilter traceListenerFilter, TraceEventCache traceEventCache, ReportTracingError reportError)
Category:
Priority: -1
EventId: 6352
Severity: Error
Title:
ProcessId: 7420
Thread Name:
Win32 ThreadId:6780
Extended Properties:
----------------------------------------Also If you are starting from scratch you may want to look at the Semantic Logging Application Block.
~~
Randy Levy
entlib.support@live.com
Enterprise Library support engineer
Support How-to