NLog C# (개발자용 작동 방식)

NLog 설정 파일(일반적으로 nlog.config라는 이름으로)을 생성하려면 다음 단계를 따를 수 있습니다. 이 설정 파일은 애플리케이션에서 NLog가 어떻게 동작해야 하는지, 로그 대상, 레이아웃 렌더러 및 규칙을 포함하여 지정할 것입니다.

프로젝트에서 프로젝트 또는 설정 파일을 생성할 원하는 폴더를 마우스 오른쪽 버튼으로 클릭합니다.

1. '추가' > '새 항목...'을 선택합니다.
2. '새 항목 추가' 대화 상자에서 'XML 파일' 또는 'XML'을 검색하고 선택합니다.

3. 파일 이름을 nlog.config로 지정하고 '추가' 버튼을 클릭합니다.

   

4. 새롭게 생성된 nlog.config 파일을 텍스트 편집기 또는 XML 편집기에서 엽니다.
5. NLog.XML 파일에 다음 구성을 추가합니다. 아래에는 콘솔 대상으로 메시지를 로그하는 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>

<?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# 코드에서 nlog.config 파일에서 NLog 구성을 로드했는지 확인하세요. 일반적으로 ASP.NET Core의 Startup.cs(.NET 버전 5 이하의 경우), program.cs 파일(.NET 6 이상), 또는 콘솔 응용 프로그램의 Main 메서드에서 이를 수행합니다:

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

위 프로그램의 출력은 다음과 같이 표시됩니다:

이 예제에서는 Logger 클래스의 인스턴스를 생성하고 이를 사용하여 디버그 수준에서 메시지를 기록합니다. NLog에서 지원하는 추적 수준을 살펴보겠습니다.

로그 레벨

NLog는 각각 고유한 중요성을 가진 여러 로그 수준을 지원합니다:

1. Trace: 가장 자세한 수준으로, 일반적으로 진단 목적으로 사용됩니다.
2. Debug: 개발 중에 유용할 수 있는 디버그 정보에 사용됩니다.
3. Info: 응용 프로그램 작동에 대한 일반 정보입니다.
4. Warn: 응용 프로그램을 방해하지 않는 잠재적 문제를 나타냅니다.
5. Error: 조사해야 하지만 반드시 앱을 충돌시키지는 않는 실패를 나타냅니다.
6. Fatal: 즉시 조치해야 하는 치명적 실패를 나타냅니다.

로그 메시지를 이러한 수준으로 분류함으로써 중요도에 따라 필터링하고 우선순위를 정할 수 있습니다.

nLog.Config 파일의 rules 태그에 minlevel="Trace"을 아래와 같이 설정하십시오.

<rules>

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

<rules>

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

모든 추적 수준의 메시지를 기록하는 코드를 작성합시다.

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

우리 프로그램은 아래와 같이 콘솔에 메시지를 기록했습니다.

이제 콘솔에 메시지를 기록하는 예제를 시연했습니다. 이제 파일에 메시지를 기록하기 위해 NLog 대상을 구성할 것입니다.

파일에 로그 메시지

파일 로그를 위해 구성 파일에서 콘솔 대상 대신 파일 대상을 설정해야 합니다.

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

이제 프로그램을 실행하여 파일에 메시지를 기록합니다.

로그 대상

NLog는 다양한 로그 출력 대상을 지원하며, 로그 메시지를 저장할 위치를 선택할 수 있게 해 줍니다. 일반적인 대상은 다음과 같습니다:

1. 파일: 하나 이상의 파일에 메시지를 기록합니다.
2. 콘솔: 콘솔에 메시지를 기록합니다.
3. 데이터베이스: 데이터베이스(SQL Server, MySQL, Oracle, PostgreSQL 등) 테이블에 메시지를 기록합니다.
4. 이메일: 이메일로 로그 메시지를 전송합니다.
5. 이벤트 로그: Windows 이벤트 로그에 메시지를 기록합니다.
6. 사용자 정의 대상: 특정 요구에 맞는 사용자 정의 로그 대상을 만들 수 있습니다.

NLog를 구성하여 하나 이상의 대상을 동시에 사용할 수 있습니다.

로그가 포함된 PDF 생성

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