Serilog.Enrichers.Thread 4.0.0

Serilog.Enrichers.Thread

使用当前线程的属性丰富 Serilog 事件。

入门指南

从 NuGet 安装包

Install-Package Serilog.Enrichers.Thread

在您的日志配置中，应用Enrich.WithThreadId()和Enrich.WithThreadName()

Log.Logger = new LoggerConfiguration()
    .Enrich.WithThreadId()
    .Enrich.WithThreadName()
    .CreateLogger();

许多输出通道简单地包含所有属性而无需任何其他操作，因此线程 ID 将自动记录。但是，某些输出通道，如文件和控制台输出通道，使用输出模板，并且新的ThreadId可能不会自动输出到您的输出通道。在这种情况下，为了使ThreadId或ThreadName显示在日志中，您需要创建或修改您的输出模板。

w.File(...., outputTemplate:
  "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} {Properties}{NewLine}{Exception}")

在这里，{Properties}不仅可以包括ThreadId和ThreadName，还可以包括应用的其他任何丰富信息。或者，如果您只想添加线程 ID 丰富值，可以使用{ThreadId}，如果想只添加线程名称丰富值，可以使用{ThreadName}。

以下是一个示例，它还使用了Serilogs.Sinks.Async Nuget软件包

            Thread.CurrentThread.Name = "MyWorker";
              
            var logger = Log.Logger = new LoggerConfiguration()
                 .MinimumLevel.Debug()
                 .WriteTo.Console(restrictedToMinimumLevel:Serilog.Events.LogEventLevel.Information)
                 .WriteTo.Async(w=>w.File("..\\..\\..\\..\\logs\\SerilogLogFile.json", rollingInterval: RollingInterval.Day, outputTemplate: "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {Message:lj} <{ThreadId}><{ThreadName}>{NewLine}{Exception}"))
                 .Enrich.WithThreadId()
                 .CreateLogger();

这将生成如下所示的日志文件输出

2018-04-06 13:12:45.684 +02:00 [ERR] The file file_name.svg does not exist <4><MyWorker>

其中，<4>是一个示例线程 ID，而 <MyWorker> 是一个示例线程名称。

要使用丰富器，首先安装NuGet软件包

Install-Package Serilog.Enrichers.Thread

注意：仅当{ThreadName}属性不为空时，才会附加此属性。否则，它将被省略。如果您想始终获取此属性，可以使用以下方式

using Serilog.Enrichers;

Log.Logger = new LoggerConfiguration()
    .Enrich.WithThreadName()
    .Enrich.WithProperty(ThreadNameEnricher.ThreadNamePropertyName, "MyDefault")
    .CreateLogger();

丰富顺序很重要。否则，“MyDefault”始终会获胜。

版权©2016 Serilog贡献者 - 在Apache许可协议，版本2.0下提供。