ASP.NET?Core記錄日志
1.前言
ASP.NET Core支持適用于各種內(nèi)置和第三方日志記錄提供應(yīng)用程序的日志記錄API。本文介紹了如何將日志記錄API與內(nèi)置提供應(yīng)用程序一起使用。
2.添加日志提供程序
日志記錄提供應(yīng)用程序顯示或存儲日志。例如,控制臺提供應(yīng)用程序在控制臺上顯示日志,Azure Application Insights提供應(yīng)用程序?qū)⑦@些日志存儲在Azure Application Insights中。要添加提供應(yīng)用程序,請在Program.cs中調(diào)用提供程序的Add{provider name}擴展方法:
public static void Main(string[] args)
{
var webHost = new WebHostBuilder()
.UseKestrel()
.UseContentRoot(Directory.GetCurrentDirectory())
.ConfigureAppConfiguration((hostingContext, config) =>
{
var env = hostingContext.HostingEnvironment;
config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
.AddJsonFile($"appsettings.{env.EnvironmentName}.json",
optional: true, reloadOnChange: true);
config.AddEnvironmentVariables();
})
.ConfigureLogging((hostingContext, logging) =>
{
//添加appsettings.json中關(guān)于日志的Logging節(jié)點配置
logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging"));
//日志控制臺記錄提供程序
logging.AddConsole();
//日志Debug記錄提供程序
logging.AddDebug();
//日志EventSource記錄提供程序
logging.AddEventSourceLogger();
})
.UseStartup<Startup>()
.Build();
webHost.Run();
}默認項目模板調(diào)用CreateDefaultBuilder,該操作將添加日志記錄(控制臺、DEBUG、EventSource)提供給應(yīng)用程序:
public static void Main(string[] args)
{
CreateWebHostBuilder(args).Build().Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>();3.創(chuàng)建日志
創(chuàng)建日志可以從依賴注入(DI)中獲取ILogger<TCategoryName>對象。以下Razor頁面示例會創(chuàng)建級別為Information且類別為AboutModel類(Models/AboutModel)的日志:
public class AboutModel
{
private readonly ILogger _logger;
public AboutModel(ILogger<AboutModel> logger)
{
//ILogger是Core內(nèi)置日志組件,默認已經(jīng)注入,無需再次手動注入
_logger = logger;
}
public void OnGet()
{
var Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}";
_logger.LogInformation("Message displayed: {Message}", Message);
}
}
private readonly ILogger<AboutModel> _logger;
public HomeController(ILogger<AboutModel> logger)
{
_logger = logger;
}
public IActionResult Index()
{
AboutModel aboutModel = new AboutModel(_logger);
aboutModel.OnGet();
return View();
}通過Kestral服務(wù)器啟動調(diào)試:

看看控制臺輸出日志記錄:

日志“級別”代表所記錄事件的嚴重程度。日志“類別”是與每個日志關(guān)聯(lián)的字符串。ILogger<T>實例會創(chuàng)建“類別”為類型T的完全限定名稱的日志。
3.1啟動時(Startup)創(chuàng)建日志
要將日志寫入Startup類,構(gòu)造函數(shù)簽名需包含ILogger參數(shù):
public class Startup
{
private readonly ILogger _logger;
public Startup(IConfiguration configuration, ILogger<Startup> logger)
{
Configuration = configuration;
_logger = logger;
}
public IConfiguration Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
_logger.LogInformation("Added TodoRepository to services");
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
_logger.LogInformation("In Development environment");
}
}
}通過Kestral服務(wù)器啟動調(diào)試看看控制臺輸出日志記錄:

3.2在程序中(Program)創(chuàng)建日志
如果使用CreateDefaultBuilder,則可自行選擇提供應(yīng)用程序來替換默認應(yīng)用程序。調(diào)用 ClearProviders,然后添加所需的應(yīng)用程序。
public class Program
{
public static void Main(string[] args)
{
var host = CreateWebHostBuilder(args).Build();
var logger = host.Services.GetRequiredService<ILogger<Program>>();
logger.LogInformation("Seeded the database.");
host.Run();
}
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
.UseStartup<Startup>()
.ConfigureLogging(logging =>
{
logging.ClearProviders();
logging.AddConsole();
});
}通過Kestral服務(wù)器啟動調(diào)試看看控制臺輸出日志記錄:

