一、前言
在上一篇中,我們通過學習瞭解在.net core 中內建的日誌記錄中的幾大核心要素,在日誌工廠記錄器(ILoggerFactory
)中實現將日誌記錄提供器(ILoggerProvider
)物件都可以整合到Logger
物件組合中,這樣的話,我們就可以通過基於ILoggerProvider
自定義日誌記錄程式整合到Logger
中,再建立寫日誌定義Ilogger
,自定義日誌記錄器實現日誌的輸出方式,這樣實現自定義日誌記錄工具。
在這個過程中,日誌記錄器ILogger
中的Log()方法會記錄執行日誌,通過在ILoggerFactory
產生的是ILogger
型別(也就是我們最終使用的Logger
),其Log()方法是依次呼叫Logger
中包含的LoggerInformation[]
陣列中的ILogger
。而ILoggerProvider
產生的為各類不同的XxxLogger(也就是上面說的Logger
中的LoggerInformation
陣列包含的如ConsoleLogger、DebugLogger
),其Log()方法是把日誌寫到具體的目標上去,所以我們自定義的日誌程式也可以在日誌記錄器工廠中實現新增日誌程式,達到將日誌寫到具體目標的作用。
所以下文我們通過自定義的方式實現ILogger
、ILoggerProvider
兩個介面來實現我們自己想要的日誌記錄程式,實現自定義輸出目標方式。(下文只是簡單的根據介面自定義實現輸出日誌記錄到控制檯的demo)
二、開始
2.1 自定義Logger
建立一個自定義Logger,目的是將指定的等級日誌輸出到控制檯。所以我們建立一個ExtensionLogger
的類,指定輸出的日誌等級。所以在這之前,我們需要配置一下輸入日誌的等級,因此我們需要增加一個等級的配置類ExtensionsConfiguration
。
在ExtensionsConfiguration
中,
public class ExtensionsConfiguration
{
/// <summary>
/// 日誌等級
/// </summary>
public LogLevel LogLevel { get; set; } = LogLevel.Warning;
}
再自定義日誌記錄類ExtensionLogger
,實現介面ILogger
,
public class ExtensionsLogger : ILogger
{
private readonly ExtensionsConfiguration _config;
public ExtensionsLogger(ExtensionsConfiguration extensionsConfiguration)
{
_config = extensionsConfiguration;
}
public IDisposable BeginScope<TState>(TState state)
{
return null;
}
public bool IsEnabled(LogLevel logLevel)
{
return logLevel == _config.LogLevel;
}
public void Log<TState>(LogLevel logLevel, EventId eventId, TState state,
Exception exception, Func<TState, Exception, string> formatter)
{
if (!IsEnabled(logLevel))
{
return;
}
Console.WriteLine($" {logLevel} - {eventId.Id} : " + formatter(state, exception));
}
}
根據ILogger
介面實現,其中實現Log()
介面方法,將日誌輸出到指定目標,這裡是輸出到控制檯,在設定了日誌等級的情況條件下,當滿足條件後,才能輸出對應的日誌。
2.2 自定義LoggerProvider
在建立了日誌輸出記錄後,我們同時需要提供一個日誌程式來增加和建立上面的Logger
記錄,所以我們通過自定義日誌提供器類ExtensionsLoggerProvider
,實現ILoggerProvider
類。
public class ExtensionsLoggerProvider : ILoggerProvider
{
private readonly ExtensionsConfiguration _config;
public ExtensionsLoggerProvider(ExtensionsConfiguration extensionsConfiguration)
{
_config = extensionsConfiguration;
}
public ILogger CreateLogger(string categoryName)
{
return new ExtensionsLogger(_config);
}
public void Dispose()
{
}
}
基於ILoggerProvider
介面實現自定義類,實現方法CreateLogger
,來建立上面的日誌記錄。
2.3 使用
在Startup.cs中,通過Configure
方法呼叫配置日誌記錄。
public void Configure(IApplicationBuilder app, IWebHostEnvironment env , ILoggerFactory loggerFactory)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
// 注入ILogggerFactory,然後配置引數
//新增日誌等級
loggerFactory.AddProvider(new ExtensionsLoggerProvider(new ExtensionsConfiguration { LogLevel= LogLevel.Warning }));
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
endpoints.MapControllers();
});
}
在此之前,我們可以清空預設的配置,然後根據日誌等級,在控制檯中輸出對應的日誌記錄。
2.4 效果
在等級為Information
情況下,輸出效果如下:
這個就是我們通過自定義的方式實現的按日誌等級輸出的記錄。
三、擴充
3.1 寫入本地檔案
第一步:為LoggerFactory擴張一個方法,提供增加日誌寫檔案方式的入口。相關的配置來自appsettings.json
第二步:實現我們的logger提供程式,實現ILoggerProvider介面,關鍵方法CreateLogger,建立真正寫日誌的logger。對當前的logger可以做適當的快取,配置logger
第三步:實現我們的logger,實現ILogger介面。真正將log寫入file。
這裡可以參考網友的資料 :.Net Core Logger 實現log寫入本地檔案系統