Serilog.Extensions.Hosting 8.0.0

Serilog.Extensions.Hosting

Serilog 为 Microsoft.Extensions.Hosting 提供日志功能。这个软件包通过 Serilog 路由框架日志消息，使您可以使用与您的应用程序事件相同的 Serilog 接收器获取关于框架内部操作的信息。

ASP.NET Core 应用程序应考虑 使用 Serilog.AspNetCore 代替，它包含了这个包以及其他 ASP.NET Core 特定功能。

说明

首先，将 Serilog.Extensions.Hosting 的 NuGet 包 安装到您的应用中。您需要一个方法来查看日志消息 - Serilog.Sinks.Console 将这些消息写入控制台；在 NuGet 上有许多其他可用的接收器。

dotnet add package Serilog.Extensions.Hosting
dotnet add package Serilog.Sinks.Console

接下来，在您的应用程序的 Program.cs 文件中，首先配置 Serilog。一个 try/catch 块将确保任何配置问题都得到恰当的记录

public class Program
{
    public static int Main(string[] args)
    {
        Log.Logger = new LoggerConfiguration()
            .MinimumLevel.Debug()
            .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
            .Enrich.FromLogContext()
            .WriteTo.Console()
            .CreateLogger();

        try
        {
            Log.Information("Starting host");
            BuildHost(args).Run();
            return 0;
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Host terminated unexpectedly");
            return 1;
        }
        finally
        {
            Log.CloseAndFlush();
        }
    }

然后，将 UseSerilog() 添加到在 BuildHost() 中的主机生成器。

    public static IHost BuildHost(string[] args) =>
        new HostBuilder()
            .ConfigureServices(services => services.AddSingleton<IHostedService, PrintTimeService>())
            .UseSerilog() // <- Add this line
            .Build();
}

最后，清理剩余的 "Logging" 部分，从 appsettings.json 文件中删除（如有需要，可以替换为如 在这里所示 的 Serilog 配置）

就这样！您将看到像这样的日志输出

[22:10:39 INF] Getting the motors running...
[22:10:39 INF] The current time is: 12/05/2018 10:10:39 +00:00

包含更完整示例的 appsettings.json 配置可以在 此处的示例项目中找到。

使用软件包

安装并配置好 Serilog.Extensions.Hosting 后，您可以直接通过 Serilog 或由 .NET 注入的任何 ILogger 接口写入日志消息。所有记录器都将使用相同的底层实现、级别和目标。

提示：将 Microsoft 的最小级别更改为 Warning

内联初始化

您还可以像下面这样使用委托配置 Serilog

    // dotnet add package Serilog.Settings.Configuration
    .UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
        .ReadFrom.Configuration(hostingContext.Configuration)
        .Enrich.FromLogContext()
        .WriteTo.Console())

这种方法的优点是使 hostingContext 的 Configuration 对象可用于记录器配置，但代价是会忽略程序启动早期抛出的 Exception

如果使用此方法，则 Log.Logger 将隐式分配，并在应用程序关闭时关闭。

版本管理

此软件包跟踪其对 Microsoft.Extensions.Hosting 依赖项的版本控制和目标框架支持。