Basic Understanding Of NLog

I will also describe how and where to use Nlog. I hope this article will really help those who have never used Nlog. Let’s start digging into this.

What is Nlog?

Nlog is an open source log platform. Through this platform, we can log an activity of an application. This makes an application's code easy to handle. Nlog provides a cross platform support.

Things we can log

By using Nlog in an Application, we can log the things given below.

• Trace - Detailed Log
• Debug - Debugging Information
• Info - Info Message
• Warning - Warning Messages
• Error - Error Messages
• Fatal - Big Errors, which needs attention

Basic Targets

• Files- We can log our messages into a file.
• Database can also work with SQL Server, using Nlog.
• Console displays messages in a C# Console Application.
• Email- We can email log message.

Today, we will create a console Application and will use Nlog for the things given below.

• To display log messages in a console application.
• Log messages in a file at a specified location.
• Also, we will email a logged message.

Let's start.

Step 1

Create a C# console Application and name it NlogDemoApplication.

Step 2

Install Nlog package in the Application. You can use NuGet Package Manager for this. Use the command given below.

Install-Package NLog.Config

Two files will be added, as shown below.

1. Config
2. xsd

Step 3

Open Program.cs file and create a private static Logger per class. We also need to use LogManager to create Logger instances. Do not forget to add namespace as well.

private static Logger logger = LogManager.GetCurrentClassLogger(); 

Step 4

Replace the main function with the code given below. In this method, we just call Nlog error function to log a static error message.

static void Main(string[] args)  
{  
    logger.Error("This is an error message");  
    Console.Read();  
}

Step 5

Now, open Nlog.Confile and replace code given below as well.

<targets>  
    <target name="console" xsi:type="Console" layout="${longdate}|${message}"/>  
</targets>  
  
<rules>  
    <logger name="*" minlevel="Error" writeTo="console" />  
</rules> 

Under targets tag, we add keys as targets; i.e. where we want the results and under rules tag and we add key (rules), when we write our log. In the meantime, we are going to target a console Application and we are going to write a log whenever an error will occur.

Note

• xsitype Type of target for log
• Layout Output
• Name name of the target

Step 6

Run the Console Application and you will see the output given below. This is how we display a log message to a console output Window

Step 7

Now, we going to target a file to log an error message. Again, open Nlog.Config file and add line given below under targets tag.

<target name="file" xsitype="File" fileName="D\logs\NLog.log" layout="${longdate}|${message}"/> 

<targets>  
    <target name="console" xsitype="Console" layout="${longdate}|${message}"/>  
    <target name="file" xsitype="File" fileName="D\logs\NLog.log" layout="${longdate}|${message}"/>
</targets>
  
<rules>  
    <logger name="*" minlevel="Error" writeTo="console,file" />  
</rules> 

<target name="sendMail" xsitype="Mail"  
    subject="Application Error Log"  
    to="XXXXXXXXXXXXXXXXXXXXXXXXXXX"  
    from="XXXXXXXXXXXXXXXXXXXXXXXXX"  
    body="${longdate}|${message}"  
    enableSsl="true"  
    smtpAuthentication="Basic"  
    smtpServer="smtp.gmail.com"  
    smtpUserName="XXXXXXXXXXXXXXXXXXXX"  
    smtpPassword="XXXXXXXXXXXXXXXXXXXX"  
    smtpPort="587"/>  
</targets> 

<logger name="*" minlevel="Error" writeTo="console,file,sendMail" />