This section is intended to be a short introduction on how to setup common logging in your application. For a full reference and guides please refer to the Common.Logging documentation in the SphinxConnector.NET installation directory.

Logging can be configured either in an app.config file or programmatically. In this example we'll use the app.config file to setup logging with NLog. First we need to add the config sections for NLog and Common.Logging to the config file:

<configSections>
  <section name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>
  <sectionGroup name="common">
    <section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" />
  </sectionGroup>
</configSections>

We then add the configuration for the Common.Logging library:

<common>
  <logging>
    <factoryAdapter type="Common.Logging.NLog.NLogLoggerFactoryAdapter, Common.Logging.NLog">
      <arg key="configType" value="INLINE" />
    </factoryAdapter>
  </logging>
</common>

This tells Common.Logging that it should use NLog to output the log messages and that the NLog configuration is placed in the same config file (option configType). Finally we add the NLog config section:

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" autoReload="true" throwExceptions="false">
    <targets>
      <target name="console" xsi:type="Console" layout="${longdate} ${level:uppercase=true} ${callsite} ${message} ${exception:format=tostring}"/>
    </targets>
    <rules>
      <logger name="*" minlevel="Trace" writeTo="console"> </logger>
    </rules>
</nlog>

The NLog configuration is straightforward: We setup a console target and a catch-all logger with a mininum log level of Trace.

Note
In a production environment the log level generally should not be set lower than Info except for debugging puposes, because Trace is very verbose and may slow down your application.