Serilog .NET（開發者的工作原理）

結構化日誌

Serilog的一個突出的功能是其對結構化日誌的支持。 Serilog允許您記錄結構化資料，而不是僅僅將消息記錄為純文本。 這些結構化資料可以是JSON物件、字典或任何可序列化的類型。 通過記錄結構化資料，您可以輕鬆使用像Elasticsearch或Splunk這樣的工具分析和查詢日誌事件。

靈活的配置

Serilog提供靈活的配置選項，允許您根據應用程式的需要自定義日誌行為。 您可以程式設計方式或使用配置文件配置Serilog。 這種靈活性允許您在執行時調整日誌行為，而無需重啟應用程式。

接收器庫

Serilog提供各種接收器庫，使您能夠將日誌事件發送到不同的目的地。 一些流行的接收器庫包括：

• Serilog.Sinks.Console：將日誌事件發送到控制台。
• Serilog.Sinks.File：將日誌事件寫入文本文件。
• Serilog.Sinks.Seq：將日誌事件發送到Seq，一個結構化日誌伺服器。
• Serilog.Sinks.Elasticsearch：將日誌事件發送到Elasticsearch。

這些接收器庫使Serilog與不同的日誌基礎設施和工具整合變得容易。

日誌豐富化

日誌豐富化是一個功能，允許您向日誌事件添加額外的上下文信息。 Serilog提供各種增強器，可自動向您的日誌事件添加時間戳、線程ID或日誌級別等信息。 您也可以創建自定義增強器來添加應用程式特定的信息。

日誌過濾

Serilog允許您根據各種標準篩選日誌事件。 您可以配置過濾器以根據日誌級別、屬性值或任何其他條件來排除或包括日誌事件。 此過濾功能使您能夠專注於對您的分析或故障排除最相關的日誌事件。

了解並利用這些功能，您可以利用Serilog的強大功能來增強您的日誌能力，並獲得有關應用程式行為的寶貴見解。

結構化日誌：核心功能

Serilog的主要強項在於將日誌消息轉化為結構化資料。 與其他輸出純文本的日誌庫不同，Serilog以結構化JSON格式生成日誌，從而簡化了解析和查詢日誌資料。 此功能對於日誌分析和監控是運營情報的重要組成部分的現代應用程式至關重要。 當日誌消息被輸入到像ELK（Elasticsearch, Logstash, Kibana）堆棧這樣的系統中進行高級分析時，結構化日誌特別有用。

豐富的日誌事件詳情

Serilog豐富了日誌事件的上下文信息，提供了全面的應用程式內部情況視圖。 每個日誌事件可以包含超過簡單日誌消息的多項詳細信息，包括時間戳、日誌級別、異常詳情和自定義屬性。 這使得Serilog在日誌深度和清晰度上優於其他日誌庫，為開發者提供了關鍵的應用程式行為和性能的見解。

通過配置文件

使用配置JSON文件定義日誌級別、輸出目的地（如日誌文件或控制台）以及日誌輸出格式。 配置文件方法提供了改變日誌行為而不需要修改代碼的靈活性。 這是通過在appsettings.json文件中指定設置來完成的，這允許您將日誌輸出引導到多個接收器，如控制台、文件，甚至雲端日誌管理服務。

程式設計代碼

或者，直接在代碼中使用LoggerConfiguration類配置Serilog。 此方法通常用於設置更複雜的日誌場景，如動態日誌級別或自定義日誌接收器。 例如，您可以配置一個循環日誌文件，根據特定的時間間隔或達到一定大小時創建新的日誌文件，確保高效的日誌文件管理。

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

// Create a logger instance with a rolling log file that creates a new log file every day
var logger = new LoggerConfiguration()
    .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day) 
    .CreateLogger();

與ASP.NET Core整合

將Serilog與ASP.NET Core整合涉及通過套件管理器控制台添加Serilog軟體包，並在Program.cs文件中設置記錄器。 .NET 6中的var app陳述將Serilog無縫地插入到應用程式的記錄基礎設施中。 這個過程用Serilog取代了默認的記錄器，確保所有日誌消息都通過Serilog管道處理。

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog to use settings from appsettings.json and write logs to the console
builder.Host.UseSerilog((ctx, lc) => lc
    .WriteTo.Console()
    .ReadFrom.Configuration(ctx.Configuration));

var app = builder.Build();

IronPDF

IronPDF允許在.NET應用程式內創建、讀取和編輯PDFs。 當與Serilog結合時非常有用，可以生成日誌資料的PDF報告，實現日誌信息的標準化格式上的輕鬆分發和查看。

IronOCR

IronOCR是一個光學字符識別（OCR）庫，能夠將125種語言的圖像轉換為文本。 在必須從圖像或掃描文件中提取文本資料的日誌場景下，此功能可用來豐富更多上下文信息的日誌資料。

IronXL

IronXL提供無需Office Interop即可處理Excel的功能。對於日誌目的來說特別有利，因為日誌資料可以匯出到Excel中以進行進一步分析和報告，提供了熟悉的資料操作和可視化界面。

IronBarcode

IronBarcode方便了QR碼和條碼的讀寫。 這個庫可以在日誌文件中嵌入或提取編碼信息，增強記錄信息的安全性和可追溯性。