Serilog.Extensions.Hosting 8.0.0

Prefix Reserved
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Serilog.Extensions.Hosting --version 8.0.0                
NuGet\Install-Package Serilog.Extensions.Hosting -Version 8.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Serilog.Extensions.Hosting" Version="8.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Serilog.Extensions.Hosting --version 8.0.0                
#r "nuget: Serilog.Extensions.Hosting, 8.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Serilog.Extensions.Hosting as a Cake Addin
#addin nuget:?package=Serilog.Extensions.Hosting&version=8.0.0

// Install Serilog.Extensions.Hosting as a Cake Tool
#tool nuget:?package=Serilog.Extensions.Hosting&version=8.0.0                

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.

ASP.NET Core applications should consider using Serilog.AspNetCore instead, which bundles this package and includes other ASP.NET Core-specific features.

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:

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();
        }
    }

Then, add UseSerilog() to the host builder in BuildHost().

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

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.

Versioning

This package tracks the versioning and target framework support of its Microsoft.Extensions.Hosting dependency.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (310)

Showing the top 5 NuGet packages that depend on Serilog.Extensions.Hosting:

Package Downloads
Serilog.AspNetCore

Serilog support for ASP.NET Core logging

Umbraco.Cms.Infrastructure

Contains the infrastructure assembly needed to run Umbraco CMS.

Blauhaus.Analytics.Serilog

Package Description

ComplianceAuditSystems.AcabimCommonServices

Package Description

DotNetCore.Logging

DotNetCore.Logging

GitHub repositories (88)

Showing the top 5 popular GitHub repositories that depend on Serilog.Extensions.Hosting:

Repository Stars
netchx/netch
A simple proxy client
abpframework/abp
Open-source web application framework for ASP.NET Core! Offers an opinionated architecture to build enterprise software solutions with best practices on top of the .NET. Provides the fundamental infrastructure, cross-cutting-concern implementations, startup templates, application modules, UI themes, tooling and documentation.
quartznet/quartznet
Quartz Enterprise Scheduler .NET
Kareadita/Kavita
Kavita is a fast, feature rich, cross platform reading server. Built with the goal of being a full solution for all your reading needs. Setup your own server and share your reading collection with your friends and family.
RayWangQvQ/BiliBiliToolPro
B 站(bilibili)自动任务工具,支持docker、青龙、k8s等多种部署方式。敏感肌也能用。
Version Downloads Last updated
9.0.0-dev-02303 3,025 11/27/2024
9.0.0-dev-02301 84 11/27/2024
8.0.0 57,447,343 11/15/2023
8.0.0-dev-00145 253 4/5/2024
8.0.0-dev-00143 269 3/25/2024
8.0.0-dev-00140 215 3/14/2024
8.0.0-dev-00137 495 11/15/2023
7.0.0 32,429,415 5/11/2023
7.0.0-dev-00131 729 5/10/2023
7.0.0-dev-00129 7,016 5/5/2023
7.0.0-dev-00126 675 5/5/2023
5.1.0-dev-00123 13,963 3/21/2023
5.0.1 89,344,909 7/18/2022
5.0.1-dev-00113 1,143 7/18/2022
5.0.0 1,885,747 7/8/2022
5.0.0-dev-00108 708 7/8/2022
5.0.0-dev-00095 51,621 3/21/2022
5.0.0-dev-00094 758 3/21/2022
5.0.0-dev-00093 332,725 3/4/2022
4.2.1-dev-00092 9,461 2/27/2022
4.2.0 51,530,463 11/8/2021
4.2.0-dev-00079 783 11/8/2021
4.1.2 78,454,081 3/3/2021
4.1.2-dev-00062 957 3/3/2021
4.1.1 37,169 3/2/2021
4.1.1-dev-00058 1,522 3/2/2021
4.1.0 270,520 2/24/2021
4.1.0-dev-00054 1,028 2/23/2021
4.0.0 339,794 2/14/2021
4.0.0-dev-00051 101,396 10/9/2020
4.0.0-dev-00050 1,017 10/9/2020
3.1.0 46,674,639 5/27/2020
3.1.0-dev-00041 1,108 5/27/2020
3.1.0-dev-00037 1,199 5/24/2020
3.1.0-dev-00035 26,674 5/11/2020
3.0.0 52,934,557 8/27/2019
3.0.0-dev-00024 1,161 8/27/2019
3.0.0-dev-00019 130,157 6/26/2019
3.0.0-dev-00016 5,925 6/24/2019
3.0.0-dev-00015 1,221 6/24/2019
2.0.1-dev-00009 104,540 9/21/2018
2.0.1-dev-00007 2,190 8/5/2018
2.0.1-dev-00004 1,978 7/19/2018
2.0.0 2,278,524 7/19/2018
2.0.0-dev-00001 21,226 6/3/2018