Serilog.Extensions.Hosting 8.0.0-dev-00145

Serilog.Extensions.Hosting Build status NuGet Version

Serilog logging for Microsoft.Extensions.Hosting. This package routes framework log messages through Serilog, so you can get information about the framework's internal operations written to the same Serilog sinks as your application events.

Versioning: This package tracks the versioning and target framework support of its Microsoft.Extensions.Hosting dependency. Most users should choose the version of Serilog.Extensions.Hosting that matches their application's target framework. I.e. if you're targeting .NET 7.x, choose a 7.x version of Serilog.Extensions.Hosting. If you're targeting .NET 8.x, choose an 8.x Serilog.Extensions.Hosting version, and so on.

Instructions

First, install the Serilog.Extensions.Hosting NuGet package into your app. You will need a way to view the log messages - Serilog.Sinks.Console writes these to the console; there are many more sinks available on NuGet.

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

Next, in your application's Program.cs file, configure Serilog first. A try/catch block will ensure any configuration issues are appropriately logged. Call AddSerilog() on the host application builder:

using Serilog;

Log.Logger = new LoggerConfiguration()
    .Enrich.FromLogContext()
    .WriteTo.Console()
    .CreateLogger();

try
{
    Log.Information("Starting host");

    var builder = Host.CreateApplicationBuilder(args);
    builder.Services.AddHostedService<PrintTimeService>();
    builder.Services.AddSerilog();

    var app = builder.Build();
    
    await app.RunAsync();
    return 0;
}
catch (Exception ex)
{
    Log.Fatal(ex, "Host terminated unexpectedly");
    return 1;
}
finally
{
    await Log.CloseAndFlushAsync();
}

Finally, clean up by removing the remaining "Logging" section from appsettings.json files (this can be replaced with Serilog configuration as shown in this example, if required)

That's it! You will see log output like:

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

A more complete example, showing appsettings.json configuration, can be found in the sample project here.

Using the package

With Serilog.Extensions.Hosting installed and configured, you can write log messages directly through Serilog or any ILogger interface injected by .NET. All loggers will use the same underlying implementation, levels, and destinations.

Tip: change the minimum level for Microsoft to Warning

Inline initialization

You can alternatively configure Serilog using a delegate as shown below:

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

This has the advantage of making the hostingContext's Configuration object available for configuration of the logger, but at the expense of ignoring Exceptions raised earlier in program startup.

If this method is used, Log.Logger is assigned implicitly, and closed when the app is shut down.

Showing the top 20 packages that depend on Serilog.Extensions.Hosting.

Packages Downloads
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 1,690
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 822
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 116
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 24
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 23
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 22
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 21
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 20
Serilog.AspNetCore
Serilog support for ASP.NET Core logging
 19

.NET Framework 4.6.2

.NET Standard 2.0

.NET 8.0

.NET 7.0

.NET 6.0

Version Downloads Last updated
9.0.0 2 12/13/2024
9.0.0-dev-02303 1 12/13/2024
9.0.0-dev-02301 5 12/01/2024
8.0.0 130 11/22/2023
8.0.0-dev-00145 17 04/27/2024
8.0.0-dev-00143 16 04/12/2024
8.0.0-dev-00140 17 03/20/2024
8.0.0-dev-00137 21 11/24/2023
7.0.0 30 06/06/2023
7.0.0-dev-00131 27 06/06/2023
7.0.0-dev-00129 28 06/06/2023
7.0.0-dev-00126 30 06/06/2023
5.1.0-dev-00123 26 06/06/2023
5.0.1 817 05/08/2023
5.0.1-dev-00113 26 06/06/2023
5.0.0 25 06/06/2023
5.0.0-dev-00108 23 06/06/2023
5.0.0-dev-00095 26 06/06/2023
5.0.0-dev-00094 27 06/06/2023
5.0.0-dev-00093 22 06/06/2023
4.2.1-dev-00092 23 06/06/2023
4.2.0 1,317 11/18/2021
4.2.0-dev-00079 26 06/06/2023
4.1.2 406 04/16/2021
4.1.2-dev-00062 25 06/06/2023
4.1.1 23 06/06/2023
4.1.1-dev-00058 27 06/06/2023
4.1.0 28 06/06/2023
4.1.0-dev-00054 23 06/06/2023
4.0.0 26 06/06/2023
4.0.0-dev-00051 28 06/06/2023
4.0.0-dev-00050 22 06/06/2023
3.1.0 27 06/06/2023
3.1.0-dev-00041 25 06/06/2023
3.1.0-dev-00037 26 06/06/2023
3.1.0-dev-00035 27 06/06/2023
3.0.0 23 06/06/2023
3.0.0-dev-00024 26 06/06/2023
3.0.0-dev-00019 28 06/06/2023
3.0.0-dev-00016 26 06/06/2023
3.0.0-dev-00015 22 06/06/2023
2.0.1-dev-00009 21 06/06/2023
2.0.1-dev-00007 24 06/06/2023
2.0.1-dev-00004 30 06/06/2023
2.0.0 22 06/06/2023
2.0.0-dev-00001 26 06/06/2023