Merge pull request #378 from serilog/dev

8.0.2 Release
serilog · Jul 31, 2024 · 57d78d1 · 57d78d1
2 parents 68f2f3d + 1a88701
commit 57d78d1
Show file tree

Hide file tree

Showing 11 changed files with 103 additions and 153 deletions.
diff --git a/README.md b/README.md
@@ -4,7 +4,10 @@ Serilog logging for ASP.NET Core. This package routes ASP.NET Core log messages
 
 With _Serilog.AspNetCore_ installed and configured, you can write log messages directly through Serilog or any `ILogger` interface injected by ASP.NET. All loggers will use the same underlying implementation, levels, and destinations.
 
-**.NET Framework** and .NET Core 2.x are supported by version 3.4.0 of this package. Recent versions of _Serilog.AspNetCore_ require .NET Core 3.x, .NET 5, or later.
+**Versioning:** This package tracks the versioning and target framework support of its
+[_Microsoft.Extensions.Hosting_](https://nuget.org/packages/Microsoft.Extensions.Hosting) dependency. Most users should choose the version of _Serilog.AspNetCore_ that matches
+their application's target framework. I.e. if you're targeting .NET 7.x, choose a 7.x version of _Serilog.AspNetCore_. If
+you're targeting .NET 8.x, choose an 8.x _Serilog.AspNetCore_ version, and so on.
 
 ### Instructions
 
@@ -28,11 +31,9 @@ try
     Log.Information("Starting web application");
 
     var builder = WebApplication.CreateBuilder(args);
-
-    builder.Host.UseSerilog(); // <-- Add this line
+    builder.Services.AddSerilog(); // <-- Add this line
     
     var app = builder.Build();
-
     app.MapGet("/", () => "Hello World!");
 
     app.Run();
@@ -47,23 +48,21 @@ finally
 }
 ```
 
-The `builder.Host.UseSerilog()` call will redirect all log events through your Serilog pipeline.
+The `builder.Services.AddSerilog()` call will redirect all log events through your Serilog pipeline.
 
 **Finally**, clean up by removing the remaining configuration for the default logger, including the `"Logging"` section from _appsettings.*.json_ files (this can be replaced with [Serilog configuration](https://github.com/serilog/serilog-settings-configuration) as shown in [the _Sample_ project](https://github.com/serilog/serilog-aspnetcore/blob/dev/samples/Sample/Program.cs), if required).
 
 That's it! With the level bumped up a little you will see log output resembling:
 
 ```
-[22:14:44.646 DBG] RouteCollection.RouteAsync
-    Routes: 
-        Microsoft.AspNet.Mvc.Routing.AttributeRoute
-        {controller=Home}/{action=Index}/{id?}
-    Handled? True
-[22:14:44.647 DBG] RouterMiddleware.Invoke
-    Handled? True
-[22:14:45.706 DBG] /lib/jquery/jquery.js not modified
-[22:14:45.706 DBG] /css/site.css not modified
-[22:14:45.741 DBG] Handled. Status code: 304 File: /css/site.css
+[12:01:43 INF] Starting web application
+[12:01:44 INF] Now listening on: http://localhost:5000
+[12:01:44 INF] Application started. Press Ctrl+C to shut down.
+[12:01:44 INF] Hosting environment: Development
+[12:01:44 INF] Content root path: serilog-aspnetcore/samples/Sample
+[12:01:47 WRN] Failed to determine the https port for redirect.
+[12:01:47 INF] Hello, world!
+[12:01:47 INF] HTTP GET / responded 200 in 95.0581 ms
 ```
 
 **Tip:** to see Serilog output in the Visual Studio output window when running under IIS, either select _ASP.NET Core Web Server_ from the _Show output from_ drop-down list, or replace `WriteTo.Console()` in the logger configuration with `WriteTo.Debug()`.
@@ -97,12 +96,16 @@ Or [as JSON](https://github.com/serilog/serilog-formatting-compact):
 }
 ```
 
