今天站长推荐一款日志可视化组件LogDashboard,可以不用安装第三方进程,只需要在项目中安装相应的Nuget包,添加数行代码,就可以实现拥有带Web页面的日志管理面板,十分nice哦。
下面是官方介绍:
官方文档地址:https://doc.logdashboard.net/
LogDashboard是在github上开源的aspnetcore项目, 它旨在帮助开发人员排查项目运行中出现错误时快速查看日志排查问题
通常我们会在项目中使用nlog、log4net等日志组件,它们用于记录日志的功能非常强大和完整,常见情况会将日志写到txt或数据库中, 但通过记事本和sql查看日志并不简单方便. LogDashboard提供了一个可以简单快速查看日志的面板.
LogDashboard适用于aspnetcore 2.x - aspnetcore3.x 项目, 采用aspnetcore中间件技术开发. 轻量快速
OK,本文带大家从0创建一个ASP.NET Core Web API新项目,然后添加日志组件Serilog,最后搭配使用LogDashboard完成此项目。
相信使用LogDashboard能极大提高你平时工作中的问题排查速度。
步骤:
添加Serilog日志组件
添加LogDashboard
可视化日志演示
本文实战开始
1. 创建一个ASP.NET Core Web API项目这一步很简单,使用VS 2019,创建一个ASP.NET Core Web API项目,命名为LogDashboardDemo。
2. 添加 Serilog 日志组件 2.1 Nuget 安装 Serilog 包 Install-Package Serilog.AspNetCore 2.2 Program.cs 中添加 Serilog 配置 public class Program { public static void Main(string[] args) { string logOutputTemplate = "{Timestamp:HH:mm:ss.fff zzz} || {Level} || {SourceContext:l} || {Message} || {Exception} ||end {NewLine}"; Log.Logger = new LoggerConfiguration() .MinimumLevel.Debug() .MinimumLevel.Override("Default", LogEventLevel.Information) .MinimumLevel.Override("Microsoft", LogEventLevel.Error) .MinimumLevel.Override("Microsoft.Hosting.Lifetime", LogEventLevel.Information) .Enrich.FromLogContext() .WriteTo.Console(theme: Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme.Code) .WriteTo.File($"{AppContext.BaseDirectory}Logs/Dotnet9.log", rollingInterval: RollingInterval.Day, outputTemplate: logOutputTemplate) .CreateLogger(); CreateHostBuilder(args).Build().Run(); } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .UseSerilog() .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }); }注意代码中输出日志的格式,日志分隔符使用 "||",这是LogDashboard组件的建议,当然你可以修改,详细配置见LogDashboard文档。
2.3 验证日志组件安装成功在Startup.cs中添加测试日志
public void ConfigureServices(IServiceCollection services) { Log.Information("ConfigureServices"); Log.Error("测试Serilog添加异常日志"); Log.Fatal("测试Serilog添加严重日志"); // .... }运行项目:
输出目录下产生日志文件:\LogDashboardDemo\bin\Debug\net6.0\Logs\Dotnet920210417.log
08:37:27.884 +08:00 || Information || || ConfigureServices || ||end 08:37:27.964 +08:00 || Error || || 测试Serilog添加异常日志 || ||end 08:37:27.965 +08:00 || Fatal || || 测试Serilog添加严重日志 || ||end 08:37:28.154 +08:00 || Information || || Configure || ||end 08:37:28.423 +08:00 || Information || Microsoft.Hosting.Lifetime || Now listening on: "http://localhost:5000" || ||end 08:37:28.427 +08:00 || Information || Microsoft.Hosting.Lifetime || Application started. Press Ctrl+C to shut down. || ||end 08:37:28.427 +08:00 || Information || Microsoft.Hosting.Lifetime || Hosting environment: "Development" || ||end 08:37:28.428 +08:00 || Information || Microsoft.Hosting.Lifetime || Content root path: "C:\Users\Administrator\Desktop\LogDashboardDemo" || ||end控制台输出:
好了,日志组件已经添加成功,进入下一步。
3. 添加 LogDashboard 3.1 Nuget安装 LogDashboard 包 Install-Package Serilog.AspNetCore 3.2 配置 LogDashboard这一步很简单,真的很简单,打开Startup.cs,添加如下代码:
public void ConfigureServices(IServiceCollection services) { services.AddLogDashboard(); // ... } public void Configure(IApplicationBuilder app, IWebHostEnvironment env) { app.UseLogDashboard(); // ... }这一步就完成了,使用 LogDashboard就是这么简单。
4. 可视化日志演示运行项目,浏览器地址栏输入::5000/logdashboard就是日志管理面板,直接录一个小视频演示下吧: