首页 > 其他分享 >.net 温故知新:【9】.NET日志记录 ILogger使用和原理

.net 温故知新:【9】.NET日志记录 ILogger使用和原理

时间:2022-11-11 10:04:11浏览次数:64  
标签:Logging 记录 温故知新 程序 Microsoft Extensions ILogger net 日志

日志

日志作为我们程序记录的“黑匣子”不论什么系统都应该使用到的,比如我们经常使用的log4net就是第三方日志记录提供程序。.NET 支持使用各种内置和第三方日志记录提供程序的日志记录 API,这篇文章主要介绍的是内置提供程序和API的使用并看下他们是如何实现的。

日志优先级

如果你使用过log4net的话那么你对这个优先级应该不陌生,在日志记录过程中我们可以对记录的日志信息进行优先级划分,根据优先级我们可以配置只记录哪些优先级别的日志,同时日志信息也会标记这条信息的优先级。在我们查找问题的时候更好的筛选和定位。

.net 的日志优先级LogLevel 分为:

Trace = 0、Debug = 1、Information = 2、Warning = 3、Error = 4、Critical = 5 和 None = 6。

日志级别:

Trace<Debug<Information<Warning<Error<Critical<None

使用控制台输出日志

现在我们来感受下如何用内置提供程序记录日志,使用的是.NET 6 控制台程序进行示例。

  • 添加Install-Package Microsoft.Extensions.Logging 日志基础包
    Install-Package Microsoft.Extensions.Logging

  • 添加Microsoft.Extensions.Logging.Console 控制台输出日志提供程序包
    Install-Package Microsoft.Extensions.Logging.Console

  • DI注入

ServiceCollection services = new ServiceCollection();
//添加日志到容器
services.AddLogging(loggingBuilder =>
    {
        loggingBuilder.AddConsole();
    }
    //回调,或者是叫委托方法,调用AddConsole()添加控制台输入提供程序Provider。
    //AddConsole方法就是在Microsoft.Extensions.Logging.Console包中LoggingBuilder的扩展方法。
);

可以通过容器Provider直接获取日志对象然后调用写日志方法。

image

当然更常用的是在其它类中通过构造函数注入,使用 DI 中的 ILogger 对象(TCategoryName 类别字符串是任意的,但约定将使用类名称,在日志中能知道是哪个类输出的)。

    public class TestLog
    {
        private readonly ILogger _logger;
        public TestLog(ILogger<TestLog> logger)
        {
            _logger = logger;
        }

        public void Test()
        {
            _logger.LogDebug("测试");
        }
    }

上面的控制台打印我们注意到没有输出“调试日志”,“信息日志”,这是因为未设置默认日志级别,则默认的日志级别值为 Information。所以输出程序只输出>=Information的日志。

通过代码设置:
image

日志设计的原理

如下我大概画了一个逻辑图,对于如何实现日志进行了一个梳理,代码部分未.net源码截取。

image

通过如上的流程我们知道其实日志对象是由LoggerFactory类创建的,所以我们不使用注入的方式也可以直接获取日志对象并写日志。

            var loggerFactory = LoggerFactory.Create(builder =>
            {
                builder.AddConsole();
                builder.SetMinimumLevel(LogLevel.Debug);
            });

            ILogger loger = loggerFactory.CreateLogger<Program>();

image

提供程序

目前内置的日志记录提供程序:

  • Console:Console 提供程序将输出记录到控制台。
  • Debug:Debug 提供程序使用 System.Diagnostics.Debug 类写入日志输出。
  • EventSource:EventSource 提供程序写入名称为 Microsoft-Extensions-Logging 的跨平台事件源。
  • EventLog:EventLog 提供程序将日志输出发送到 Windows 事件日志。
    比如我们在测试里面添加一个EventLog将日志写入Windows 事件日志:
    安装提供程序包:Install-Package Microsoft.Extensions.Logging.EventLog
    image

内置程序未提供对日志记录到文件,所以我们可以使用一些三方包,当然也可以自己开发。

image
查看地址:三方包

在上一篇 .NET 配置 中我们也见到提供程序这个概念,或者是说这种设计结构,其实.net中很多地方都用到提供程序的思维,然可以灵活扩展。

标签:Logging,记录,温故知新,程序,Microsoft,Extensions,ILogger,net,日志
From: https://www.cnblogs.com/SunSpring/p/16875968.html

相关文章

  • ASP.NET Core教程-Configuration(配置)-配置托管模型
    更新记录转载请注明出处:2022年11月11日发布。2022年11月8日从笔记迁移到博客。配置托管模型ASP.NETCore应用程序可以托管在进程内(InProcss)和进程外(OutOfProcs......
  • Visual Studio 2022 升级 WorkloadManifest.json冲突,导致.NET 6项目无法加载
    .NET7的发布,升级VisualStudio2022的17.4版本,然后无法打开所有解决方案。提示信息如下异常:SDK解析程序失败:"尝试解析SDK"Microsoft.NET.Sdk"时,SDK解析程序”Microsoft.D......
  • Kubernetes服务发现-Service
    1、Service概念Service是一组pod服务的抽象,相当于一组pod的LoadBalance,负责将请求分发给对应的pod。一组Pod可以被Service访问到,通过LabelSelector。缺点Ser......
  • ASP.NET Core项目创建及基本功能开发
    以MVC结构为例,ASP.NETCore中的MVC跟ASP.NETMVC几乎没有区别。也是依次创建控制器、生成视图。Controller代码:publicIActionResultIndex(){{......
  • NET6介绍及环境准备
    1..NET6介绍2021年11月8号午夜,.NET6+VS2022+C#10正式发布里程碑式的更新,新工具新平台新语言;横空出世。号称迄今为止最快的.NET6.NET6是LTS版本,微软宣称的长期......
  • 第1章 C#和.NET Framework简介
    1.1面向对象封装、继承和多态。类和接口函数成员:属性、方法和事件委托、纯函数模式(匿名函数、Lambda表达式)1.2类型安全性C#是类型安全的语言,也是强类型语言。(1)类......
  • IIS7中asp.net执行cmd命令提示:拒绝访问。安全狗-》安全防护-》去掉勾选“进程行为控
    研究了一下午,怎么也没想到这里有个坑。。。安全狗-》安全防护-》去掉勾选“进程行为控制”     无法执行CMD的解决办法: ......
  • PROFINET 设备如何和西门子PLC通讯
    1、准备IO模块:耦合器BL200PN、数字量输出模块M2082、数字量输入M1081、模拟量输入模块M3401、模拟量输出M4043。模块的组装、接线。2、BL200PN、S7-200SMART、PC要......
  • .NET性能优化-是时候换个序列化协议了
    计算机单机性能一直受到摩尔定律的约束,随着移动互联网的兴趣,单机性能不足的瓶颈越来越明显,制约着整个行业的发展。不过我们虽然不能无止境的纵向扩容系统,但是我们可以分布......
  • 如何在.NET程序崩溃时自动创建Dump?
    今天在浏览张队转载文章的留言时,遇到一个读者问了这样的问题,如下图所示:首先能明确的一点是"程序崩溃退出了是不能用常规的方式dump的",因为整个进程树都已经退出。现场已......