網站首頁 編程語言 正文
1.前言
ASP.NET Core支持適用于各種內置和第三方日志記錄提供應用程序的日志記錄API。本文介紹了如何將日志記錄API與內置提供應用程序一起使用。
2.添加日志提供程序
日志記錄提供應用程序顯示或存儲日志。例如,控制臺提供應用程序在控制臺上顯示日志,Azure Application Insights提供應用程序將這些日志存儲在Azure Application Insights中。要添加提供應用程序,請在Program.cs中調用提供程序的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中關于日志的Logging節點配置 logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging")); //日志控制臺記錄提供程序 logging.AddConsole(); //日志Debug記錄提供程序 logging.AddDebug(); //日志EventSource記錄提供程序 logging.AddEventSourceLogger(); }) .UseStartup() .Build(); webHost.Run(); }
默認項目模板調用CreateDefaultBuilder,該操作將添加日志記錄(控制臺、DEBUG、EventSource)提供給應用程序:
public static void Main(string[] args) { CreateWebHostBuilder(args).Build().Run(); } public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder(args) .UseStartup();
3.創建日志
創建日志可以從依賴注入(DI)中獲取ILogger
public class AboutModel { private readonly ILogger _logger; public AboutModel(ILogger logger) { //ILogger是Core內置日志組件,默認已經注入,無需再次手動注入 _logger = logger; } public void OnGet() { var Message = $"About page visited at {DateTime.UtcNow.ToLongTimeString()}"; _logger.LogInformation("Message displayed: {Message}", Message); } } private readonly ILogger_logger; public HomeController(ILogger logger) { _logger = logger; } public IActionResult Index() { AboutModel aboutModel = new AboutModel(_logger); aboutModel.OnGet(); return View(); }
通過Kestral服務器啟動調試:
看看控制臺輸出日志記錄:
日志“級別”代表所記錄事件的嚴重程度。日志“類別”是與每個日志關聯的字符串。ILogger
3.1啟動時(Startup)創建日志
要將日志寫入Startup類,構造函數簽名需包含ILogger參數:
public class Startup { private readonly ILogger _logger; public Startup(IConfiguration configuration, ILoggerlogger) { 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服務器啟動調試看看控制臺輸出日志記錄:
3.2在程序中(Program)創建日志
如果使用CreateDefaultBuilder,則可自行選擇提供應用程序來替換默認應用程序。調用 ClearProviders,然后添加所需的應用程序。
public class Program { public static void Main(string[] args) { var host = CreateWebHostBuilder(args).Build(); var logger = host.Services.GetRequiredService>(); logger.LogInformation("Seeded the database."); host.Run(); } public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder(args) .UseStartup () .ConfigureLogging(logging => { logging.ClearProviders(); logging.AddConsole(); }); }
通過Kestral服務器啟動調試看看控制臺輸出日志記錄:
4.Configuration
日志記錄提供程序配置由一個或多個配置提供程序提供:
- 文件格式(INI、JSON 和 XML)。
- 命令行參數。
- 環境變量。
- 內存中的.NET對象。
- 未加密的機密管理器存儲。
- 加密的用戶存儲,如 Azure Key Vault。
- (已安裝或已創建的)自定義提供程序。
例如,日志記錄配置通常由應用設置文件的Logging部分提供。以下示例顯示了典型 appsettings.Development.json 文件的內容:
{ "Logging": { "LogLevel": { "Default": "Debug", "System": "Information", "Microsoft": "Information" }, "Console": { "IncludeScopes": true } } }
Logging屬性可具有LogLevel和日志提供程序屬性(顯示控制臺)。Logging下的LogLevel屬性指定了用于記錄所選類別的最低級別。在本例中,System和Microsoft類別在Information級別記錄,其他均在Debug級別記錄。如果提供程序支持日志作用域,則IncludeScopes將指示是否啟用這些域。
5.日志級別
每個日志都指定了一個LogLevel值。日志級別指示嚴重性或重要程度。如果LogLevel是Warning級別,那么跟蹤Trace,Debug,Information級別將不會記錄。ASP.NET Core 定義了以下日志級別(按嚴重性從低到高排列):
- 跟蹤Trace = 0
- 調試Debug = 1
- 信息 Information = 2
- 警告 Warning = 3
- 錯誤 Error = 4
- 嚴重 Critical = 5
6.內置日志記錄提供程序
- 控制臺:logging.AddConsole(); dotnet run 查看控制臺日志記錄輸出。
- 調試:logging.AddDebug(); 在 Linux 中,此提供程序將日志寫入 /var/log/message。
- EventSource:logging.AddEventSourceLogger();在Windows中,它使用PerfView實用工具收集和查看日志,但尚無支持Linux或macOS的事件集合和顯示工具。
- EventLog:logging.AddEventLog();向Windows事件日志發送日志輸出。
- TraceSource:logging.AddTraceSource(sourceSwitchName);應用必須在.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標準。NLog可以輕松寫入多個目標。(數據庫,文件,控制臺)并即時更改日志記錄配置。
原文鏈接:https://www.cnblogs.com/wzk153/p/11316482.html
相關推薦
- 2022-05-13 三分鐘搞懂react-hooks及實例代碼_React
- 2023-01-12 C語言求字符串長度的四種方法實例代碼_C 語言
- 2022-06-14 Go操作redis與redigo的示例解析_Golang
- 2022-05-06 python?selenium中Excel數據維護指南_python
- 2022-09-28 Python使用captcha制作驗證碼的實現示例_python
- 2022-07-20 C語言實例講解嵌套語句的用法_C 語言
- 2022-08-04 python設置Pyplot的動態rc參數、繪圖的填充_python
- 2022-12-05 服務啟動項Start類型詳解_其它
- 最近更新
-
- window11 系統安裝 yarn
- 超詳細win安裝深度學習環境2025年最新版(
- Linux 中運行的top命令 怎么退出?
- MySQL 中decimal 的用法? 存儲小
- get 、set 、toString 方法的使
- @Resource和 @Autowired注解
- Java基礎操作-- 運算符,流程控制 Flo
- 1. Int 和Integer 的區別,Jav
- spring @retryable不生效的一種
- Spring Security之認證信息的處理
- Spring Security之認證過濾器
- Spring Security概述快速入門
- Spring Security之配置體系
- 【SpringBoot】SpringCache
- Spring Security之基于方法配置權
- redisson分布式鎖中waittime的設
- maven:解決release錯誤:Artif
- restTemplate使用總結
- Spring Security之安全異常處理
- MybatisPlus優雅實現加密?
- Spring ioc容器與Bean的生命周期。
- 【探索SpringCloud】服務發現-Nac
- Spring Security之基于HttpR
- Redis 底層數據結構-簡單動態字符串(SD
- arthas操作spring被代理目標對象命令
- Spring中的單例模式應用詳解
- 聊聊消息隊列,發送消息的4種方式
- bootspring第三方資源配置管理
- GIT同步修改后的遠程分支