🐳简介
ILogger日志服务是.NET平台中的一个内置服务,主要用于应用程序的日志记录。它提供了灵活的日志记录机制,允许开发者在应用程序中轻松地添加日志功能。以下是其主要特点和组件:
- ILogger接口:这是ILogger日志服务的核心接口,提供了实际执行日志记录操作的方法。通过这个接口,可以写入不同级别的日志项,如信息、警告、错误等。
- ILoggerProvider:负责创建ILogger对象的组件。它定义了如何获取或创建日志记录器实例的逻辑。
- ILoggerFactory:通过ILoggerProvider对象创建ILogger对象。它是ILoggerProvider实例的工厂,用于生成具体的ILogger实例。
- 依赖注入:在.NET应用程序中,ILogger可以通过依赖注入的方式注入到任何需要记录日志的类中。这通常是在类的构造函数中完成的,确保了日志服务的可用性和灵活性。
- 日志级别:ILogger允许开发者根据不同的日志级别进行记录,如Debug、Information、Warning、Error和Critical等,这有助于更细致地控制日志记录的内容和目的。
- 扩展性:ILogger日志服务支持扩展,开发者可以根据需要自定义日志提供程序,或者使用第三方库来增强日志功能。
🐳ASP .Net Core 中使用日志服务
在ASP.NET项目中,并不需要我们自己手动注册日志服务。
框架基于Microsoft.Extensions.Logging
命名空间下的ILogger
接口和相关的服务类库已经帮你做好了这些工作,
因此我们可以直接在项目中通过构造函数的方式注入我们的日志服务
public class HelloService : IHelloService
{
private readonly ILogger<IHelloService> _logger;
public HelloService(ILogger<IHelloService> logger)
{
_logger = logger;
}
}
注入完成后就可以在方法中使用_logger来打印日志了
_logger.LogTrace("跟踪日志");
_logger.LogDebug("调试日志");
_logger.LogInformation("信息");
_logger.LogWarning("警告日志");
_logger.LogError("错误日志");
_logger.LogCritical("致命日志");
以下是这些日志级别的简要介绍:
- LogTrace:
- 用途:用于跟踪应用程序中的最详细的信息。通常,这些日志记录的是对程序内部执行的详细跟踪,例如方法进入和退出、变量值的变化等。
- 使用场景:在开发和调试过程中非常有用,但通常在生产环境中关闭,因为会产生大量的日志输出。
- LogDebug:
- 用途:用于调试应用程序。这些日志通常包含有助于开发人员理解和解决问题的详细信息。
- 使用场景:在开发和测试阶段使用,但在生产环境中通常关闭,除非有特定的调试需求。
- LogInformation:
- 用途:记录应用程序的常规信息性消息。这些消息通常描述了应用程序的正常运行或一些重要的状态更改。
- 使用场景:在生产环境中常用,用于监控应用程序的常规运行状态。
- LogWarning:
- 用途:记录可能表明潜在问题的消息,但这些问题通常不会导致应用程序立即失败。
- 使用场景:在生产环境中使用,以提醒开发人员或管理员注意可能需要采取某些措施的情况。
- LogError:
- 用途:记录应用程序的错误情况,这些错误通常会导致应用程序的部分功能无法正常工作。
- 使用场景:在生产环境中使用,用于诊断和解决应用程序中的问题。
- LogCritical:
- 用途:记录严重的错误,这些错误可能导致应用程序完全失败或不稳定。
- 使用场景:在生产环境中使用,通常需要立即采取行动以恢复应用程序的稳定性和可用性。
运行项目,在控制台中看到,我们只打印了等级大于Information的日志
并且我们还发现,日志中夹着一些系统产生的Microsoft.AspNetCore开头的日志,这是因为我们在配置文件中,将Default的日子级别范围设置为Ingormation了,而 Microsoft.AspNetCore:这是针对以Microsoft.AspNetCore
开头的所有特定分类的日志记录设置。这样的分类通常与ASP.NET Core框架组件相关,比如路由、身份验证等
🍀我们可以通过另一种注入方式来设置日志的分类
public class HelloService : IHelloService
{
private readonly ILogger _logger;
public HelloService(ILoggerFactory loggerFactory)
{
_logger = loggerFactory.CreateLogger("Microsoft.AspNetCore");
}
}
如我们将分类设置为配置文件中设置为Trace的 Microsoft.AspNetCore 分类,届时运行项目将会打印所有的日志
同时我们还可以通过
_logger.LogTrace(new EventId(1001,"Action"),"跟踪日志");
这种打印日志方式来设置我们日志的ID ,如下图