-To enable the middleware, first change the minimum level for `Microsoft.AspNetCore` to `Warning` in your logger configuration or _appsettings.json_ file:
+To enable the middleware, first change the minimum level for the noisy ASP.NET Core log sources to `Warning` in your logger configuration or _appsettings.json_ file:
 
 ```csharp
-            .MinimumLevel.Override("Microsoft.AspNetCore", LogEventLevel.Warning)
+            .MinimumLevel.Override("Microsoft.AspNetCore.Hosting", LogEventLevel.Warning)
+            .MinimumLevel.Override("Microsoft.AspNetCore.Mvc", LogEventLevel.Warning)
+            .MinimumLevel.Override("Microsoft.AspNetCore.Routing", LogEventLevel.Warning)
 ```
 
+> **Tip:** add `{SourceContext}` to your console logger's output template to see the names of loggers; this can help track down the source of a noisy log event to suppress.
+
 Then, in your application's _Program.cs_, add the middleware with `UseSerilogRequestLogging()`:
 
 ```csharp
@@ -187,11 +190,11 @@ Log.Logger = new LoggerConfiguration()
     .CreateBootstrapLogger(); // <-- Change this line!
 ```
 
-Then, pass a callback to `UseSerilog()` that creates the final logger:
+Then, pass a callback to `AddSerilog()` that creates the final logger:
 
 ```csharp
-builder.Host.UseSerilog((context, services, configuration) => configuration
-    .ReadFrom.Configuration(context.Configuration)
+builder.Services.AddSerilog((services, lc) => lc
+    .ReadFrom.Configuration(builder.Configuration)
     .ReadFrom.Services(services)
     .Enrich.FromLogContext()
     .WriteTo.Console());
@@ -201,7 +204,7 @@ It's important to note that the final logger **completely replaces** the bootstr
 
 #### Consuming `appsettings.json` configuration
 
-**Using two-stage initialization**, insert the `ReadFrom.Configuration(context.Configuration)` call shown in the example above. The JSON configuration syntax is documented in [the _Serilog.Settings.Configuration_ README](https://github.com/serilog/serilog-settings-configuration).
+**Using two-stage initialization**, insert the `ReadFrom.Configuration(builder.Configuration)` call shown in the example above. The JSON configuration syntax is documented in [the _Serilog.Settings.Configuration_ README](https://github.com/serilog/serilog-settings-configuration).
 
 #### Injecting services into enrichers and sinks
 
@@ -213,20 +216,6 @@ It's important to note that the final logger **completely replaces** the bootstr
  * `ILogEventSink`
  * `LoggingLevelSwitch`
 
-#### Enabling `Microsoft.Extensions.Logging.ILoggerProvider`s
-
-Serilog sends events to outputs called _sinks_, that implement Serilog's `ILogEventSink` interface, and are added to the logging pipeline using `WriteTo`. _Microsoft.Extensions.Logging_ has a similar concept called _providers_, and these implement `ILoggerProvider`. Providers are what the default logging configuration creates under the hood through methods like `AddConsole()`.
-
-By default, Serilog ignores providers, since there are usually equivalent Serilog sinks available, and these work more efficiently with Serilog's pipeline. If provider support is needed, it can be optionally enabled.
-
-To have Serilog pass events to providers, **using two-stage initialization** as above, pass `writeToProviders: true` in the call to `UseSerilog()`:
-
-```csharp
-builder.Host.UseSerilog(
-        (hostingContext, services, loggerConfiguration) => /* snip! */,
-        writeToProviders: true)
-```
-
 ### JSON output
 
 The `Console()`, `Debug()`, and `File()` sinks all support JSON-formatted output natively, via the included _Serilog.Formatting.Compact_ package.
@@ -276,17 +265,13 @@ using (logger.BeginScope(new Dictionary<string, object>
 }
 ```
 
-The code above results in the same outcome as if you would push properties in the **ILogger** in Serilog.
+The code above results in the same outcome as if you would push properties in the **LogContext** in Serilog. More details can be found in https://github.com/serilog/serilog/wiki/Enrichment#the-logcontext.
 
 ```csharp
-// Serilog ILogger
-using (logger.PushProperty("UserId", "svrooij"))
-using (logger.PushProperty("OperationType", "update"))
+// Serilog LogContext
+using (LogContext.PushProperty("UserId", "svrooij"))
+using (LogContext.PushProperty("OperationType", "update"))
 {
     // UserId and OperationType are set for all logging events in these brackets
 }
 ```
