共计 2383 个字符,预计需要花费 6 分钟才能阅读完成。
记录日志的一个作用就是不便对应用程序进行跟踪和排错考察,在理论利用上都是引入 日志框架
,但如果你的 日志文件
蕴含非结构化的数据,那么查问起来将是一个噩梦,所以须要在记录日志的时候采纳结构化形式。
将日志结构化能够更容易的查问和剖析,做法就是在写入的时候定义好数据的格局,这种格局包含: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.Console
Console 接收器顾名思义就是将 Serilog 的日志输入到 Console。
- Serilog.Sinks.RollingFile
实现了对 滚动文件
的反对。
应用 Serilog Sink
Serilog 利用 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}");
}
}
应用 Serilog 替换原生的 Logger
在 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/art…
更多高质量干货:参见我的 GitHub: csharptranslate