• 欢迎光临~
> > .net core 序列日志Serilog

.net core 序列日志Serilog

开发技术 开发技术 2022-08-31 次浏览

Serilog 是一个用于 .NET 应用程序的诊断日志库。它易于设置，具有干净的 API，并且可以在所有最新的 .NET 平台上运行。尽管即使在最简单的应用程序中它也很有用，但 Serilog 对结构化日志记录的支持在检测复杂、分布式和异步应用程序和系统时大放异彩。

.net core 序列日志Serilog

与 .NET 的许多其他库一样，Serilog 为文件、控制台和许多其他输出提供诊断日志记录。

var log = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.File("log.txt")
    .CreateLogger();

log.Information("Hello, Serilog!");

与其他日志库不同，Serilog 是从头开始构建的，用于记录结构化事件数据。

var position = new { Latitude = 25, Longitude = 134 };
var elapsedMs = 34;

log.Information("Processed {@Position} in {Elapsed} ms", position, elapsedMs);

Serilog 使用消息模板，这是一种简单的 DSL，它使用命名参数和位置参数扩展 .NET 格式字符串。Serilog 不会立即将事件格式化为文本，而是捕获与每个命名参数关联的值。

上面的示例在日志事件中记录了两个属性Position和。前面Elapsed的操作符告诉 Serilog序列化传入的对象，而不是使用. Serilog 对结构化事件数据的深入而丰富的支持开辟了使用传统记录器时不可用的大量诊断可能性。@PositionToString()

例如，呈现为JSON 格式的这些属性会出现在时间戳、级别和消息旁边，例如：

{"Position": {"Latitude": 25, "Longitude": 134}, "Elapsed": 34}

能够记录结构化事件数据的后端使日志搜索和分析成为可能，而无需日志解析或正则表达式。

支持结构化数据并不意味着放弃文本：当 Serilog 将事件写入文件或控制台时，模板和属性会呈现为友好的人类可读文本，就像传统的日志库会产生一样：

09:14:22 [INF] Processed {"Latitude": 25, "Longitude": 134} in 34 ms.

从 Serilog 1.x 升级？查看2.0 升级指南和发行说明。

特征

  • 社区支持并积极开发
  • 基于格式的日志 API，具有熟悉的级别，如Debug、Information、Warning、Error等
  • 可发现的 C# 配置语法和可选的XML或JSON配置支持
  • 启用时高效，关闭日志记录级别时开销极低
  • 一流的 .NET Core 支持，包括与 ASP.NET Core 的丰富集成
  • 支持全面的接收器，包括文件、控制台、本地和基于云的日志服务器、数据库和消息队列
  • 使用上下文信息对日志事件进行复杂的丰富，包括范围 ( LogContext) 属性、线程和进程标识符以及特定于域的相关 ID，例如HttpRequestId
  • 零共享状态Logger对象，具有可选的全局静态Log类
  • LogEvent格式不可知的日志管道，可以以纯文本、JSON、内存对象（包括Rx 管道）和其他格式发出事件

入门

Serilog 是从 NuGet 安装的。要查看日志事件，还需要安装一个或多个接收器，这里我们将使用漂亮打印控制台接收器和滚动文件集：

dotnet add package Serilog
dotnet add package Serilog.Sinks.Console
dotnet add package Serilog.Sinks.File

 

 

设置 Serilog 的最简单方法是使用静态Log类。ALoggerConfiguration用于创建和分配默认记录器。

using Serilog;

public class Program
{
    public static void Main()
    {
        Log.Logger = new LoggerConfiguration()
            .MinimumLevel.Information()
            .WriteTo.Console()
            .WriteTo.File("log.txt",
                rollingInterval: RollingInterval.Day,
                rollOnFileSizeLimit: true)
            .CreateLogger();
            
        Log.Information("Hello, Serilog!");
        
        Log.CloseAndFlush();
    }
}

如被动接受设备数据：

var deviceValue = $"dmv:{dmon.Uid},Value:{dmon.Value},Status:{dmon.Status},BoxNo:{dmon.BoxNo},Name:{dmon.Name},BoxId:{dmon.BoxId},GroupName:{dmon.GroupName},Timestamp:{dmon.Timestamp}";
Log.Information(deviceValue);

 

.net core 序列日志Serilog

 

 

 

程序员灯塔
转载请注明原文链接：.net core 序列日志Serilog
喜欢 (0)