{"id":1896,"date":"2023-06-15T09:14:51","date_gmt":"2023-06-15T09:14:51","guid":{"rendered":"http:\/\/waqar-arshad.com\/?p=1896"},"modified":"2023-06-15T09:14:51","modified_gmt":"2023-06-15T09:14:51","slug":"nlog-logging-fundamental","status":"publish","type":"post","link":"http:\/\/waqar-arshad.com\/index.php\/2023\/06\/15\/nlog-logging-fundamental\/","title":{"rendered":"NLog – Logging Fundamental"},"content":{"rendered":"
\r\n
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div>
\r\n \r\n <\/i>\r\n <\/a>\r\n <\/span>\r\n<\/div><\/div>\n

What is Nlog ?<\/strong><\/p>\n\n\n\n

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.<\/p>\n\n\n\n

Things we can log<\/strong><\/p>\n\n\n\n

By using Nlog in an Application, we can log the things given below.<\/p>\n\n\n\n

    \n
  • Trace – Detailed Log<\/li>\n\n\n\n
  • Debug – Debugging Information<\/li>\n\n\n\n
  • Info – Info Message<\/li>\n\n\n\n
  • Warning – Warning Messages<\/li>\n\n\n\n
  • Error – Error Messages<\/li>\n\n\n\n
  • Fatal – Big Errors, which needs attention<\/li>\n<\/ul>\n\n\n\n

    Basic Targets<\/strong><\/p>\n\n\n\n

      \n
    • Files- <\/em>We can log our messages into a file.<\/li>\n\n\n\n
    • Database<\/em> can also work with SQL Server, using Nlog.<\/li>\n\n\n\n
    • Console <\/em>displays messages in a C# Console Application.<\/li>\n\n\n\n
    • Email- <\/em>We can email log message.<\/li>\n<\/ul>\n\n\n\n

      Today, we will create a console Application and will use Nlog for the things given below.<\/p>\n\n\n\n

        \n
      • To display log messages in a console application.<\/li>\n\n\n\n
      • Log messages in a file at a specified location.<\/li>\n\n\n\n
      • Also, we will email a logged message.<\/li>\n<\/ul>\n\n\n\n

        Let’s start.<\/p>\n\n\n\n

        Step 1<\/strong>

        Create a C# console Application and name it NlogDemoApplication.

        <\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        Step 2<\/strong>

        Install Nlog package in the Application. You can use NuGet Package Manager for this. Use the command given below.<\/p>\n\n\n\n

        Install-Package NLog.Config<\/em><\/p>\n\n\n\n

        \"\"<\/figure>\n\n\n\n

        Two files will be added, as shown below.<\/p>\n\n\n\n

          \n
        1. Config<\/li>\n\n\n\n
        2. xsd<\/li>\n<\/ol>\n\n\n\n
          \"\"<\/figure>\n\n\n\n

          Step 3<\/strong>

          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.<\/p>\n\n\n\n

            \n
          1. private<\/strong> static<\/strong> Logger logger = LogManager.GetCurrentClassLogger();  <\/li>\n<\/ol>\n\n\n\n
            \"\"<\/figure>\n\n\n\n

            Step 4<\/strong>

            Replace the main function with the code given below. In this method, we just call Nlog error function to log a static error message.<\/p>\n\n\n\n

              \n
            1. static<\/strong> void<\/strong> Main(string[] args)  <\/li>\n\n\n\n
            2.             {  <\/li>\n\n\n\n
            3.                     logger.Error(“This is an error message”);  <\/li>\n\n\n\n
            4.                     Console.Read();  <\/li>\n\n\n\n
            5.             }   <\/li>\n<\/ol>\n\n\n\n

              Step 5<\/strong>

              Now, open Nlog.Confile and replace code given below as well.<\/p>\n\n\n\n

                \n
              1. <targets>  <\/li>\n\n\n\n
              2.     <target name=”console” xsi:type=”Console” layout=”${longdate}|${message}”\/>  <\/li>\n\n\n\n
              3. <\/targets>  <\/li>\n\n\n\n
              4.   <\/li>\n\n\n\n
              5. <rules>  <\/li>\n\n\n\n
              6.     <logger name=”*” minlevel=”Error” writeTo=”console” \/>  <\/li>\n\n\n\n
              7. <\/rules>  <\/li>\n<\/ol>\n\n\n\n

                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.<\/p>\n\n\n\n

                Note<\/u><\/strong><\/p>\n\n\n\n

                  \n
                • xsitype <\/em>Type of target for log<\/li>\n\n\n\n
                • Layout <\/em>Output<\/li>\n\n\n\n
                • Name <\/em>name of the target<\/li>\n<\/ul>\n\n\n\n

                  Step 6<\/strong>

                  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<\/p>\n\n\n\n

                  \"\"<\/figure>\n\n\n\n

                  Step 7<\/strong>

                  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.<\/p>\n\n\n\n

                    \n
                  1. <target name=”file” xsitype=”File” fileName=”D\\logs\\NLog.log” layout=”${longdate}|${message}”\/>   <\/li>\n<\/ol>\n\n\n\n

                    In the existing rule, add the file (name of the target) with the console. Now, your code will look like, as shown below.<\/p>\n\n\n\n

                      \n
                    1. <targets>  <\/li>\n\n\n\n
                    2.     <target name=”console” xsitype=”Console” layout=”${longdate}|${message}”\/>  <\/li>\n\n\n\n
                    3.      <target name=”file” xsitype=”File” fileName=”D\\logs\\NLog.log” layout=”${longdate}|${message}”\/>  <\/li>\n\n\n\n
                    4. <\/targets>  <\/li>\n\n\n\n
                    5.   <\/li>\n\n\n\n
                    6.   <rules>  <\/li>\n\n\n\n
                    7.     <logger name=”*” minlevel=”Error” writeTo=”console,file” \/>  <\/li>\n\n\n\n
                    8.   <\/rules>  <\/li>\n<\/ol>\n\n\n\n

                      Step 8<\/strong>

                      Run the code. Now, you will see the output in two places, where one is in console Window and the second is in the target file. Check the path specified in the file target. See the image given below for the reference.<\/p>\n\n\n\n

                      \"\"<\/figure>\n\n\n\n

                      Step 9<\/strong>

                      We are going to target an email now. Again, add one more target (as shown below) under targets tag.<\/p>\n\n\n\n

                      Type<\/strong><\/td>Mail<\/strong><\/td><\/tr>
                      Subject<\/td>Could be whatever you want<\/td><\/tr>
                      To<\/td>To whom you will send email<\/td><\/tr>
                      From<\/td>Sending of email<\/td><\/tr>
                      Body<\/td>layout (Message you want to display  in email)<\/td><\/tr>
                      enableSSl<\/td>For secure email<\/td><\/tr>
                      SmtpAuthentication<\/td>(None, Basic, Ntlm)<\/td><\/tr>
                      SmtpUserName<\/td>Username (from email)<\/td><\/tr>
                      SmtpPassword<\/td>Password (From email)<\/td><\/tr>
                      SmtpServer<\/td>Server from which you want to send the email.<\/td><\/tr>
                      Smptport<\/td>As per servers<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

                      We are using basic authentication, so we have to mention smtpusername and password.<\/p>\n\n\n\n

                        \n
                      1. <target name=”sendMail” xsitype=”Mail”  <\/li>\n\n\n\n
                      2.           subject=”Application Error Log”  <\/li>\n\n\n\n
                      3.           to=”XXXXXXXXXXXXXXXXXXXXXXXXXXX”  <\/li>\n\n\n\n
                      4.           from=”XXXXXXXXXXXXXXXXXXXXXXXXX”  <\/li>\n\n\n\n
                      5.           body=”${longdate}|${message}”  <\/li>\n\n\n\n
                      6.           enableSsl=”true”  <\/li>\n\n\n\n
                      7.           smtpAuthentication=”Basic”  <\/li>\n\n\n\n
                      8.           smtpServer=”smtp.gmail.com”  <\/li>\n\n\n\n
                      9.           smtpUserName=”XXXXXXXXXXXXXXXXXXXX”  <\/li>\n\n\n\n
                      10.           smtpPassword=”XXXXXXXXXXXXXXXXXXXX”  <\/li>\n\n\n\n
                      11.           smtpPort=”587″\/>  <\/li>\n\n\n\n
                      12.   <\/targets>   <\/li>\n<\/ol>\n\n\n\n

                        The name of the target, which is sendEmail and the existing rule is shown below.<\/p>\n\n\n\n

                          \n
                        1. <logger name=”*” minlevel=”Error” writeTo=”console,file,sendMail” \/>   <\/li>\n<\/ol>\n\n\n\n

                          Step 10<\/strong><\/p>\n\n\n\n

                          Run the application. In my case, I see the output, as shown below. You can check the result on your specified email address, when you try this code.<\/p>\n\n\n\n

                          \"\"<\/figure>\n\n\n\n


                          Thus, you can check the log messages now at three places

                          <\/p>\n\n\n\n

                            \n
                          • Console<\/li>\n\n\n\n
                          • File<\/li>\n\n\n\n
                          • email<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

                            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. Basic Targets […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[12,13,11],"tags":[],"class_list":["post-1896","post","type-post","status-publish","format-standard","hentry","category-asp-net","category-asp-net-core","category-csharp"],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false},"uagb_author_info":{"display_name":"admin","author_link":"http:\/\/waqar-arshad.com\/index.php\/author\/waqar_29_1\/"},"uagb_comment_info":22,"uagb_excerpt":"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. Basic Targets…","_links":{"self":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1896","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/comments?post=1896"}],"version-history":[{"count":1,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1896\/revisions"}],"predecessor-version":[{"id":1904,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/posts\/1896\/revisions\/1904"}],"wp:attachment":[{"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/media?parent=1896"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/categories?post=1896"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/waqar-arshad.com\/index.php\/wp-json\/wp\/v2\/tags?post=1896"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}