Merchants.Common.Logging 1.0.0

Merchants Common Logging library

Introduction

Provides a simple logging abstraction to switch between different logging implementations. There is current support for NLog and Microsoft Application Insights.In furture will enhnace this libraray to add more support.

Additionally Common.Logging comes with a set of base classes making the integration of any log system a breeze.

NLog Quickstart

This demonstrates how to configure your app to log using the built in Merchants.Common.Logging.

1) Install Merchants.Common.Logging via NuGet

Either open the Package Management Console and enter the following or use the built-in GUI

NuGet: PM> Install-Package Merchants.Common.Logging

add "nlog.config" file to your project directory. sample nlog.config

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true"
      internalLogLevel="Info"
      internalLogFile="c:\temp\internal-nlog.txt">

  
  <extensions>
    <add assembly="NLog.Web.AspNetCore"/>
  </extensions>

  
  <targets>
    
    <target xsi:type="File" name="allfile" fileName="${basedir}/Logs/debug-log-${shortdate}.log"
            layout="${longdate}|${event-properties:item=EventId_Id}|${uppercase:${level}}|${logger}|${message} ${exception:format=tostring}" />

    
    
  </targets>

  
  <rules>
    
    <logger name="*" minlevel="Trace" writeTo="allfile" />

    
    <logger name="Microsoft.*" maxlevel="Info" final="true" />
    
    
  </rules>
</nlog>

Application Insights Quickstart

PM> Install-Package Merchants.Common.Logging

The app config should then have an Application Insights section like below. Be sure to set the InstrumentationKey with your InstrumentationKey retrieved from Application Insights portal https://portal.azure.com.

{
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  },
  "ApplicationInsights": {
    "InstrumentationKey": ""
  }
  
}

Solution Layout

Building

• Clone the GitHub repository
• Install Silverlight SDK 5
• [Optional] Install Java for the documentation builder