Release 1.0 - ...

<listeners> element

Configures the listener(s), which will be available for log messages routing (as configured within specialSources and/or categorySources).

The following trace listeners are provided by Smartsite.Diagnostics.Logging:

EventLog Trace Listener
Event Trace Listener
XmlFile Trace Listener
Flat File Trace Listener
Database Trace Listener
Email Trace Listener

Listeners which are not in use and/or you're not intended to be using in the future can savely be removed from or commented within the listeners element.

Example

XML	Copy Code
<listeners> <!-- EventLog TraceListener --> <add name="EventLog Trace Listener" type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.EventLogTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" source="Smartsite.Diagnostics.Logging" formatter="Common Formatter" log="Application" machineName="" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.EventLogTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" traceOutputOptions="None" /> <!-- Event TraceListener --> <add name="Event Trace Listener" type="Smartsite.Diagnostics.Logging.EventTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" traceOutputOptions="None" /> <!-- XML File TraceListener --> <add name="XmlFile Trace Listener" type="Smartsite.Diagnostics.Logging.XmlFileTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" fileName="..\LogFiles\Cms\Log.xml" roleOverType="Hour" threshold="1" filesToKeep="10" /> <!-- Database TraceListener--> <add name="Database Trace Listener" type="Smartsite.Diagnostics.Logging.DBTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" dbConnection="manager" dbLogEntriesTable="LogEntries" /> <!-- Email Trace Listener --> <add name="Email Trace Listener" type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.EmailTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.EmailTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" formatter="Common Formatter" toAddress="recipient@companyname.com" fromAddress="noreply@companyname.com" subjectLineStarter="" subjectLineEnder="" smtpServer="smtp.companyname.com" /> <!-- Flat File trace listener --> <add name="FlatFile Trace Listener" type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.FlatFileTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.FlatFileTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" fileName="..\LogFiles\Cms\Error.log" header="========================================" footer="========================================" formatter="Common Formatter" traceOutputOptions="None" /> </listeners>

XML

Copy Code

<listeners>
   <!-- EventLog TraceListener -->
   <add name="EventLog Trace Listener" 
           type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.EventLogTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           source="Smartsite.Diagnostics.Logging" 
           formatter="Common Formatter" 
           log="Application" machineName="" 
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.EventLogTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           traceOutputOptions="None" />
   <!-- Event TraceListener -->
   <add name="Event Trace Listener" 
           type="Smartsite.Diagnostics.Logging.EventTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           traceOutputOptions="None" />
   <!-- XML File TraceListener -->
   <add name="XmlFile Trace Listener" 
           type="Smartsite.Diagnostics.Logging.XmlFileTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6"
           fileName="..\LogFiles\Cms\Log.xml" 
           roleOverType="Hour" threshold="1" filesToKeep="10" />
   <!-- Database TraceListener-->
   <add name="Database Trace Listener" 
           type="Smartsite.Diagnostics.Logging.DBTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.CustomTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6"
           dbConnection="manager" dbLogEntriesTable="LogEntries" />
   <!-- Email Trace Listener -->
   <add name="Email Trace Listener" 
           type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.EmailTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6" 
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.EmailTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6"
           formatter="Common Formatter" 
           toAddress="recipient@companyname.com" fromAddress="noreply@companyname.com" 
           subjectLineStarter="" subjectLineEnder="" 
           smtpServer="smtp.companyname.com" />
   <!-- Flat File trace listener -->
   <add name="FlatFile Trace Listener"
           type="Smartsite.Diagnostics.LoggingBase.Logging.TraceListeners.FlatFileTraceListener, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6"
           listenerDataType="Smartsite.Diagnostics.LoggingBase.Logging.Configuration.FlatFileTraceListenerData, Smartsite.Diagnostics.Logging, Version=1.0.0.0, Culture=neutral, PublicKeyToken=5fdb12a67e027fb6"
          fileName="..\LogFiles\Cms\Error.log"
           header="========================================"
           footer="========================================"
           formatter="Common Formatter"        
           traceOutputOptions="None" />
</listeners>

Attributes

Parent element

Element name	Description
<loggingConfiguration>	Configures the listeners, formatter(s) and specialSources.

Child elements

Element name	Description
<add>	Adds a trace listener to the collection. Adds a trace listener to the collection.

Install & Config