https://mp.weixin.qq.com/s/w3qbQjSP8vRi2lhhry3BiA
记录日志的一个浸染便是方便对运用程序进行跟踪和排错调查,在实际运用上都是引入 日志框架,但如果你的 日志文件 包含非构造化的数据,那么查询起来将是一个噩梦,以是须要在记录日志的时候采取构造化办法。
将日志构造化可以更随意马虎的查询和剖析,做法便是在写入的时候定义好数据的格式,这种格式包括:xml,json,或者你希望转成的任何构造。
Serilog 是一个第三方,开源的构造化日志框架,它的高层封装可以让开发者更随意马虎的将日志记录到 console,file 和你能想到的各种 存储系统,这篇文章我们将会谈论如何在 ASP.Net Core 中利用 Serilog。
安装 Serilog利用 Visual Studio 新建 ASP.Net Core 项目,接下来从 NuGet 上拉几个包,详细如下:
Serilog这个包供应了对基本的构造化日志的功能支持。
Serilog.AspNetCore这个包供应了 Serilog 对 AspNetCore 的支持。
Serilog.Settings.Configuration这个包打通了 Serilog 和 Configuration ,这样你就可以直接从 appsettings.json 中读取配置。
Serilog.Sinks.ConsoleConsole吸收器顾名思义便是将 Serilog 的日志输出到 Console。
Serilog.Sinks.RollingFile实现了对 滚动文件 的支持。
利用 Serilog SinkSerilog 利用 sink 特性将日志送到不同的地方,比如:text文件,数据库,乃至是 ElasticSearch 中,换句话说,sink 特性可以把日志送到它该去的地方,当所有的 nuget 包都安装好了之后,下面的代码片段展示了如何将日志送到 console 中。
public HomeController(ILogger<HomeController> logger) { using (var logConfig = new LoggerConfiguration().WriteTo.Console().CreateLogger()) { logConfig.Information("This is a test data."); }; _logger = logger; }
值得把稳的是,Serilog 支持多个日志级别,如:verbose, debug, information, warning, error 和 fatal。
有时候为了调试目的,将日志送到 Console 是一个好办法,但将程序支配莅临盆之后,更通用的做法便是将日志记录到文件中,这样方便在生产上实时查看并做一定程度的日志剖析,刚好这里的 Serilog.Sink.RollingFile 支持对滚动文件的支持,下面的代码片段展示了如何通过编程的办法将日志送到文件中。
public HomeController() { var logger = new LoggerConfiguration().MinimumLevel.Debug().WriteTo .RollingFile(@"e:\log.txt", retainedFileCountLimit: 7) .CreateLogger(); for (int i = 0; i < byte.MaxValue; i++) { logger.Information($"log {i}"); } }
在 ASP.NET Core 中内置了 Logger 组件,这一节中我们一起看看如何利用 Serilog 将其进行更换,在 Program.Main 方法中利用如下代码:
public class Program { public static void Main(string[] args) { Log.Logger = new LoggerConfiguration() .MinimumLevel.Debug() .MinimumLevel.Override("Microsoft", LogEventLevel.Information) .Enrich.FromLogContext() .WriteTo.Console() .CreateLogger(); try { Log.Information("Starting web host"); CreateHostBuilder(args).Build().Run(); } catch (Exception ex) { Log.Fatal(ex, "Host terminated unexpectedly"); } finally { Log.CloseAndFlush(); } } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .UseSerilog() .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }); }
从上面的代码中可以看到,我在 CreateHostBuilder 中利用了 UseSerilog() 扩展方法来启动 Serilog,这样就做好了 Serilog 的更换事情,接下来可以在 Controller 中通过依赖注入的办法获取 logger 实例,如下代码所示:
public IActionResult Index() { logger.LogInformation("hello world"); return View(); }
日志是一个运用程序不可或缺的一部分,以是选择一款 灵巧 + 大略 的日志框架就显得特殊主要了,Serilog 供应了低配置和易利用的特性让我们方便的将日志送到各个地方。
译文链接:https://www.infoworld.com/article/3314985/how-to-use-serilog-in-aspnet-core.html