.NET 6开发TodoList应用引入第三方日志库

 更新时间:2021年12月27日 10:51:07   作者:CODE4NOTHING  
这篇文章主要介绍了.NET 6开发TodoList应用引入第三方日志库,在我们项目开发的过程中,使用.NET 6自带的日志系统有时是不能满足实际需求的,比如有的时候我们需要将日志输出到第三方平台,更多详细内容请需要的小伙伴参考下面文章内容

1.需求

在我们项目开发的过程中,使用.NET 6自带的日志系统有时是不能满足实际需求的,比如有的时候我们需要将日志输出到第三方平台上,最典型的应用就是在各种云平台上,为了集中管理日志和查询日志,通常会选择对应平台的日志SDK进行集成。使用Serilog提供的多种Sink,可以实现将日志写入不同云平台或者是非云平台的日志存储中去,这是我们这篇文章讲要研究的内容。

2.目标

我们将为TodoList添加一个方便替换和扩展的日志策略,简单来说就是在与具体第三方打交道的Infrastructure项目中实际设置使用的日志服务,并在Api项目中进行依赖注入,方便在整个应用程序中无具体日志配置感知地使用日志服务。

3.原理和思路

查阅Serilog的官方文档和一些示例后确定,

我们要做的事情有这么几件:

  • 引入Serilog.AspNetCore包(很多文章或者教程里都让你根据需要使用的Sink去继续引入类似Serilog.Sink.File之类的包,但是实际上Serilog.AspNetCore包的依赖项里已经包含了File这个Sink,所以实际上没有必要再去添加一次);
  • 二是需要为Serilog的Logger对象提供一个LoggerConfiguration,可以以代码的方式进行配置,也可以通过加载.json文件的方式进行配置,看自己的需求和对配置热更新的有没有独特的要求决定;
  • 在程序启动构造WebApplicationBuilder对象的时候声明UseSerilog();
  • 在需要使用日志的地方注入ILogger<T>对象即可,我们一般是在构造函数里进行注入,当然也可以选择其他两种注入方式。

好了,了解了原理,接下来一步就是想一下我们要在哪里做这几件事。

第二篇文章中,我提到了Clean Architecture,里面有一条原则可以理解为:如果系统需要与外部(第三方)系统进行集成或交互,那么具体的集成工作应该放入Infrastructure层进行处理,而程序的其他部分只对外部服务进行抽象的使用。好处是今后如果需要替换第三方系统,比如原本日志是写到本地文件里,后来有了上云和日志集中化处理的需求,需要将日志服务对接到诸如Azure App Service Logging者AWS CloudWatch,那么我们只需要去修改(扩展)Infrastructure中进行日志具体配置的逻辑就可以了。虽然日志服务本身相对比较简单,还不能很好地体现这个优点,我们姑且遵循这个原则,将配置工作放到Infrastructure里面去。

4.实现

4.1日志配置实现

我们在TodoList.Infrastructure项目中新增一个文件夹,取名Log,在其中新建文件ConfigureLogProvider.cs,实现一个针对WebApplicationBuilder的扩展方法,为了演示在这里配置的扩展性,我多用了一个appsettings.json中的字段来控制配置过程,缺失的包需要安装一下。

using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
using Serilog;

namespace TodoList.Infrastructure.Log;

public static class ConfigureLogProvider
{
    public static void ConfigureLog(this WebApplicationBuilder builder)
    {
        if (builder.Configuration.GetValue<bool>("UseFileToLog"))
        {
            // 配置同时输出到控制台和文件,并且指定文件名和文件转储方式(形如log-20211219.txt格式),转储文件保留的天数为15天,以及日志格式
            // 配置Enrich.FromLogContext()的目的是为了从日志上下文中获取一些关键信息诸如用户ID或请求ID,我们的应用中暂时不使用这些。
            Serilog.Log.Logger = new LoggerConfiguration()
                .Enrich.FromLogContext()
                .WriteTo.Console()
                .WriteTo.File(
                    "logs/log-.txt",
                    outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj}{NewLine}{Exception}",
                    rollingInterval: RollingInterval.Day,
                    retainedFileCountLimit: 15)
                .CreateLogger();
        }
        else
        {
            // 仅配置控制台日志
            Serilog.Log.Logger = new LoggerConfiguration()
                .Enrich.FromLogContext()
                .WriteTo.Console()
                .CreateLogger();
        }

        // 使用Serilog作为日志框架,注意这里和.NET 5及之前的版本写法是不太一样的。
        builder.Host.UseSerilog();
    }
}

4.2主程序配置

