0

0

.NET如何使用log4net或Serilog记录日志

幻夢星雲

幻夢星雲

发布时间:2025-11-01 22:30:02

|

857人浏览过

|

来源于php中文网

原创

log4net和Serilog是.NET中常用日志框架,前者基于XML配置适用于传统项目,后者支持结构化日志更适配现代应用。1. log4net需安装NuGet包、添加log4net.config并加载配置,在代码中通过LogManager获取ILogger实例记录日志;2. Serilog需安装Serilog及其Sinks包,在Program.cs中配置WriteTo.File等输出方式,并集成到ASP.NET Core DI系统,通过注入ILogger<T>使用,支持结构化日志如“用户{UserId}登录”。两者均需注意配置文件路径与初始化时机以确保日志正确输出。

.net如何使用log4net或serilog记录日志

在 .NET 项目中,日志记录是排查问题、监控运行状态的重要手段。log4net 和 Serilog 是两个广泛使用的第三方日志框架,各有特点,使用方式也略有不同。下面分别介绍如何在 .NET(包括 .NET Core/.NET 5+)中配置和使用它们。

使用 log4net 记录日志

log4net 是 Apache log4j 的 .NET 移植版本,基于 XML 配置,灵活但稍显复杂。

1. 安装 NuGet 包

ColorMagic
ColorMagic

AI调色板生成工具

下载

在项目中安装 log4net:

  • 通过 NuGet 包管理器搜索并安装 log4net
  • 或使用命令行:

Install-Package log4net

2. 添加配置文件 log4net.config

在项目根目录添加一个名为 log4net.config 的 XML 文件,内容如下:

<?xml version="1.0" encoding="utf-8"?>
<log4net>
  <appender name="FileAppender" type="log4net.Appender.FileAppender">
    <file value="logs\log.txt" />
    <appendToFile value="true" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
    </layout>
  </appender>
  <root>
    <level value="DEBUG" />
    <appender-ref ref="FileAppender" />
  </root>
</log4net>

确保该文件的“复制到输出目录”设置为“始终复制”。

3. 在 AssemblyInfo.cs 或程序启动时加载配置

AssemblyInfo.cs 中添加特性(推荐用于传统 .NET Framework):

[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config", Watch = true)]

对于 .NET Core/.NET 5+,建议在 Program.csStartup.cs 中手动加载:

log4net.Config.XmlConfigurator.Configure(new FileInfo("log4net.config"));

4. 在代码中使用

在需要记录日志的类中创建 logger 实例:

private static readonly ILog log = LogManager.GetLogger(typeof(YourClass));
<p>log.Debug("这是一条调试信息");
log.Info("这是一条普通信息");
log.Error("发生错误", exception);</p>

使用 Serilog 记录日志

Serilog 是现代 .NET 应用中更受欢迎的日志库,支持结构化日志,配置简洁,与 .NET Core 内建日志系统集成良好。

1. 安装 NuGet 包

安装核心包和所需的接收器(sink):

  • Serilog:核心库
  • Serilog.Sinks.File:写入文件
  • Serilog.AspNetCore:与 ASP.NET Core 集成

命令行示例:

Install-Package Serilog
Install-Package Serilog.Sinks.File
Install-Package Serilog.AspNetCore

2. 配置 Serilog

Program.cs 中配置日志(以 .NET 6+ 为例):

using Serilog;
<p>var builder = WebApplication.CreateBuilder(args);</p><p>// 配置 Serilog
builder.Host.UseSerilog((context, services, configuration) => configuration
.WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day)
.WriteTo.Console()
.Enrich.FromLogContext()
.ReadFrom.Configuration(context.Configuration));</p><p>var app = builder.Build();</p>

也可以从 appsettings.json 读取配置:

"Serilog": {
  "MinimumLevel": "Information",
  "WriteTo": [
    { "Name": "Console" },
    {
      "Name": "File",
      "Args": {
        "path": "logs/log-.txt",
        "rollingInterval": "Day"
      }
    }
  ]
}

3. 使用 ILogger 接口记录日志

Serilog 会自动集成到 ASP.NET Core 的依赖注入系统中,控制器或服务中直接注入 ILogger<T>

public class HomeController : Controller
{
    private readonly ILogger<HomeController> _logger;
<pre class='brush:php;toolbar:false;'>public HomeController(ILogger<HomeController> logger)
{
    _logger = logger;
}

public IActionResult Index()
{
    _logger.LogInformation("访问了首页");
    _logger.LogError("模拟一个错误", new Exception("测试异常"));
    return View();
}

}

4. 支持结构化日志

Serilog 的优势之一是支持结构化日志,例如:

_logger.LogInformation("用户 {UserId} 在 {LoginTime} 登录", userId, DateTime.Now);

这些属性可以被日志分析工具(如 Seq、Elasticsearch)解析和查询。

基本上就这些。log4net 更适合已有老项目迁移,而 Serilog 更适合新项目,尤其是需要结构化日志和云原生部署的场景。选择哪个取决于团队习惯和运维需求。两者都能有效提升应用可观测性。不复杂但容易忽略的是配置文件路径和初始化时机,务必确认日志能正确输出。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

456

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

335

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1948

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1168

2024.11.28

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1925

2023.10.19

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 10.1万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号