DotNet
프로젝트 관리
로그 시스템
Serilog
Serilog와 SQLite의 통합

Serilog와 SQLite의 통합

SQLite 라이브러리

Serilog와 SQLite를 함께 사용하는 경우, 사용할 SQLite 라이브러리를 선택하는 것은 몇 가지 요소에 따라 달라집니다. 주로 사용할 수 있는 두 가지 주요 옵션은 System.Data.SQLite와 Microsoft.Data.Sqlite이며 이 두 라이브러리는 분명한 차이점이 존재합니다.

System.Data.SQLite

System.Data.SQLite는 .NET Framework 및 .NET Core 모두에서 사용할 수 있는 ADO.NET provider입니다. 이 라이브러리는 SQLite 데이터베이스와 상호작용하기 위해 내부적으로 SQLite.Interop.dll이라는 네이티브 라이브러리를 사용합니다. SQLite.Interop.dll은 플랫폼에 따라 다른 버전(예: x86, x64)이 필요하며, 이 라이브러리 없이는 System.Data.SQLite를 사용할 수 없습니다.

Serilog.Sinks.SQLite

이 싱크는 주로 System.Data.SQLite를 사용하여 로깅 데이터를 SQLite 데이터베이스에 기록합니다. 따라서 이 싱크를 사용하기 위해서는 System.Data.SQLite와 함께 SQLite.Interop.dll을 설치하고 관리해야 합니다.

Microsoft.Data.Sqlite

Microsoft.Data.Sqlite는 .NET Core 프로젝트를 위해 설계된 더 가볍고 모던한 SQLite 라이브러리입니다. 이 라이브러리는 System.Data.SQLite와 달리 네이티브 코드 라이브러리 SQLite.Interop.dll에 의존하지 않습니다. 대신, SQLite의 기능을 모두 관리 코드 내에 포함하고 있어, 플랫폼 간 호환성과 배포의 용이성을 제공합니다. 현재로서는 Microsoft.Data.Sqlite를 사용하여 로그를 SQLite에 기록하기 위한 공식적인 Serilog 싱크가 없습니다.

참고사항

일반적으로 Serilog.Sinks.SqLite를 주로 사용하지만, 해당 DLL들을 하나로 패키징할 때는 문제가 될 수 있습니다. 예를 들어, 라이브러리를 만드는데 종속성을 없애려 할 때입니다. 즉, DLL 파일을 빌드하는데, SQLite.dll이나 SeriLog.dll을 모두 포함하여 빌드해야 할 때가 있는데, 이럴 땐 SQLite.Interop.dll이 네이티브 라이브러리라는 점이 문제가 됩니다. 이 DLL은 관리되지 않는 네이티브 코드 라이브러리이기 때문에, 일반적인 관리 코드 라이브러리와 다르게 다루어져야 하며, 내장 리소스로 처리하거나 단순히 프로젝트에 추가하는 것만으로는 충분하지 않습니다. 이와 관련하여 [종속성 관리](/DotNet/프로젝트-관리/패키징 전략/종속성-관리-전략) 을 참조하시기 바랍니다.

System.Data.SQLite

필요한 패키지 설치하기

  • Serilog
  • Serilog.Sinks.SQLite
  • System.Data.SQLite 이들은 모두 NuGet을 통해 설치할 수 있으며, 다음과 같은 명령을 사용하여 설치할 수 있습니다:
dotent add package Serilog
dotent add package Serilog.Sinks.SQLite
dotent add package System.Data.SQLite

로거 설정 예시

Serilog를 사용하여 SQLite로 로그를 저장하는 로거 구성은 다음과 같이 진행할 수 있습니다:

using Serilog;
public class LoggerConfig
{
    public static void ConfigureLogger()
    {
        Log.Logger = new LoggerConfiguration()
            .WriteTo.SQLite("Logs.db", storeTimestampInUtc: true) 
            .CreateLogger();
    }
}

storeTimestampInUtc: true 옵션은 로그의 타임스탬프를 UTC 시간으로 저장하도록 설정합니다. 이는 다양한 타임존에서의 로깅을 통일할 때 유용할 수 있습니다.

로깅 사용

로거가 설정된 후, 다음과 같이 로그를 기록할 수 있습니다:

public class Program
{
    static void Main(string[] args)
    {
        LoggerConfig.ConfigureLogger();
        
        Log.Information("This is an informational message");
        Log.Warning("This is a warning message");
        Log.Error("This is an error message");
        Log.CloseAndFlush(); // 중요: 애플리케이션 종료 전에 로거를 정리
    }
}

Microsoft.Data.SQLite

필요한 패키지 설치하기

  • Serilog
  • Microsoft.Data.SQLite
dotent add package Serilog
dotent add package Microsoft.Data.SQLite

로거 설정 예시

Serilog를 사용하여 SQLite로 로그를 저장하는 로거 구성은 다음과 같이 진행할 수 있습니다:

using Serilog;
public class LoggerConfig
{
    public static void ConfigureLogger()
    {        
		Log.Logger = new LoggerConfiguration()
            .WriteTo.Console()
            .WriteTo.Sink(new SqliteSink("Logs/logs.db"))
            .CreateLogger();
    }
}

로깅 사용

사용방식은 동일합니다.

Buy me a coffee Buy me a coffee
Serilog 기록 방식별 성능 분석