在TodoList.Api项目的Main.cs中,使用该扩展方法:

using TodoList.Infrastructure.Log;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
// 配置日志
builder.ConfigureLog();

builder.Services.AddControllers();
// ... 省略以下


并向appsettings.Development.json文件中添加用于测试的配置项:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "UseFileToLog": true
}


4.3注入使用

嗯……我把第二篇文章结束时删除的示例WeatherForecastController.csWeatherForecast.cs又加回来了。Controller中已经注入了ILogger<WeatherForecastController>,我们就在示例的接口里试一下:

[HttpGet(Name = "GetWeatherForecast")]
public IEnumerable<WeatherForecast> Get()
{
    // 记录日志
    _logger.LogInformation($"maybe this log is provided by Serilog...");

    return Enumerable.Range(1, 5).Select(index => new WeatherForecast
    {
        Date = DateTime.Now.AddDays(index),
        TemperatureC = Random.Shared.Next(-20, 55),
        Summary = Summaries[Random.Shared.Next(Summaries.Length)]
    })
    .ToArray();
}


好了,到此为止我们就可以验证一下了。

5.验证

运行TodoList.Api项目,和第二篇文章一样,我们使用Hoppscotch测试示例接口,观察控制台和日志文件的输出内容和格式:

控制台输出

文件输出

总结:

在这篇文章中,我向大家展示了如何在.NET 6 Web API项目中添加第三方日志服务框架,下一篇文章将会引入数据存储服务。

到此这篇关于.NET 6开发TodoList应用引入第三方日志库的文章就介绍到这了,更多相关使用.NET 6 TodoList引入第三方日志库内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • ASP.NET Core全面扫盲贴

    ASP.NET Core全面扫盲贴

    本篇文章主要介绍了.NET Core,.NET Core是一个开源通用的开发框架,支持跨平台,即支持在Window,macOS,Linux等系统上的开发和部署有兴趣的可以了解一下。
    2017-03-03
  • .NET 单点登录解决方案

    .NET 单点登录解决方案

    这里指的单点,泛指在WEB服务端,一个账户同一时刻只能存在一个票据!怎么使同一个用户,在同一时间内只允许登录一次,下面将为大家详细介绍下
    2013-10-10
  • ASP.NET实现文件上传功能

    ASP.NET实现文件上传功能

    这篇文章主要为大家详细介绍了ASP.NET实现文件上传功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-07-07
  • asp.net 临时数据保存实现代码

    asp.net 临时数据保存实现代码

    在一个程序运行的时候往往我们会回到上一个页面,或者我们会需要当时留在这个页面的临时数据,例如,我们用百度搜索“脚本”之后我们会看到很多那啥我就不再说了啊!然后我们返回本来页面在文本框内会有“脚本”的字样,我们一下代码段就是实现这个功能
    2012-04-04
  • asp.net Page.EnableEventValidation 属性验证服务器控件的回发和回调事件出现的错误

    asp.net Page.EnableEventValidation 属性验证服务器控件的回发和回调事件出现的错误

    Page.EnableEventValidation 属性验证服务器控件的回发和回调事件出现的错误前两天用jQuery做了一个包含DropDownList联动的页面,数据通过Ajax请求得到的。
    2010-10-10
  • 教你Asp.net下使用mysql数据库的步骤

    教你Asp.net下使用mysql数据库的步骤

    近日,在项目中遇到了麻烦,客户非要求使用mysql数据库,对于我从来么有使用过的人来说,很是头疼,最后还是硬着头皮弄好了。期间也遇到了各种各样的问题,现在把他整理在此,希望对那些和我一样从来没有使用过的人,能快速入手
    2012-05-05
  • Repeater控件动态变更列(Header,Item和Foot)信息实现思路

    Repeater控件动态变更列(Header,Item和Foot)信息实现思路

    需求开发一个小报表,显示最近五个月的summary的数量统计,报表会随月份的变化而变化,接下来为大家详细介绍下实现方法,感兴趣的各位不要错过了哈
    2013-03-03
  • asp.net 在DNN模块开发中遇到的resx怪问题

    asp.net 在DNN模块开发中遇到的resx怪问题

    最近我遇到2个小问题,在此记录一下。这是我发的帖子

    2008-11-11
  • asp.net中一个linq分页实现代码

    asp.net中一个linq分页实现代码

    asp.net中一个linq分页实现代码,需要的朋友可以参考下。
    2011-12-12
  • WPF使用AForge调用摄像头

    WPF使用AForge调用摄像头

    这篇文章介绍了WPF使用AForge调用摄像头的方法,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-01-01

最新评论