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

Bir NLog yapılandırma dosyası (genellikle nlog.config olarak adlandırılır) oluşturmak için şu adımları izleyebilirsiniz. Bu yapılandırma dosyası, NLog'un uygulamanızda nasıl davranacağını belirleyecektir, log hedefleri, düzenleyici yerleştiriciler ve kurallar dahil.

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

1. "Ekle" > "Yeni Öğe..." öğesini seçin.
2. "Yeni Öğe Ekle" iletişim kutusunda "XML Dosyası" veya "XML" arayın ve seçin.

3. Dosyayı nlog.config olarak adlandırın ve "Ekle" düğmesine tıklayın.

   

4. Yeni oluşturulan nlog.config dosyasını bir metin düzenleyici veya XML düzenleyici ile açın.
5. NLog.XML dosyasına aşağıdaki yapılandırmayı ekleyin. Aşağıda, bir Konsol hedefi için mesajları günlüğe kaydeden temel bir NLog yapılandırmasının bir örneği bulunmaktadır. Bu Yapılandırma Dosyasını ihtiyaçlarınıza uygun hale getirebilirsiniz:

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 yapılandırmasını nlog.config dosyasından yüklediğinizden emin olun. Genellikle bunu, uygulamanın başlangıç kodunda, örneğin bir ASP.NET Core Startup.cs için (.NET 5 veya daha eski sürümlerinde), program.cs dosyasında (.NET 6 veya üzeri sürümler için) veya 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ğıda gösterildiği gibidir:

Bu örnekte, Logger sınıfının bir örneğini oluşturuyoruz ve Debug Seviyesinde mesajları günlüğe kaydetmek için kullanıyoruz. NLog tarafından desteklenen izleme seviyesini keşfedelim.

Günlük Seviyeleri

NLog, her birinin kendine özgü önemi olan birkaç günlük seviyesini destekler:

1. İzleme: Tipik olarak tanılama amaçlı kullanılan en ayrıntılı seviyedir.
2. Hata Ayıklama: Geliştirme sırasında faydalı olabilecek hata ayıklama bilgileri için kullanılır.
3. Bilgi: Uygulamanın çalışması hakkında genel bilgi.
4. Uyarı: Uygulamanın çalışmasını bozmayan olası bir sorunu belirtir.
5. Hata: Araştırılması gereken bir arıza olduğunu belirtir, ancak uygulamanın çökmesine neden olmaz.
6. Ölümcül: Hemen ele alınması gereken bir kritik arızayı belirtir.

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

nLog.Config dosyanızdaki kurallar etiketi içine minlevel="Trace" aşağıda gösterildiği gibi yerleştirin.

<rules>

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

<rules>

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

Tüm izleme seviyelerindeki mesajları günlüğe kaydetmek için 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ğıda gösterildiği gibi Konsol'da mesajları günlüğe kaydetmiştir.

Artık Konsol'da mesajları günlüğe kaydetme örneğini gösterdik. Artık bir dosyaya mesajları günlüğe kaydetmek için bir NLog hedefini yapılandıracağız.

Dosyada Log Mesajı

Dosya günlüğü 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, bir dosyaya mesajları günlüğe kaydetmek için programı çalıştırın.

Günlük Hedefleri

NLog, günlük mesajlarınızın nerede depolanması gerektiğini seçmenizi sağlayan çeşitli günlük çıktı hedeflerini destekler. Bazı yaygın hedefler şunları içerir:

1. Dosya: Mesajları bir veya daha fazla dosyaya kaydeder.
2. Konsol: Mesajları konsola kaydeder.
3. Veritabanı: Mesajları bir veritabanı (SQL Server, MySQL, Oracle, PostgreSQL, vb.) tablosuna kaydeder.
4. E-posta: Mesajları e-postalar olarak gönderir.
5. Olay Günlüğü: Mesajları Windows Olay Günlüğü'ne kaydeder.
6. Özel Hedefler: Özellikle ihtiyaçlarınıza uygun özel günlük hedefleri oluşturabilirsiniz.

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

Günlüklü 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