NLog C# (Geliştiriciler İçin Nasıl Çalışır)

NLog yapılandırma dosyası (genellikle nlog.config olarak adlandırılır) oluşturmak için bu adımları izleyebilirsiniz. Bu yapılandırma dosyası, NLog'un uygulamanızda nasıl davranacağını, günlük hedeflerini, düzenleyici düzenlerini ve kuralları içerecek şekilde belirleyecektir.

Projenizde yapılandırma dosyasını oluşturmak istediğiniz proje veya klasöre sağ tıklayın.

1. "Ekle" > "Yeni Öğe..." seçeneğini seçin.
2. "Yeni Çekipuçi Ekle" iletişim kutusunda "XML Dosyası" veya "XML" ara ve seç.

3. Dosyaya nlog.config adını verin ve "Ekle" düğmesine tıklayın.

   

4. Yeni oluşturulan nlog.config dosyasını bir metin editör veya XML editörüyle açın.
5. NLog.XML dosyasına aşağıdaki yapılandırmayı ekleyin. Aşağıda bir Konsol hedefi için mesajları güncelleyerek NLog yapılandırmasının temel bir örneği vardır. Bu Yapılandırma Dosyasını kendi ihtiyaçlarınıza göre özelleştirebilirsiniz:

Yapılandırma dosyası

<?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">

  <targets>

    <target name="console" xsi:type="Console" layout="${longdate}|${message}"/>
  </targets>

  <rules>

    <logger name="*" minlevel="Debug" writeTo="console" />
  </rules>

</nlog>

<?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">

  <targets>

    <target name="console" xsi:type="Console" layout="${longdate}|${message}"/>
  </targets>

  <rules>

    <logger name="*" minlevel="Debug" writeTo="console" />
  </rules>

</nlog>

C# kodunuzda, nlog.config dosyasından NLog yapılandırmasını yüklediğinizden emin olun. Bunu genellikle bir ASP.NET Core Startup.cs ( .NET 5 veya daha eski .NET Sürümü için), program.cs dosyasında ( .NET 6 ya da daha sonraki sürümler için) ya da bir konsol uygulamasının Main yönteminde yaparsınız.

using NLog;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        // Log a debug message
        logger.Debug("This is a Debug Message");

        // Pause the console for viewing output
        Console.Read();
    }
}

using NLog;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        // Log a debug message
        logger.Debug("This is a Debug Message");

        // Pause the console for viewing output
        Console.Read();
    }
}

Imports NLog

Friend Class Program
	' Create an instance of the Logger
	Private Shared logger As Logger = LogManager.GetCurrentClassLogger()

	Shared Sub Main(ByVal args() As String)
		' Log a debug message
		logger.Debug("This is a Debug Message")

		' Pause the console for viewing output
		Console.Read()
	End Sub
End Class

Yukarıdaki programın çıktısı aşağıdaki gibidir:

Bu örnekte, Logger sınıfının bir örneğini oluşturuyor ve Debug Seviyesindeki mesajları güncelleyerek kullanıyoruz. NLog'un desteklediği izleme seviyelerini keşfedelim.

Günlük Seviyeleri

NLog, her birinin kendi önemi olan birkaç günlük seviyeyi destekler:

1. İzleme: Tipik olarak tanı amaçlı en ayrıntılı seviyedir.
2. Hata Ayıklama: Geliştirme sırasında faydalı olabilecek hata ayıklama bilgilerinde kullanılır.
3. Bilgi: Uygulamanın işleyişi hakkında genel bilgileri verir.
4. Uyarı: Uygulamayı kesintiye uğratmayan potansiyel bir sorunu işaret eder.
5. Hata: Uygulamayı çökertmeyen ancak araştırılması gereken bir hatayı işaret eder.
6. Kritik: Hemen ele alınması gereken ciddi bir hatayı işaret eder.

Bu seviyelere göre günlük mesajlarını kategorize ederek, ciddiyetlerine göre onları kolayca filtreleyip önceliklendirebilirsiniz.

Aşağıda gösterildiği gibi nLog.Config dosyanızdaki kurallar etiketine minlevel="Trace" ayarlayın.

<rules>

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

<rules>

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

Tüm izleme seviyeleri için mesajları güncelleyerek kod yazalım.

using NLog;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        // Log messages of different tracking levels
        logger.Trace("This is a Trace Message");
        logger.Debug("This is a Debug Message");
        logger.Info("This is an Info Message");
        logger.Warn("This is a Warning Message");
        logger.Error("This is an Error Message");
        logger.Fatal("This is a Fatal Message");

        // Pause the console for viewing output
        Console.Read();
    }
}

using NLog;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        // Log messages of different tracking levels
        logger.Trace("This is a Trace Message");
        logger.Debug("This is a Debug Message");
        logger.Info("This is an Info Message");
        logger.Warn("This is a Warning Message");
        logger.Error("This is an Error Message");
        logger.Fatal("This is a Fatal Message");

        // Pause the console for viewing output
        Console.Read();
    }
}

Imports NLog

Friend Class Program
	' Create an instance of the Logger
	Private Shared logger As Logger = LogManager.GetCurrentClassLogger()

	Shared Sub Main(ByVal args() As String)
		' Log messages of different tracking levels
		logger.Trace("This is a Trace Message")
		logger.Debug("This is a Debug Message")
		logger.Info("This is an Info Message")
		logger.Warn("This is a Warning Message")
		logger.Error("This is an Error Message")
		logger.Fatal("This is a Fatal Message")

		' Pause the console for viewing output
		Console.Read()
	End Sub
End Class

Programımız aşağıdaki gibi Konsolda mesajları güncellemiştir.

Şimdi, Konsolda mesajların güncellenmesinin bir örneğini gösterdik. Şimdi dosyada mesajları güncellemek için bir NLog hedefini yapılandıracağız.

Dosyada Günlük Mesajları

Dosya kaydı için yapılandırma dosyamızda Konsol hedefi yerine bir dosya hedefi ayarlamamız gerekiyor.

<targets>

  <target xsi:type="File" name="fileTarget" fileName="D:\Logs\mylog.txt" layout="${longdate} ${level:uppercase=true} ${message}" />
</targets>

<rules>

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

<targets>

  <target xsi:type="File" name="fileTarget" fileName="D:\Logs\mylog.txt" layout="${longdate} ${level:uppercase=true} ${message}" />
</targets>

<rules>

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

Şimdi, dosyada mesajları güncellemek için programı çalıştırın.

Günlükleme hedefleri

NLog, çeşitli günlük çıkış hedeflerini destekleyerek günlük mesajlarınızın nerede saklanması gerektiğini seçmenize olanak tanır. Bazı yaygın hedefler şunları içerir:

1. Dosya: Bir veya daha fazla dosyaya mesajları günceller.
2. Konsol: Konsola mesajları günceller.
3. Veritabanı: Bir veritabanına (SQL Server, MySQL, Oracle, PostgreSQL, vb.) tabloya mesajları günceller.
4. E-posta: Günlük mesajlarını e-posta olarak gönderir.
5. Olay Günlüğü: Windows Olay Günlüğüne mesajları günceller.
6. Özel Hedefler: Özel günlük hedefleri oluşturabilirsiniz, özgün gereksinimlerinize uygun olarak.

NLog'u bir veya daha fazla hedefi aynı anda kullanacak şekilde yapılandırabilirsiniz.

Günlükleme ile PDF Oluşturma

Install-Package IronPdf

using NLog;
using IronPdf;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        logger.Info("Initializing Chrome PDF Renderer");
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        logger.Info("Creating PDF From HTML String");
        var pdf = renderer.RenderHtmlAsPdf("<h1>This is my Sample PDF<h1>");

        logger.Info("Saving PDF File");
        pdf.SaveAs(@"D:\myPDF.pdf");
    }
}

using NLog;
using IronPdf;

internal class Program
{
    // Create an instance of the Logger
    private static Logger logger = LogManager.GetCurrentClassLogger();

    static void Main(string[] args)
    {
        logger.Info("Initializing Chrome PDF Renderer");
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        logger.Info("Creating PDF From HTML String");
        var pdf = renderer.RenderHtmlAsPdf("<h1>This is my Sample PDF<h1>");

        logger.Info("Saving PDF File");
        pdf.SaveAs(@"D:\myPDF.pdf");
    }
}

Imports NLog
Imports IronPdf

Friend Class Program
	' Create an instance of the Logger
	Private Shared logger As Logger = LogManager.GetCurrentClassLogger()

	Shared Sub Main(ByVal args() As String)
		logger.Info("Initializing Chrome PDF Renderer")
		Dim renderer As New ChromePdfRenderer()

		logger.Info("Creating PDF From HTML String")
		Dim pdf = renderer.RenderHtmlAsPdf("<h1>This is my Sample PDF<h1>")

		logger.Info("Saving PDF File")
		pdf.SaveAs("D:\myPDF.pdf")
	End Sub
End Class