大型系統中,不同功能模組(如訂單、支付、日誌、API)的日誌需求各異:
透過程式碼動態建立多個 ILoggerRepository,各自配置 Appender,即可實現精細化日誌管理。
public static ILog GetLogger(string repositoryName = "")
{
if (string.IsNullOrEmpty(repositoryName))
return LogManager.GetLogger("Default");
ILoggerRepository repository = null;
// 1. 嘗試取得現有 Repository
try { repository = LogManager.GetRepository(repositoryName); }
catch { }
// 2. 找到直接回傳 Logger
if (repository != null)
return LogManager.GetLogger(repositoryName, "Default");
// 3. 不存在則建立新 Repository (雙重檢查鎖定模式防併發)
try { repository = LogManager.CreateRepository(repositoryName); }
catch
{
repository = LogManager.GetRepository(repositoryName);
}
// 4. 配置日誌等級 (從 AppSettings 讀取)
var appSettings = ConfigurationManager.AppSettings;
const string logLevelKey = "LogLevel";
if (appSettings.AllKeys.Contains(logLevelKey))
{
var level = appSettings[logLevelKey].ToLower();
repository.Threshold = level switch
{
"all" => Level.All,
"debug" => Level.Debug,
"info" => Level.Info,
"warn" => Level.Warn,
"error" => Level.Error,
"fatal" => Level.Fatal,
"off" => Level.Off,
_ => Level.All
};
}
else repository.Threshold = Level.All;
// 5. 配置 Appender (從 AppSettings 讀取,支援多個以逗號分隔)
const string logAppenderKey = "LogAppender";
if (appSettings.AllKeys.Contains(logAppenderKey))
{
var appenders = appSettings[logAppenderKey].ToLower().Split(',');
foreach (var appender in appenders)
{
switch (appender.Trim())
{
case "rollingfile": LoadRollingFileAppender(repository); break;
case "console": LoadConsoleAppender(repository); break;
case "trace": LoadTraceAppender(repository); break;
}
}
}
else LoadRollingFileAppender(repository); // 預設
return LogManager.GetLogger(repositoryName, "Default");
}
private static void LoadRollingFileAppender(ILoggerRepository repository)
{
var appender = new RollingFileAppender
{
Name = "RollingFile",
File = "Logs/", // 目錄
AppendToFile = true,
LockingModel = new FileAppender.MinimalLock(),
RollingStyle = RollingFileAppender.RollingMode.Composite,
DatePattern = "yyyy-MM-dd HH'時.log'",
MaxSizeRollBackups = 1000, // 最大備份數
MaximumFileSize = "500KB", // 單檔大小
StaticLogFileName = false, // 允許檔名變動
Layout = new PatternLayout("%n【記錄時間】%date%n【描述】%message%n")
};
appender.ActivateOptions();
BasicConfigurator.Configure(repository, appender);
}
private static void LoadConsoleAppender(ILoggerRepository repository)
{
var appender = new ConsoleAppender
{
Layout = new PatternLayout("%date [%thread] %-5level %logger - %message%newline")
};
appender.ActivateOptions();
BasicConfigurator.Configure(repository, appender);
}
<appSettings>
<!-- 統一設定所有 Repository 的日誌等級 -->
<add key="LogLevel" value="DEBUG" />
<!-- 統一設定所有 Repository 的輸出目標 -->
<add key="LogAppender" value="rollingfile,console" />
</appSettings>
預設配置下,日誌檔案會隨時間無限增長。需結合 時間 與 大小 兩維度滾動:
<appender name="SmartRollingAppender" type="log4net.Appender.RollingFileAppender">
<file value="Logs/應用程式.log" />
<appendToFile value="true" />
<lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
<!-- 核心:複合滾動模式 (時間 + 大小) -->
<rollingStyle value="Composite" />
<!-- 時間模式:每小時一個檔案 -->
<datePattern value="yyyy-MM-dd HH'時.log'" />
<!-- 大小限制:單檔 500KB -->
<maximumFileSize value="500KB" />
<!-- 最大備份數:保留最近 1000 個檔案 -->
<maxSizeRollBackups value="1000" />
<!-- 關鍵:靜態檔名設為 false,允許日期模式生效 -->
<staticLogFileName value="false" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
</layout>
</appender>
應用程式.log應用程式2024-01-15 14時.log應用程式2024-01-15 14時.log.1, .2...log4net 本身不支援「保留 N 天」自動刪除,建議搭配排程任務:
// 可在 Application_Start 啟動背景工作,或使用 Windows 排程器/Quartz.NET
public static void CleanOldLogs(string logDirectory, int keepDays = 30)
{
var dir = new DirectoryInfo(logDirectory);
var cutoff = DateTime.Now.AddDays(-keepDays);
foreach (var file in dir.GetFiles("*.log*"))
{
if (file.LastWriteTime < cutoff)
{
try { file.Delete(); } catch { /* 記錄錯誤 */ }
}
}
}
// 訂單模組
private static readonly ILog OrderLog = LogHelper.GetLogger("OrderModule");
// 支付模組
private static readonly ILog PaymentLog = LogHelper.GetLogger("PaymentModule");
// API 存取日誌
private static readonly ILog ApiLog = LogHelper.GetLogger("ApiAccess");
// 使用
OrderLog.Info("訂單建立成功", new { OrderId = 123, Amount = 999 });
PaymentLog.Error("付款失敗", ex);
ApiLog.Debug("API 請求", new { Url = "/api/order", Ip = "192.168.1.1" });
透過程式碼動態管理 ILoggerRepository,配合 AppSettings 統一配置等級與 Appender,實現了:
GetLogger("NewModule"),無需修改設定檔這套架構在中大型專案中經過實戰驗證,能有效解決日誌管理混亂、磁碟空間失控、除錯困難等常見問題。