asp.net core可視化日誌組件使用

可視化日誌組件：logdashboard：

前言

今天站长推荐一款日志可视化组件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能极大提高你平时工作中的问题排查速度。

步驟：

1. 創建一個 asp.net core web api 項目
2. 添加Serilog日志组件
3. 添加LogDashboard
4. 可視化日誌演示

本文實戰開始

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 LogDashboard

3.2配置 logdashboard

這一步很簡單，真的很簡單，打開startup.cs，添加如下代碼：

public void ConfigureServices(IServiceCollection services)
{
  services.AddLogDashboard();
  // ...
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
  app.UseLogDashboard();
  // ...
}

这一步就完成了，使用 LogDashboard就是这么简单。

4. 可視化日誌演示

运行项目，浏览器地址栏输入：http://localhost:5000/logdashboard就是日志管理面板，直接录一个小视频演示下吧：