.net下優秀的日誌框架Serilog，你用上了嗎？強烈推薦

架構師老盧發表於2023-12-06
框架
.net下優秀的日誌框架Serilog，你用上了嗎？強烈推薦

 

在 .NET 開發中，Serilog 是一款廣受歡迎的日誌庫，它提供了強大的日誌記錄功能，具有豐富的特性和高度的可擴充套件性。Serilog 的優秀之處包括：

  1. 可擴充套件性: Serilog 可以輕鬆擴充套件以滿足不同的日誌記錄需求，例如日誌儲存、格式化和過濾。它支援各種外掛和自定義擴充套件，讓你可以根據專案的具體要求定製日誌記錄功能。
  2. 結構化日誌: Serilog 支援結構化日誌，允許你以鍵值對的形式記錄資訊，這使得日誌資料更容易分析和查詢。這對於在日誌中儲存複雜的資料非常有用。
  3. 非同步日誌記錄: Serilog 可以非同步記錄日誌，這有助於提高應用程式的效能，減少因日誌記錄而引起的延遲。
  4. 多種輸出目標: Serilog 支援多種輸出目標，包括控制檯、檔案、資料庫、第三方日誌服務等。你可以將日誌記錄到不同的目標，以滿足不同的需求。
  5. 過濾器和級別控制: Serilog 允許你使用過濾器來選擇哪些日誌訊息應該被記錄，以及記錄的級別。這有助於減少日誌的噪音，並僅記錄關鍵資訊。
  6. 內建支援: Serilog 支援各種 .NET 技術棧，包括 ASP.NET Core、Entity Framework、Xamarin 和其他常見的 .NET 應用程式框架。

在本文中，我們將詳細介紹 Serilog 的各種優秀之處，並提供示例程式碼來演示其使用方法，包括高階應用和持久化方案。

Serilog 的基本使用

1. 安裝 Serilog

首先，你需要在專案中安裝 Serilog 包，可以使用 NuGet 包管理器或 .NET CLI 進行安裝。

dotnet add package Serilog
dotnet add package Serilog.Sinks.Console

上述命令將安裝 Serilog 的核心包和一個輸出到控制檯的外掛。

2. 配置 Serilog

在應用程式中配置 Serilog，你可以在 Program.cs 檔案中進行配置。以下是一個簡單的配置示例，將日誌記錄到控制檯。

using Serilog;
using Serilog.Sinks.Console;

public class Program
{
    public static void Main(string[] args)
    {
        Log.Logger = new LoggerConfiguration()
            .WriteTo.Console()
            .CreateLogger();

        // 啟動應用程式
        CreateWebHostBuilder(args).Build().Run();
    }
    
    public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
        WebHost.CreateDefaultBuilder(args)
            .UseSerilog() // 將 Serilog 整合到 ASP.NET Core
            .UseStartup<Startup>();
}

3. 記錄日誌

現在，你可以在應用程式中記錄日誌。以下是一個簡單的示例，在控制器中記錄日誌：

using Microsoft.AspNetCore.Mvc;
using Serilog;

public class MyController : ControllerBase
{
    public IActionResult Index()
    {
        Log.Information("訪問了首頁");
        return View();
    }
}

上述程式碼使用 Log.Information 方法記錄資訊級別的日誌訊息。

4. 結構化日誌記錄

Serilog 支援結構化日誌記錄，這允許你以鍵值對的形式記錄資訊。以下是一個示例：

Log.Information("使用者登入 {@User}", new { Username = "john", UserId = 123 });

這種結構化的日誌記錄對於儲存和查詢複雜的資料非常有用。

Serilog 高階應用

1. 自定義輸出目標

Serilog 允許你將日誌記錄到不同的輸出目標，如檔案、資料庫或第三方日誌服務。以下是一個示例，將日誌記錄到檔案中。

首先，安裝 Serilog 的檔案輸出外掛：

dotnet add package Serilog.Sinks.File

然後，配置 Serilog 以將日誌記錄到檔案：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.File("log.txt") // 將日誌記錄到檔案
    .CreateLogger();

2. 非同步日誌記錄

使用 Serilog 非同步記錄日誌可以提高效能，特別是在高負載應用程式中。以下是一個示例：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.Async(a => a.File("log.txt")) // 非同步將日誌記錄到檔案
    .CreateLogger();

3. 過濾器和級別控制

Serilog 允許你使用過濾器來選擇哪些日誌訊息應該被記錄，以及記錄的級別。以下是一個示例，只記錄資訊級別的日誌訊息：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .MinimumLevel.Information() // 只記錄資訊級別的日誌
    .CreateLogger();

你還可以使用過濾器來更精確地控制哪些訊息應該被記錄。

Serilog 持久化方案

Serilog 支援各種持久化方案，允許你將日誌資料儲存在不同的地方，如檔案、資料庫或第三方日誌服務。以下是一些常見的持久化方案。

1. 檔案持久化

你可以使用 Serilog 的檔案外掛將日誌記錄到檔案中，如前面所示。這是一個簡單的持久化方案，適用於小型應用程式。

2. 資料庫持久化

如果你希

望將日誌資料儲存在資料庫中，你可以使用 Serilog 的資料庫外掛，如 Serilog.Sinks.MSSqlServer 或 Serilog.Sinks.PostgreSQL。

首先，安裝適當的資料庫外掛：

dotnet add package Serilog.Sinks.MSSqlServer

然後，配置 Serilog 以將日誌記錄到資料庫：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.MSSqlServer("connectionString", "tableName") // 將日誌記錄到資料庫
    .CreateLogger();

3. Elasticsearch 持久化

如果你使用 Elasticsearch 作為日誌儲存後端，你可以使用
Serilog.Sinks.Elasticsearch 外掛將日誌記錄到 Elasticsearch。

首先，安裝 Elasticsearch 外掛：

dotnet add package Serilog.Sinks.Elasticsearch

然後，配置 Serilog 以將日誌記錄到 Elasticsearch：

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.Elasticsearch(new ElasticsearchSinkOptions(new Uri("http://localhost:9200"))) // 將日誌記錄到 Elasticsearch
    .CreateLogger();

這個外掛將日誌資料匯入 Elasticsearch，你可以使用 Elasticsearch 強大的搜尋和分析功能來查詢日誌資料。

Serilog 是一個功能豐富、可擴充套件且易於使用的.NET日誌庫。它支援多種日誌記錄場景，包括控制檯、檔案、資料庫和第三方日誌服務，具有強大的結構化日誌記錄功能，使日誌資料更容易管理和分析。在本文中，我們詳細介紹了 Serilog 的優秀之處和使用方法，包括基礎使用、高階應用和不同的持久化方案。希望這個指南有助於你更好地理解和利用 Serilog 來提高應用程式的日誌記錄質量和效能。

 

相關文章