C# 寫入 Windows 系統事件日誌：EventLog 類別完整封裝

.NET System.Diagnostics.EventLog 提供寫入 Windows 事件檢視器的功能，適用於服務、背景作業、關鍵錯誤審計。本文提供可直接使用的 LogWriter 封裝類別，支援自訂事件來源、日誌類型（Error/Warning/Information），並自動建立事件來源。

封裝類別程式碼

using System.Diagnostics;

public class LogWriter
{
    private string _source = "MyApp";
    private EventLogEntryType _type = EventLogEntryType.Error;

    public string EventSourceName { set => _source = value; }
    public EventLogEntryType EventLogType { set => _type = value; }

    public void LogEvent(string message)
    {
        if (!EventLog.SourceExists(_source))
        {
            // 需管理員權限，建議安裝時由安裝程式建立
            EventLog.CreateEventSource(_source, "Application");
        }
        EventLog.WriteEntry(_source, message, _type);
    }
}

使用範例

var logger = new LogWriter { EventSourceName = "OrderService", EventLogType = EventLogEntryType.Warning };
logger.LogEvent("訂單 #12345 庫存不足，已觸發補貨流程。");

// 直接寫入靜態方法（無需實例）
EventLog.WriteEntry("MyApp", "應用程式啟動", EventLogEntryType.Information);

關鍵點與最佳實務

進階：結構化日誌與 EventSource

.NET Core / .NET 5+ 推薦使用 System.Diagnostics.Tracing.EventSource（ETW 提供者），支援結構化欄位、高效能、PerfView/Windows Performance Analyzer 分析：

[EventSource(Name = "MyCompany-MyApp")]
public sealed class MyEventSource : EventSource
{
    public static MyEventSource Log = new MyEventSource();
    [Event(1, Level = EventLevel.Warning)]
    public void LowInventory(int orderId, string sku) => WriteEvent(1, orderId, sku);
}
// 使用：MyEventSource.Log.LowInventory(12345, "SKU-001");

適用場景建議

• EventLog：Windows 服務啟動/停止/錯誤、安全審計、需在事件檢視器供營運人員查看的關鍵里程碑。
• 檔案/資料庫/Serilog/NLog：一般業務日誌、除錯追蹤、高頻寫入、結構化查詢。
• EventSource/ETW：高效能追蹤、效能分析、生產環境低負擔監控。

正確使用系統事件日誌，能讓系統異常在「事件檢視器」留下可追溯、可篩選、可告警的審計軌跡。