.NET_NLog

步骤

1. 添加依赖

①Microsoft.Extensions.DependencyInjection

②NLog.Extensions.Logging(或Microsoft.Extensions.Logging.___)

Tutorial · NLog/NLog Wiki · GitHub

2.添加nlog.config文件(默认名称, 可改为其他名称, 但需要另行配置)

文件的基础格式可从此处获取: Tutorial · NLog/NLog Wiki · GitHubNLog - Advanced and Structured Logging for Various .NET Platforms - Tutorial · NLog/NLog Wikiicon-default.png?t=N7T8https://github.com/NLog/NLog/wiki/Tutorial#configure-nlog-targets-for-output格式参考(关于config文件的说明在注释部分):

<?xml version="1.0" encoding="utf-8" ?>
<!-- XSD manual extracted from package NLog.Schema: https://www.nuget.org/packages/NLog.Schema-->
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      autoReload="true"
      internalLogFile="logs/console-example-internal.log"
      internalLogLevel="Info" >

	<!-- the targets to write to -->
	<targets>
		<!-- write logs to file -->
		<!-- archiveAboveSize: 日志文件的最大体积(字节数)|maxArchiveFiles: 日志文件的最大数量|maxArchiveDays: 日志文件的最大天数 -->
		<target xsi:type="File" name="logfile" fileName="logs/console-example.log"
				layout="${longdate}|${level}|${message} |${all-event-properties} ${exception:format=tostring}" />
		<target xsi:type="Console" name="logconsole"
				layout="${longdate}|${level}|${message} |${all-event-properties} ${exception:format=tostring}" />
	</targets>

	<!-- rules to map from logger name to target -->
	<rules><!-- 从上至下依次匹配 -->
		<!-- name: 匹配规则(类名)|minlevel: 最小日志输出等级|maxlevel: 最大日志输出等级|writeTo: 日志输出文件|final=true: 若匹配成功则不再向下匹配 -->
		<logger name="*" minlevel="Trace" writeTo="logfile,logconsole"/>
	</rules>
</nlog>

3.将nlog.config文件设置为"始终复制"或在项目设置页中将"Never"改为"Always"

示例

Program.cs

internal class Program
{
    static void Main(string[] args)
    {
        ServiceCollection services = new();

        services.AddLogging(logBuilder=> {
            //logBuilder.AddConsole();                    // Microsoft.Extensions.Logging
            //logBuilder.SetMinimumLevel(LogLevel.Debug); // Microsoft.Extensions.Logging
            logBuilder.AddNLog();
        });
        services.AddScoped<Example_1>();

        using ServiceProvider serviceProvider = services.BuildServiceProvider();
        Example_1 example_1 = serviceProvider.GetRequiredService<Example_1>();
        example_1.Start();
    }
}

Example_1.cs

internal class Example_1
{
    ILogger<Example_1> logger;
    public Example_1(ILogger<Example_1> logger)
    {
        this.logger = logger;
    }

    public void Start()
    {
        logger.LogDebug("运行中...");
        try
        {
            File.ReadAllText("A:\\text.txt");
            logger.LogDebug("文件读取成功");
        }
        catch (Exception e)
        {
            logger.LogError(e, "发生错误");
        }
        logger.LogDebug("结束");
    }
}

运行效果

### .NET 8 中 NLog 性能优化及配置最佳实践 #### 配置高性能的日志记录器 为了确保高效的日志记录,在配置文件中应合理设置过滤级别,避免不必要的低优先级日志占用资源。NLog 提供了多种方式来控制日志输出的频率和内容,从而减少 I/O 操作带来的开销。 ```xml <logger name="*" minlevel="Info" writeTo="logfile"/> ``` 通过上述 XML 片段可以定义只记录 Info 及以上级别的消息[^1]。 #### 启用异步写入机制 启用异步模式可显著提高应用程序响应速度并降低主线程阻塞的风险。这允许日志条目被收集在一个队列里,由后台工作者线程负责最终写出磁盘或其他目的地。 ```csharp targets.Add(new AsyncTargetWrapper(fileTarget, overflowAction: AsyncTargetWrapperOverflowAction.Discard)); ``` 此 C# 代码展示了如何创建一个包裹同步目标对象 `fileTarget` 的异步包装器实例,并指定当缓冲区满时采取丢弃策略以防止内存泄漏[^2]。 #### 减少字符串拼接消耗 频繁地构建复杂的字符串表达式会增加 CPU 和 GC 压力。因此推荐采用参数化的方式传递变量部分的数据给模板化的布局渲染器处理。 ```csharp _logger.Info("Processing request {RequestId} from user {UserId}", requestId, userId); ``` 上面的例子说明了利用插槽占位符代替直接连接字符串的做法,既提高了易读性又增强了性能表现[^3]。 #### 实施批量提交策略 如果应用场景允许,则可以在一定时间内累积多条日志项再一次性发送出去;这样做的好处是可以摊薄每次单独传输的成本,特别是在网络通信场景下尤为明显。 ```csharp var batchTarget = new BufferingWrapper(logFileTarget) { BatchSizeLimitBytes = 10 * 1024, FlushTimeoutMilliseconds = 5000 }; ``` 这里设置了最大缓存字节数为 10KB 并且超时时间为五秒钟作为触发条件之一。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值