-
-### Versioning
-
-This package tracks the versioning and target framework support of its (indirect) [_Microsoft.Extensions.Hosting_](https://nuget.org/packages/Microsoft.Extensions.Hosting) dependency.
diff --git a/samples/Sample/Controllers/HomeController.cs b/samples/Sample/Controllers/HomeController.cs
@@ -35,6 +35,6 @@ public IActionResult Privacy()
     [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
     public IActionResult Error()
     {
-        return View(new ErrorViewModel {RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier});
+        return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
     }
 }
diff --git a/samples/Sample/Program.cs b/samples/Sample/Program.cs
@@ -1,47 +1,69 @@
 using Serilog;
+using Serilog.Events;
 using Serilog.Templates;
+using Serilog.Templates.Themes;
 
-namespace Sample;
+// The initial "bootstrap" logger is able to log errors during start-up. It's completely replaced by the
+// logger configured in `AddSerilog()` below, once configuration and dependency-injection have both been
+// set up successfully.
+Log.Logger = new LoggerConfiguration()
+    .WriteTo.Console()
+    .CreateBootstrapLogger();
 
-public static class Program
+Log.Information("Starting up!");
+
+try
 {
-    public static int Main(string[] args)
+    var builder = WebApplication.CreateBuilder(args);
+
+    builder.Services.AddSerilog((services, lc) => lc
+        .ReadFrom.Configuration(builder.Configuration)
+        .ReadFrom.Services(services)
+        .Enrich.FromLogContext()
+        .WriteTo.Console(new ExpressionTemplate(
+            // Include trace and span ids when present.
+            "[{@t:HH:mm:ss} {@l:u3}{#if @tr is not null} ({substring(@tr,0,4)}:{substring(@sp,0,4)}){#end}] {@m}\n{@x}",
+            theme: TemplateTheme.Code)));
+
+    builder.Services.AddControllersWithViews();
+
+    await using var app = builder.Build();
+
+    // Configure the HTTP request pipeline.
+    if (!app.Environment.IsDevelopment())
     {
-        // The initial "bootstrap" logger is able to log errors during start-up. It's completely replaced by the
-        // logger configured in `UseSerilog()` below, once configuration and dependency-injection have both been
-        // set up successfully.
-        Log.Logger = new LoggerConfiguration()
-            .WriteTo.Console()
-            .CreateBootstrapLogger();
-
-        Log.Information("Starting up!");
-
-        try
-        {
-            CreateHostBuilder(args).Build().Run();
-
-            Log.Information("Stopped cleanly");
-            return 0;
-        }
-        catch (Exception ex)
-        {
-            Log.Fatal(ex, "An unhandled exception occurred during bootstrapping");
-            return 1;
-        }
-        finally
-        {
-            Log.CloseAndFlush();
-        }
+        app.UseExceptionHandler("/Home/Error");
+        // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+        app.UseHsts();
     }
+
+    // Write streamlined request completion events, instead of the more verbose ones from the framework.
+    // To use the default framework request logging instead, remove this line and set the "Microsoft"
+    // level in appsettings.json to "Information".
+    app.UseSerilogRequestLogging();
+
+    app.UseHttpsRedirection();
+    app.UseStaticFiles();
+
+    app.UseRouting();
+
+    app.UseAuthorization();
+
+    app.MapControllerRoute(
+        name: "default",
+        pattern: "{controller=Home}/{action=Index}/{id?}");
 
-    public static IHostBuilder CreateHostBuilder(string[] args) =>
-        Host.CreateDefaultBuilder(args)
-            .UseSerilog((context, services, configuration) => configuration
-                .ReadFrom.Configuration(context.Configuration)
-                .ReadFrom.Services(services)
-                .Enrich.FromLogContext()
-                .WriteTo.Console(new ExpressionTemplate(
-                    // Include trace and span ids when present.
-                    "[{@t:HH:mm:ss} {@l:u3}{#if @tr is not null} ({substring(@tr,0,4)}:{substring(@sp,0,4)}){#end}] {@m}\n{@x}")))
-            .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());
+    await app.RunAsync();
+
+    Log.Information("Stopped cleanly");
+    return 0;
+}
+catch (Exception ex)
+{
+    Log.Fatal(ex, "An unhandled exception occurred during bootstrapping");
+    return 1;
+}
+finally
+{
+    Log.CloseAndFlush();
 }