4.Configuration
日志記錄提供程序配置由一個或多個配置提供程序提供:
- 文件格式(INI、JSON 和 XML)。
- 命令行參數(shù)。
- 環(huán)境變量。
- 內(nèi)存中的.NET對象。
- 未加密的機密管理器存儲。
- 加密的用戶存儲,如 Azure Key Vault。
- (已安裝或已創(chuàng)建的)自定義提供程序。
例如,日志記錄配置通常由應(yīng)用設(shè)置文件的Logging部分提供。以下示例顯示了典型 appsettings.Development.json 文件的內(nèi)容:
{
"Logging": {
"LogLevel": {
"Default": "Debug",
"System": "Information",
"Microsoft": "Information"
},
"Console":
{
"IncludeScopes": true
}
}
}Logging屬性可具有LogLevel和日志提供程序?qū)傩裕@示控制臺)。Logging下的LogLevel屬性指定了用于記錄所選類別的最低級別。在本例中,System和Microsoft類別在Information級別記錄,其他均在Debug級別記錄。如果提供程序支持日志作用域,則IncludeScopes將指示是否啟用這些域。
5.日志級別
每個日志都指定了一個LogLevel值。日志級別指示嚴重性或重要程度。如果LogLevel是Warning級別,那么跟蹤Trace,Debug,Information級別將不會記錄。ASP.NET Core 定義了以下日志級別(按嚴重性從低到高排列):
- 跟蹤Trace = 0
- 調(diào)試Debug = 1
- 信息 Information = 2
- 警告 Warning = 3
- 錯誤 Error = 4
- 嚴重 Critical = 5
6.內(nèi)置日志記錄提供程序
- 控制臺:logging.AddConsole(); dotnet run 查看控制臺日志記錄輸出。
- 調(diào)試:logging.AddDebug(); 在 Linux 中,此提供程序?qū)⑷罩緦懭?/var/log/message。
- EventSource:logging.AddEventSourceLogger();在Windows中,它使用PerfView實用工具收集和查看日志,但尚無支持Linux或macOS的事件集合和顯示工具。
- EventLog:logging.AddEventLog();向Windows事件日志發(fā)送日志輸出。
- TraceSource:logging.AddTraceSource(sourceSwitchName);應(yīng)用必須在.NET Framework(而非.NET Core)上運行。
7.第三方日志記錄提供程序
適用于ASP.NET Core的第三方日志記錄框架,鏈接地址官方文檔中有:
- elmah.io(GitHub 存儲庫)
- Gelf(GitHub 存儲庫)
- JSNLog(GitHub 存儲庫)
- KissLog.net(GitHub 存儲庫)
- Loggr(GitHub 存儲庫)
- NLog(GitHub 存儲庫)
- Sentry(GitHub 存儲庫)
- Serilog(GitHub 存儲庫)
- Stackdriver(Github 存儲庫)
例如使用NLog:NLog是一個靈活的免費日志記錄平臺,適用于各種.NET平臺,包括.NET標(biāo)準(zhǔn)。NLog可以輕松寫入多個目標(biāo)。(數(shù)據(jù)庫,文件,控制臺)并即時更改日志記錄配置。
到此這篇關(guān)于ASP.NET Core記錄日志的文章就介紹到這了。希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
ASP.NET組件System.Web.Optimization原理及緩存問題詳解
這篇文章主要介紹了ASP.NET組件System.Web.Optimization的運行原理,及基本的緩存問題,感興趣的小伙伴們可以參考一下2016-05-05
讓Silverlight 2.0動畫動起來Making Silverlight 2.0 animation Start(
Microsoft Expression Blend 2 制作動畫個人感覺倒像3DMAX 可以自動捕捉關(guān)鍵幀2008-11-11
在ASP.NET2.0中通過Gmail發(fā)送郵件的代碼
我們有時候需要發(fā)送郵件給訪問網(wǎng)頁的用戶,例如,注冊的時候,發(fā)一確認信什么的。那么,在ASP.NET2.0中該如果操作呢?2008-06-06
Windows虛擬主機與VPS如何實現(xiàn)301重定向(asp.net)
301重定向應(yīng)該是研究SEO必須掌握的技術(shù)。如果你是剛接觸SEO的菜鳥,想了解什么是301重定向,請看《html實現(xiàn)301重定向的方法》一文,我在該篇隨筆中引用了Google網(wǎng)站站長工具對301重定向的解釋2011-12-12
Asp.net的GridView控件實現(xiàn)單元格可編輯方便用戶使用
考慮到用戶使用方便,減少彈出頁面,采用點“編輯”按鈕無需彈出頁面直接當(dāng)前行的單元格內(nèi)容就能編輯,思路及代碼如下,有此需求的朋友可以參考下,希望對大家有所幫助2013-08-08
ASP.NET MVC 4使用PagedList.Mvc分頁的實現(xiàn)代碼
本篇文章主要介紹了ASP.NET MVC 4使用PagedList.Mvc分頁的實現(xiàn)代碼,具有一定的參考價值,感興趣的小伙伴們可以參考一下2017-07-07
在?.NET?平臺使用?ReflectionDynamicObject?優(yōu)化反射調(diào)用的代碼詳解
這篇文章主要介紹了在?.NET?平臺使用?ReflectionDynamicObject?優(yōu)化反射調(diào)用代碼,代碼簡單易懂,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-03-03
ASP.NET?MVC實現(xiàn)樹形導(dǎo)航菜單
這篇文章介紹了ASP.NET?MVC實現(xiàn)樹形導(dǎo)航菜單的方法,文中通過示例代碼介紹的非常詳細。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-09-09

