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. Visual Logのデモ

** この記事の始まり **

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\b in\Debug\n et 6.0\Logs\Dotnet 920210417.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. Visual Logのデモ

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