diff --git a/samples/Sample/Sample.csproj b/samples/Sample/Sample.csproj
@@ -7,7 +7,7 @@
   <ItemGroup>
     <ProjectReference Include="..\..\src\Serilog.AspNetCore\Serilog.AspNetCore.csproj" />
   </ItemGroup>
-  
+
   <ItemGroup>
     <PackageReference Include="Serilog.Expressions" Version="4.0.0" />
   </ItemGroup>

diff --git a/samples/Sample/Startup.cs b/samples/Sample/Startup.cs
diff --git a/samples/Sample/appsettings.json b/samples/Sample/appsettings.json
@@ -3,8 +3,9 @@
     "MinimumLevel": {
       "Default": "Information",
       "Override": {
-        "Microsoft": "Warning",
-        "Microsoft.Hosting.Lifetime": "Information"
+        "Microsoft.AspNetCore.Mvc": "Warning",
+        "Microsoft.AspNetCore.Routing": "Warning",
+        "Microsoft.AspNetCore.Hosting": "Warning"
       }
     },
     "WriteTo": [

diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
@@ -32,7 +32,7 @@ class RequestLoggingMiddleware
     readonly Func<HttpContext, string, double, int, IEnumerable<LogEventProperty>> _getMessageTemplateProperties;
     readonly ILogger? _logger;
     readonly bool _includeQueryInRequestPath;
-    static readonly LogEventProperty[] NoProperties = Array.Empty<LogEventProperty>();
+    static readonly LogEventProperty[] NoProperties = [];
 
     public RequestLoggingMiddleware(RequestDelegate next, DiagnosticContext diagnosticContext, RequestLoggingOptions options)
     {
@@ -102,7 +102,7 @@ bool LogCompletion(HttpContext httpContext, DiagnosticContextCollector collector
             properties,
             traceId,
             spanId);
-        
+
         logger.Write(evt);
 
         return false;

diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
@@ -35,13 +35,12 @@ static LogEventLevel DefaultGetLevel(HttpContext ctx, double _, Exception? ex) =
                 : LogEventLevel.Information;
 
     static IEnumerable<LogEventProperty> DefaultGetMessageTemplateProperties(HttpContext httpContext, string requestPath, double elapsedMs, int statusCode) =>
-        new[]
-        {
+        [
             new LogEventProperty("RequestMethod", new ScalarValue(httpContext.Request.Method)),
             new LogEventProperty("RequestPath", new ScalarValue(requestPath)),
             new LogEventProperty("StatusCode", new ScalarValue(statusCode)),
             new LogEventProperty("Elapsed", new ScalarValue(elapsedMs))
-        };
+        ];
 
     /// <summary>
     /// Gets or sets the message template. The default value is

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -3,7 +3,7 @@
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
     <!-- This must match the major and minor components of the referenced *.Extensions.* packages (and highest supported .NET TFM). -->
-    <VersionPrefix>8.0.1</VersionPrefix>
+    <VersionPrefix>8.0.2</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
     <TargetFrameworks>net462;netstandard2.0;net6.0;net7.0;net8.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
@@ -34,11 +34,8 @@
   <ItemGroup>
     <!-- The versions of all references in this group must match the major and minor components of the package version prefix. -->
     <PackageReference Include="Serilog.Extensions.Hosting" Version="8.0.0" />
-    <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.0" />
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
+    <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.2" />
     <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
-    <!-- Temporary addition to pull in trace/span support -->
-    <PackageReference Include="Serilog.Extensions.Logging" Version="8.0.0" />
   </ItemGroup>
 
   <ItemGroup Condition=" '$(TargetFramework)' != 'net462' and '$(TargetFramework)' != 'netstandard2.0' ">