From ffed9d231aefc3de7c13a03a570fb45c326632b0 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Tue, 12 Nov 2019 12:44:36 +1000
Subject: [PATCH 01/24] Dev version bump [skip ci]

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 5c5c3f7..f8ebe13 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
-    <VersionPrefix>3.2.0</VersionPrefix>
+    <VersionPrefix>3.2.1</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
     <TargetFrameworks>netstandard2.0</TargetFrameworks>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>

From 71b0f0b43b64f55aaa36fd141a45130b22104531 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philip=20J=C3=B6bstl?= <philip.joebstl@hotmail.com>
Date: Thu, 23 Jan 2020 14:54:40 +0100
Subject: [PATCH 02/24] Update Instructions for .NET Core 3 templates

The instructions for using Serilog contained statements that were no longer valid since .NET Core 3.0 uses the Generic Host and new project templates.

The code sample in the readme and the corresponding statements were updated to resemble these changes.
---
 README.md | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 860fe95..e14efc0 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ public class Program
         try
         {
             Log.Information("Starting web host");
-            CreateWebHostBuilder(args).Build().Run();
+            CreateHostBuilder(args).Build().Run();
             return 0;
         }
         catch (Exception ex)
@@ -46,21 +46,22 @@ public class Program
     }
 ```
 
-**Then**, add `UseSerilog()` to the web host builder in `BuildWebHost()`.
+**Then**, add `UseSerilog()` to the Generic Host in `CreateHostBuilder()`.
 
 ```csharp        
-    public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
-            WebHost.CreateDefaultBuilder(args)
-                .UseStartup<Startup>()
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+            Host.CreateDefaultBuilder(args)
+                .ConfigureWebHostDefaults(webBuilder =>
+                {
+                    webBuilder.UseStartup<Startup>();
+                })
                 .UseSerilog(); // <-- Add this line;
 }
 ```
 
 **Finally**, clean up by removing the remaining configuration for the default logger:
 
- * Remove calls to `AddLogging()`
  * Remove 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 _EarlyInitializationSample_ project](https://github.com/serilog/serilog-aspnetcore/blob/dev/samples/EarlyInitializationSample/Program.cs), if required)
- * Remove `ILoggerFactory` parameters and any `Add*()` calls on the logger factory in _Startup.cs_
  * Remove `UseApplicationInsights()` (this can be replaced with the [Serilog AI sink](https://github.com/serilog/serilog-sinks-applicationinsights), if required)
 
 That's it! With the level bumped up a little you will see log output resembling:

From de27db1d2583a16dd7b047256e4ac023a4d4bc0b Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Sat, 18 Jan 2020 17:11:09 +0100
Subject: [PATCH 03/24] Cross target to netcoreapp3.1 (LTS)

---
 global.json                                     |  2 +-
 .../Serilog.AspNetCore.csproj                   | 17 +++++++++++++----
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/global.json b/global.json
index 2223a05..f1c2b2b 100644
--- a/global.json
+++ b/global.json
@@ -1,5 +1,5 @@
 {
   "sdk": {
-    "version": "3.0.100"
+    "version": "3.1.101"
   }
 }
\ No newline at end of file
diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index f8ebe13..8d96e06 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -4,7 +4,7 @@
     <Description>Serilog support for ASP.NET Core logging</Description>
     <VersionPrefix>3.2.1</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
-    <TargetFrameworks>netstandard2.0</TargetFrameworks>
+    <TargetFrameworks>netstandard2.0;netcoreapp3.1</TargetFrameworks>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <AssemblyOriginatorKeyFile>../../assets/Serilog.snk</AssemblyOriginatorKeyFile>
@@ -28,9 +28,18 @@
     <PackageReference Include="Serilog.Sinks.Debug" Version="1.0.1" />
     <PackageReference Include="Serilog.Settings.Configuration" Version="3.1.0" />
     <PackageReference Include="Serilog.Formatting.Compact" Version="1.0.0" />
-    <PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" Version="2.0.0" />
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="2.0.0" />
-    <PackageReference Include="Microsoft.Extensions.Logging" Version="2.0.0" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">
+    <PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" Version="2.1.*" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="2.1.*" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="2.1.*" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp3.1'">
+    <FrameworkReference Include="Microsoft.AspNetCore.App" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="3.1.*" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="3.1.*" />
   </ItemGroup>
 
 </Project>

From f76b6db19460958a4a506b16217608a1d9612c0a Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Sat, 18 Jan 2020 18:01:28 +0100
Subject: [PATCH 04/24] cross target the samples to be sure it ran for both
 netcoreapp2.1 and 3.1

---
 test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
index 83b1006..d6e81ac 100644
--- a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
+++ b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFrameworks>netcoreapp2.0</TargetFrameworks>
+    <TargetFrameworks>netcoreapp2.1;netcoreapp3.1</TargetFrameworks>
     <AssemblyName>Serilog.AspNetCore.Tests</AssemblyName>
     <AssemblyOriginatorKeyFile>../../assets/Serilog.snk</AssemblyOriginatorKeyFile>
     <SignAssembly>true</SignAssembly>

From 17ecc78486eb2c4bc10037e72150b14cef40d3e4 Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Sat, 18 Jan 2020 18:01:49 +0100
Subject: [PATCH 05/24] re-target samples from netcoreapp3.0 to 3.1 (LTS)

---
 .../EarlyInitializationSample/EarlyInitializationSample.csproj  | 2 +-
 .../InlineInitializationSample.csproj                           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/samples/EarlyInitializationSample/EarlyInitializationSample.csproj b/samples/EarlyInitializationSample/EarlyInitializationSample.csproj
index 0b71549..2c67adb 100644
--- a/samples/EarlyInitializationSample/EarlyInitializationSample.csproj
+++ b/samples/EarlyInitializationSample/EarlyInitializationSample.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/samples/InlineInitializationSample/InlineInitializationSample.csproj b/samples/InlineInitializationSample/InlineInitializationSample.csproj
index 0b71549..2c67adb 100644
--- a/samples/InlineInitializationSample/InlineInitializationSample.csproj
+++ b/samples/InlineInitializationSample/InlineInitializationSample.csproj
@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TargetFramework>netcoreapp3.1</TargetFramework>
   </PropertyGroup>
 
   <ItemGroup>

From ff288cd20fa6ef01e6276d53f52a6bda29a1e726 Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Sat, 18 Jan 2020 18:02:29 +0100
Subject: [PATCH 06/24] Change base image of app veyor to vs2019 as
 netcoreapp3.0 requires Vs2019

---
 appveyor.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/appveyor.yml b/appveyor.yml
index ef82a65..9f9e04e 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -1,6 +1,6 @@
 version: '{build}'
 skip_tags: true
-image: Visual Studio 2017
+image: Visual Studio 2019
 install:
 - ps: ./Setup.ps1
 build_script:

From 072ac22faffa87c2bb160c925a4e4c2fae4d6bba Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Wed, 12 Feb 2020 18:11:45 +0100
Subject: [PATCH 07/24] Update serilog transitive

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 8d96e06..a3b9f9d 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -21,13 +21,13 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Serilog" Version="2.8.0" />
+    <PackageReference Include="Serilog" Version="2.9.0" />
     <PackageReference Include="Serilog.Extensions.Hosting" Version="3.0.0" />
     <PackageReference Include="Serilog.Sinks.Console" Version="3.1.1" />
-    <PackageReference Include="Serilog.Sinks.File" Version="4.0.0" />
+    <PackageReference Include="Serilog.Sinks.File" Version="4.1.0" />
     <PackageReference Include="Serilog.Sinks.Debug" Version="1.0.1" />
     <PackageReference Include="Serilog.Settings.Configuration" Version="3.1.0" />
-    <PackageReference Include="Serilog.Formatting.Compact" Version="1.0.0" />
+    <PackageReference Include="Serilog.Formatting.Compact" Version="1.1.0" />
   </ItemGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">

From e712b400479597791317cf702fbe460186b1dad8 Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Sat, 18 Jan 2020 17:12:06 +0100
Subject: [PATCH 08/24] Add PackageIcon as PackageIconUrl in going to be
 deprecated (see
 https://docs.microsoft.com/en-us/nuget/reference/msbuild-targets#packageiconurl)

---
 .../Serilog.AspNetCore.csproj                   |   6 ++++++
 .../images/serilog-extension-nuget.png          | Bin 0 -> 22378 bytes
 2 files changed, 6 insertions(+)
 create mode 100644 src/Serilog.AspNetCore/images/serilog-extension-nuget.png

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index a3b9f9d..f6aca73 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -11,6 +11,7 @@
     <SignAssembly>true</SignAssembly>
     <PublicSign Condition=" '$(OS)' != 'Windows_NT' ">true</PublicSign>
     <PackageTags>serilog;aspnet;aspnetcore</PackageTags>
+    <PackageIcon>serilog-extension-nuget.png</PackageIcon>
     <PackageIconUrl>https://serilog.net/images/serilog-extension-nuget.png</PackageIconUrl>
     <PackageProjectUrl>https://github.com/serilog/serilog-aspnetcore</PackageProjectUrl>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
@@ -20,6 +21,10 @@
     <RootNamespace>Serilog</RootNamespace>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="images/serilog-extension-nuget.png" Pack="true" PackagePath="/" />
+  </ItemGroup>
+
   <ItemGroup>
     <PackageReference Include="Serilog" Version="2.9.0" />
     <PackageReference Include="Serilog.Extensions.Hosting" Version="3.0.0" />
@@ -38,6 +43,7 @@
 
   <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp3.1'">
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
+    
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="3.1.*" />
     <PackageReference Include="Microsoft.Extensions.Logging" Version="3.1.*" />
   </ItemGroup>
diff --git a/src/Serilog.AspNetCore/images/serilog-extension-nuget.png b/src/Serilog.AspNetCore/images/serilog-extension-nuget.png
new file mode 100644
index 0000000000000000000000000000000000000000..1dfe4308b664e684217d436367a25bf91308f436
GIT binary patch
literal 22378
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

literal 0
HcmV?d00001


From d5bf961a69af9dfd1f4a683451245ff4afac284a Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Wed, 19 Feb 2020 09:29:50 +0100
Subject: [PATCH 09/24] Remove wildcard, in favor of using explicitly the
 latest version of nuget being used at build time

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index f6aca73..4a96ad7 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -36,16 +36,16 @@
   </ItemGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == 'netstandard2.0'">
-    <PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" Version="2.1.*" />
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="2.1.*" />
-    <PackageReference Include="Microsoft.Extensions.Logging" Version="2.1.*" />
+    <PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" Version="2.1.1" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="2.1.1" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="2.1.1" />
   </ItemGroup>
 
   <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp3.1'">
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
     
-    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="3.1.*" />
-    <PackageReference Include="Microsoft.Extensions.Logging" Version="3.1.*" />
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="3.1.2" />
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="3.1.2" />
   </ItemGroup>
 
 </Project>

From 5b3f8edef777edb7f215f1452a21dd90e15b188a Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Thu, 20 Feb 2020 07:26:14 +1000
Subject: [PATCH 10/24] Package dependency updates - minor version bump, not
 binary-breaking [skip ci]

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 4a96ad7..62cd77d 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
-    <VersionPrefix>3.2.1</VersionPrefix>
+    <VersionPrefix>3.3.0</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
     <TargetFrameworks>netstandard2.0;netcoreapp3.1</TargetFrameworks>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>

From 8877e15d68e975c1e650fb7fdad11c494a26172f Mon Sep 17 00:00:00 2001
From: TeBeCo <tebeco@gmail.com>
Date: Wed, 19 Feb 2020 23:24:02 +0100
Subject: [PATCH 11/24] Update the global.json so that the SDK match package
 that are actually used

---
 global.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/global.json b/global.json
index f1c2b2b..995f355 100644
--- a/global.json
+++ b/global.json
@@ -1,5 +1,5 @@
 {
   "sdk": {
-    "version": "3.1.101"
+    "version": "3.1.102"
   }
 }
\ No newline at end of file

From b1ae12725ef7c2f6aebb0e0e217272d3e3914113 Mon Sep 17 00:00:00 2001
From: Ralph Hendriks <mail@ralphhendriks.nl>
Date: Mon, 24 Feb 2020 09:15:07 +0100
Subject: [PATCH 12/24] Pin .NET Core SDK version to latest feature band

Pin the .NET Core SDK version to the `3.1.1xx` feature band. Do not
allow prerelease versions.

Fixes #175
---
 global.json | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/global.json b/global.json
index 995f355..5442449 100644
--- a/global.json
+++ b/global.json
@@ -1,5 +1,7 @@
 {
   "sdk": {
-    "version": "3.1.102"
+    "allowPrerelease": false,
+    "version": "3.1.100",
+    "rollForward": "latestPatch"
   }
 }
\ No newline at end of file

From 28d4dd2b99d211222b19a84811ab88c263d96ec3 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Thu, 26 Mar 2020 08:32:18 +1000
Subject: [PATCH 13/24] Spike for #182, allow an ILogger to be specified

---
 .../AspNetCore/RequestLoggingMiddleware.cs               | 5 ++++-
 .../AspNetCore/RequestLoggingOptions.cs                  | 9 +++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
index e6c17f1..4472e5d 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
@@ -24,6 +24,7 @@
 
 namespace Serilog.AspNetCore
 {
+    // ReSharper disable once ClassNeverInstantiated.Global
     class RequestLoggingMiddleware
     {
         readonly RequestDelegate _next;
@@ -31,6 +32,7 @@ class RequestLoggingMiddleware
         readonly MessageTemplate _messageTemplate;
         readonly Action<IDiagnosticContext, HttpContext> _enrichDiagnosticContext;
         readonly Func<HttpContext, double, Exception, LogEventLevel> _getLevel;
+        readonly ILogger _logger;
         static readonly LogEventProperty[] NoProperties = new LogEventProperty[0];
 
         public RequestLoggingMiddleware(RequestDelegate next, DiagnosticContext diagnosticContext, RequestLoggingOptions options)
@@ -42,6 +44,7 @@ public RequestLoggingMiddleware(RequestDelegate next, DiagnosticContext diagnost
             _getLevel = options.GetLevel;
             _enrichDiagnosticContext = options.EnrichDiagnosticContext;
             _messageTemplate = new MessageTemplateParser().Parse(options.MessageTemplate);
+            _logger = options.Logger?.ForContext<RequestLoggingMiddleware>();
         }
 
         // ReSharper disable once UnusedMember.Global
@@ -73,7 +76,7 @@ public async Task Invoke(HttpContext httpContext)
 
         bool LogCompletion(HttpContext httpContext, DiagnosticContextCollector collector, int statusCode, double elapsedMs, Exception ex)
         {
-            var logger = Log.ForContext<RequestLoggingMiddleware>();
+            var logger = _logger ?? Log.ForContext<RequestLoggingMiddleware>();
             var level = _getLevel(httpContext, elapsedMs, ex);
 
             if (!logger.IsEnabled(level)) return false;
diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
index 327e468..6a69f55 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
@@ -16,6 +16,8 @@
 using Serilog.Events;
 using System;
 
+// ReSharper disable UnusedAutoPropertyAccessor.Global
+
 namespace Serilog.AspNetCore
 {
     /// <summary>
@@ -50,6 +52,13 @@ public class RequestLoggingOptions
         /// </summary>
         public Action<IDiagnosticContext, HttpContext> EnrichDiagnosticContext { get; set; }
 
+
+        /// <summary>
+        /// The logger through which request completion events will be logged. The default is to use the
+        /// static <see cref="Log"/> class.
+        /// </summary>
+        public ILogger Logger { get; set; }
+
         internal RequestLoggingOptions() { }
     }
 }

From 8fd539d711feafbc5133df37b152393627eaedbc Mon Sep 17 00:00:00 2001
From: Rafael dos Santos <rsantos@braziliandevs.com>
Date: Thu, 30 Apr 2020 16:11:39 -0300
Subject: [PATCH 14/24] Fallback RequestPath for when
 IHttpRequestFeature.RawTarteg is empty instead of null

---
 .../AspNetCore/RequestLoggingMiddleware.cs                | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
index e6c17f1..db2eb0c 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
@@ -106,7 +106,13 @@ static double GetElapsedMilliseconds(long start, long stop)
 
         static string GetPath(HttpContext httpContext)
         {
-            return httpContext.Features.Get<IHttpRequestFeature>()?.RawTarget ?? httpContext.Request.Path.ToString();
+            var requestPath = httpContext.Features.Get<IHttpRequestFeature>()?.RawTarget;
+            if (string.IsNullOrWhiteSpace(requestPath))
+            {
+                requestPath = httpContext.Request.Path.ToString();
+            }
+            
+            return requestPath;
         }
     }
 }

From 4fea46555139083e9f0ec8481c48e9afd14540d0 Mon Sep 17 00:00:00 2001
From: Rafael dos Santos <rsantos@braziliandevs.com>
Date: Thu, 30 Apr 2020 20:27:50 -0300
Subject: [PATCH 15/24] Using string.IsNullOrEmpty / Adding extra comments

---
 .../AspNetCore/RequestLoggingMiddleware.cs                 | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
index db2eb0c..08419e5 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
@@ -106,8 +106,13 @@ static double GetElapsedMilliseconds(long start, long stop)
 
         static string GetPath(HttpContext httpContext)
         {
+            /*
+                In some cases, like when running integration tests with WebApplicationFactory<T>
+                the RawTarget returns an empty string instead of null, in that case we can't use
+                ?? as fallback.
+            */
             var requestPath = httpContext.Features.Get<IHttpRequestFeature>()?.RawTarget;
-            if (string.IsNullOrWhiteSpace(requestPath))
+            if (string.IsNullOrEmpty(requestPath))
             {
                 requestPath = httpContext.Request.Path.ToString();
             }

From 5386292e6798dc0bd1167d6293f514f2c7577ebd Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Sat, 2 May 2020 07:34:11 +1000
Subject: [PATCH 16/24] Update issue templates

---
 .github/ISSUE_TEMPLATE/bug_report.md      | 27 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 20 +++++++++++++++++
 .github/ISSUE_TEMPLATE/usage-help.md      | 16 ++++++++++++++
 3 files changed, 63 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/ISSUE_TEMPLATE/usage-help.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..04d41db
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Report a bug and help us to improve Serilog
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+The Serilog maintainers want you to have a great experience using Serilog, and will happily track down and resolve bugs. We all have limited time, though, so please think through all of the factors that might be involved and include as much useful information as possible 😊.
+
+ℹ If the problem is caused by a sink or other related package, please try to track down the correct repository for that package and create the report there: this tracker is for the  **Serilog.AspNetCore** package only.
+
+**Description**
+What's going wrong?
+
+**Reproduction**
+Please provide code samples showing how you're configuring and calling Serilog to produce the behavior.
+
+**Expected behavior**
+A concise description of what you expected to happen.
+
+**Relevant package, tooling and runtime versions**
+What Serilog version are you using, on what platform?
+
+**Additional context**
+Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..272c322
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an improvement to Serilog
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
diff --git a/.github/ISSUE_TEMPLATE/usage-help.md b/.github/ISSUE_TEMPLATE/usage-help.md
new file mode 100644
index 0000000..4e4db70
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/usage-help.md
@@ -0,0 +1,16 @@
+---
+name: Usage help
+about: Get help with using Serilog
+title: ''
+labels: invalid
+assignees: ''
+
+---
+
+Hi! 👋
+
+The Serilog community wants you to have a great experience using Serilog. Unfortunately, only a handful of maintainers actively follow this repository, and our time is short, so we cannot answer usage questions posted here.
+
+Fortunately, a much larger group of people (including some of us) also watch and answer questions on the [`serilog` tag on Stack Overflow](https://stackoverflow.com/questions/tagged/serilog).
+
+Please head over to Stack Overflow, ask your question, and tag it with `serilog`. Thanks! ❤

From a91dfab01227642ffd427d42aab273332ebd0d25 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Tue, 12 May 2020 09:31:59 +1000
Subject: [PATCH 17/24] Update to show new UseSerilog() overload including
 service provider

---
 README.md                                        | 4 ++--
 global.json                                      | 2 +-
 samples/InlineInitializationSample/Program.cs    | 7 ++-----
 samples/InlineInitializationSample/Startup.cs    | 2 --
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 4 ++--
 5 files changed, 7 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index e14efc0..b33f583 100644
--- a/README.md
+++ b/README.md
@@ -192,13 +192,13 @@ app.UseSerilogRequestLogging(options =>
 You can alternatively configure Serilog inline, in `BuildWebHost()`, using a delegate as shown below:
 
 ```csharp
-    .UseSerilog((hostingContext, loggerConfiguration) => loggerConfiguration
+    .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](https://github.com/serilog/serilog-settings-configuration), but at the expense of losing `Exception`s raised earlier in program startup.
+This has the advantage of making a service provider and the `hostingContext`'s `Configuration` object available for [configuration of the logger](https://github.com/serilog/serilog-settings-configuration), but at the expense of losing `Exception`s raised earlier in program startup.
 
 If this method is used, `Log.Logger` is assigned implicitly, and closed when the app is shut down.
 
diff --git a/global.json b/global.json
index 5442449..747f7cc 100644
--- a/global.json
+++ b/global.json
@@ -1,7 +1,7 @@
 {
   "sdk": {
     "allowPrerelease": false,
-    "version": "3.1.100",
+    "version": "3.1.201",
     "rollForward": "latestPatch"
   }
 }
\ No newline at end of file
diff --git a/samples/InlineInitializationSample/Program.cs b/samples/InlineInitializationSample/Program.cs
index 9cf2e42..a06dbd1 100644
--- a/samples/InlineInitializationSample/Program.cs
+++ b/samples/InlineInitializationSample/Program.cs
@@ -13,11 +13,8 @@ public static void Main(string[] args)
 
         public static IHostBuilder CreateHostBuilder(string[] args) =>
             Host.CreateDefaultBuilder(args)
-                .ConfigureWebHostDefaults(webBuilder =>
-                {
-                    webBuilder.UseStartup<Startup>();
-                })
-                .UseSerilog((hostingContext, loggerConfiguration) => loggerConfiguration
+                .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); })
+                .UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
                     .ReadFrom.Configuration(hostingContext.Configuration)
                     .Enrich.FromLogContext()
                     .WriteTo.Debug()
diff --git a/samples/InlineInitializationSample/Startup.cs b/samples/InlineInitializationSample/Startup.cs
index 82f3bcd..2b71adf 100644
--- a/samples/InlineInitializationSample/Startup.cs
+++ b/samples/InlineInitializationSample/Startup.cs
@@ -1,10 +1,8 @@
-using System.Net;
 using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Serilog;
-using Serilog.Events;
 
 namespace InlineInitializationSample
 {
diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 62cd77d..316d955 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
-    <VersionPrefix>3.3.0</VersionPrefix>
+    <VersionPrefix>3.4.0</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
     <TargetFrameworks>netstandard2.0;netcoreapp3.1</TargetFrameworks>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
@@ -27,7 +27,7 @@
 
   <ItemGroup>
     <PackageReference Include="Serilog" Version="2.9.0" />
-    <PackageReference Include="Serilog.Extensions.Hosting" Version="3.0.0" />
+    <PackageReference Include="Serilog.Extensions.Hosting" Version="3.1.0-dev-*" />
     <PackageReference Include="Serilog.Sinks.Console" Version="3.1.1" />
     <PackageReference Include="Serilog.Sinks.File" Version="4.1.0" />
     <PackageReference Include="Serilog.Sinks.Debug" Version="1.0.1" />

From 10a28573d032857418b2b8d6d7028dc171db47e5 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Tue, 12 May 2020 09:34:06 +1000
Subject: [PATCH 18/24] Formatting

---
 samples/InlineInitializationSample/Program.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/samples/InlineInitializationSample/Program.cs b/samples/InlineInitializationSample/Program.cs
index a06dbd1..b2c964c 100644
--- a/samples/InlineInitializationSample/Program.cs
+++ b/samples/InlineInitializationSample/Program.cs
@@ -13,7 +13,7 @@ public static void Main(string[] args)
 
         public static IHostBuilder CreateHostBuilder(string[] args) =>
             Host.CreateDefaultBuilder(args)
-                .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); })
+                .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>())
                 .UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
                     .ReadFrom.Configuration(hostingContext.Configuration)
                     .Enrich.FromLogContext()

From 815191263a6727cd697b33daa3b3ee31d1861e2e Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Wed, 13 May 2020 11:10:37 +1000
Subject: [PATCH 19/24] Allow `latestFeature` in global.json

---
 global.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/global.json b/global.json
index 747f7cc..80992af 100644
--- a/global.json
+++ b/global.json
@@ -2,6 +2,6 @@
   "sdk": {
     "allowPrerelease": false,
     "version": "3.1.201",
-    "rollForward": "latestPatch"
+    "rollForward": "latestFeature"
   }
-}
\ No newline at end of file
+}

From 84d8aa437bec509f8241c95aebc838d3acc474bb Mon Sep 17 00:00:00 2001
From: "Michael A. Volz (Flynn)" <mvolz@redmuffin.de>
Date: Tue, 2 Jun 2020 11:31:59 +0200
Subject: [PATCH 20/24] Output formatting fix

Moved .UseSerilog() before .ConfigureWebHostDefaults to enable correct formatting in console output.
---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b33f583..c1a3538 100644
--- a/README.md
+++ b/README.md
@@ -51,11 +51,11 @@ public class Program
 ```csharp        
     public static IHostBuilder CreateHostBuilder(string[] args) =>
             Host.CreateDefaultBuilder(args)
+                .UseSerilog() // <-- Add this line
                 .ConfigureWebHostDefaults(webBuilder =>
                 {
                     webBuilder.UseStartup<Startup>();
-                })
-                .UseSerilog(); // <-- Add this line;
+                });
 }
 ```
 

From a658f0b4e245a056efdd06b64f93877e8484eadd Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Wed, 3 Jun 2020 10:14:40 +1000
Subject: [PATCH 21/24] Update NuGet.org publishing key; don't skip symbol
 publishing

---
 appveyor.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/appveyor.yml b/appveyor.yml
index 9f9e04e..6f56235 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -11,8 +11,7 @@ artifacts:
 deploy:
 - provider: NuGet
   api_key:
-    secure: gvYNwOSxj9Bq4erOm7alpWzHlEmNLLUV99VYKV1WF9qTJeDkvYpswoNHi9sAlZH4
-  skip_symbols: true
+    secure: jZtLAmD4ALF9x1BZR1DiV3KhKlliWbzRUAw73xfMZaBsvz19123qLz2zw1+hPdcn
   on:
     branch: /^(master|dev)$/
 - provider: GitHub

From 63e73f61dd9ce81452a6f5f21fc678cb9027a6cc Mon Sep 17 00:00:00 2001
From: Sergey Komisarchik <skomisarchik@usetech.ru>
Date: Sat, 13 Jun 2020 12:57:01 +0300
Subject: [PATCH 22/24] configure RequestLoggingOptions

---
 samples/InlineInitializationSample/Startup.cs |  9 ++
 .../AspNetCore/RequestLoggingOptions.cs       | 24 ++++-
 .../SerilogApplicationBuilderExtensions.cs    | 27 ++----
 .../Serilog.AspNetCore.Tests.csproj           | 12 ++-
 .../SerilogWebHostBuilderExtensionsTests.cs   | 91 ++++++++++++++++++-
 .../Support/Extensions.cs                     | 12 +++
 .../Support/SerilogWebApplicationFactory.cs   | 13 +++
 7 files changed, 161 insertions(+), 27 deletions(-)
 create mode 100644 test/Serilog.AspNetCore.Tests/Support/Extensions.cs
 create mode 100644 test/Serilog.AspNetCore.Tests/Support/SerilogWebApplicationFactory.cs

diff --git a/samples/InlineInitializationSample/Startup.cs b/samples/InlineInitializationSample/Startup.cs
index 2b71adf..c8dc31e 100644
--- a/samples/InlineInitializationSample/Startup.cs
+++ b/samples/InlineInitializationSample/Startup.cs
@@ -3,6 +3,7 @@
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Serilog;
+using Serilog.AspNetCore;
 
 namespace InlineInitializationSample
 {
@@ -10,6 +11,14 @@ public class Startup
     {
         public void ConfigureServices(IServiceCollection services)
         {
+            services.Configure<RequestLoggingOptions>(o =>
+            {
+                o.EnrichDiagnosticContext = (diagnosticContext, httpContext) =>
+                {
+                    diagnosticContext.Set("RemoteIpAddress", httpContext.Connection.RemoteIpAddress.MapToIPv4());
+                };
+            });
+
             services.AddControllersWithViews();
         }
 
diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
index 6a69f55..8d86582 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingOptions.cs
@@ -1,4 +1,4 @@
-// Copyright 2019 Serilog Contributors
+// Copyright 2019-2020 Serilog Contributors
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -21,10 +21,20 @@
 namespace Serilog.AspNetCore
 {
     /// <summary>
-    /// Contains options for the <see cref="Serilog.AspNetCore.RequestLoggingMiddleware"/>.
+    /// Contains options for the <see cref="RequestLoggingMiddleware"/>.
     /// </summary>
     public class RequestLoggingOptions
     {
+        const string DefaultRequestCompletionMessageTemplate =
+            "HTTP {RequestMethod} {RequestPath} responded {StatusCode} in {Elapsed:0.0000} ms";
+
+        static LogEventLevel DefaultGetLevel(HttpContext ctx, double _, Exception ex) =>
+            ex != null
+                ? LogEventLevel.Error
+                : ctx.Response.StatusCode > 499
+                    ? LogEventLevel.Error
+                    : LogEventLevel.Information;
+
         /// <summary>
         /// Gets or sets the message template. The default value is
         /// <c>"HTTP {RequestMethod} {RequestPath} responded {StatusCode} in {Elapsed:0.0000} ms"</c>. The
@@ -52,13 +62,19 @@ public class RequestLoggingOptions
         /// </summary>
         public Action<IDiagnosticContext, HttpContext> EnrichDiagnosticContext { get; set; }
 
-
         /// <summary>
         /// The logger through which request completion events will be logged. The default is to use the
         /// static <see cref="Log"/> class.
         /// </summary>
         public ILogger Logger { get; set; }
 
-        internal RequestLoggingOptions() { }
+        /// <summary>
+        /// Constructor
+        /// </summary>
+        public RequestLoggingOptions()
+        {
+            GetLevel = DefaultGetLevel;
+            MessageTemplate = DefaultRequestCompletionMessageTemplate;
+        }
     }
 }
diff --git a/src/Serilog.AspNetCore/SerilogApplicationBuilderExtensions.cs b/src/Serilog.AspNetCore/SerilogApplicationBuilderExtensions.cs
index 838fd94..b163fc7 100644
--- a/src/Serilog.AspNetCore/SerilogApplicationBuilderExtensions.cs
+++ b/src/Serilog.AspNetCore/SerilogApplicationBuilderExtensions.cs
@@ -1,4 +1,4 @@
-// Copyright 2019 Serilog Contributors
+// Copyright 2019-2020 Serilog Contributors
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -13,10 +13,12 @@
 // limitations under the License.
 
 using System;
+
 using Microsoft.AspNetCore.Builder;
-using Microsoft.AspNetCore.Http;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Options;
+
 using Serilog.AspNetCore;
-using Serilog.Events;
 
 namespace Serilog
 {
@@ -25,16 +27,6 @@ namespace Serilog
     /// </summary>
     public static class SerilogApplicationBuilderExtensions
     {
-        const string DefaultRequestCompletionMessageTemplate =
-            "HTTP {RequestMethod} {RequestPath} responded {StatusCode} in {Elapsed:0.0000} ms";
-
-        static LogEventLevel DefaultGetLevel(HttpContext ctx, double _, Exception ex) =>
-            ex != null
-                ? LogEventLevel.Error 
-                : ctx.Response.StatusCode > 499 
-                    ? LogEventLevel.Error 
-                    : LogEventLevel.Information;
-
         /// <summary>
         /// Adds middleware for streamlined request logging. Instead of writing HTTP request information
         /// like method, path, timing, status code and exception details
@@ -70,12 +62,9 @@ public static IApplicationBuilder UseSerilogRequestLogging(
             Action<RequestLoggingOptions> configureOptions = null)
         {
             if (app == null) throw new ArgumentNullException(nameof(app));
-            
-            var opts = new RequestLoggingOptions
-            {
-                GetLevel = DefaultGetLevel,
-                MessageTemplate = DefaultRequestCompletionMessageTemplate
-            };
+
+            var opts = app.ApplicationServices.GetService<IOptions<RequestLoggingOptions>>()?.Value ?? new RequestLoggingOptions();
+
             configureOptions?.Invoke(opts);
 
             if (opts.MessageTemplate == null)
diff --git a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
index d6e81ac..99eef06 100644
--- a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
+++ b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
@@ -14,9 +14,17 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.2.0" />
-    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.1" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.6.1" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.4.2" PrivateAssets="All" />
     <PackageReference Include="xunit" Version="2.4.1" />
   </ItemGroup>
 
+  <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp3.1'">
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="3.1.5" />
+  </ItemGroup>
+
+  <ItemGroup Condition="'$(TargetFramework)' == 'netcoreapp2.1'">
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="2.1.3" />
+  </ItemGroup>
+
 </Project>
diff --git a/test/Serilog.AspNetCore.Tests/SerilogWebHostBuilderExtensionsTests.cs b/test/Serilog.AspNetCore.Tests/SerilogWebHostBuilderExtensionsTests.cs
index 6aa9b1f..e95368d 100644
--- a/test/Serilog.AspNetCore.Tests/SerilogWebHostBuilderExtensionsTests.cs
+++ b/test/Serilog.AspNetCore.Tests/SerilogWebHostBuilderExtensionsTests.cs
@@ -1,16 +1,103 @@
 // Copyright (c) .NET Foundation. All rights reserved.
 // Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
 
+using System;
+using System.Linq;
+using System.Threading.Tasks;
+
 using Xunit;
 
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc.Testing;
+using Microsoft.AspNetCore.Builder;
+
+using Serilog.Filters;
+using Serilog.AspNetCore.Tests.Support;
+
 namespace Serilog.AspNetCore.Tests
 {
-    public class SerilogWebHostBuilderExtensionsTests
+    public class SerilogWebHostBuilderExtensionsTests : IClassFixture<SerilogWebApplicationFactory>
     {
+        SerilogWebApplicationFactory _web;
+
+        public SerilogWebHostBuilderExtensionsTests(SerilogWebApplicationFactory web)
+        {
+            _web = web;
+        }
+
+        [Theory]
+        [InlineData(true)]
+        [InlineData(false)]
+        public async Task DisposeShouldBeHandled(bool dispose)
+        {
+            var logger = new DisposeTrackingLogger();
+            using (var web = Setup(logger, dispose))
+            {
+                await web.CreateClient().GetAsync("/");
+            }
+
+            Assert.Equal(dispose, logger.IsDisposed);
+        }
+
         [Fact]
-        public void Todo()
+        public async Task RequestLoggingMiddlewareShouldEnrich()
         {
+            var (sink, web) = Setup(options =>
+            {
+                options.EnrichDiagnosticContext += (diagnosticContext, httpContext) =>
+                {
+                    diagnosticContext.Set("SomeInteger", 42);
+                };
+            });
+
+            await web.CreateClient().GetAsync("/resource");
+
+            Assert.NotEmpty(sink.Writes);
+
+            var completionEvent = sink.Writes.Where(logEvent => Matching.FromSource<RequestLoggingMiddleware>()(logEvent)).FirstOrDefault();
+
+            Assert.Equal(42, completionEvent.Properties["SomeInteger"].LiteralValue());
+            Assert.Equal("string", completionEvent.Properties["SomeString"].LiteralValue());
+            Assert.Equal("/resource", completionEvent.Properties["RequestPath"].LiteralValue());
+            Assert.Equal(200, completionEvent.Properties["StatusCode"].LiteralValue());
+            Assert.Equal("GET", completionEvent.Properties["RequestMethod"].LiteralValue());
+            Assert.True(completionEvent.Properties.ContainsKey("Elapsed"));
+        }
+
+        WebApplicationFactory<TestStartup> Setup(ILogger logger, bool dispose, Action<RequestLoggingOptions> configureOptions = null)
+        {
+            var web = _web.WithWebHostBuilder(
+                builder => builder
+                    .ConfigureServices(sc => sc.Configure<RequestLoggingOptions>(options =>
+                    {
+                        options.Logger = logger;
+                        options.EnrichDiagnosticContext += (diagnosticContext, httpContext) =>
+                        {
+                            diagnosticContext.Set("SomeString", "string");
+                        };
+                    }))
+                    .Configure(app =>
+                    {
+                        app.UseSerilogRequestLogging(configureOptions);
+                        app.Run(_ => Task.CompletedTask); // 200 OK
+                    })
+                    .UseSerilog(logger, dispose));
+
+            return web;
+        }
+
+        (SerilogSink, WebApplicationFactory<TestStartup>) Setup(Action<RequestLoggingOptions> configureOptions = null)
+        {
+            var sink = new SerilogSink();
+            var logger = new LoggerConfiguration()
+                .Enrich.FromLogContext()
+                .WriteTo.Sink(sink)
+                .CreateLogger();
+
+            var web = Setup(logger, true, configureOptions);
 
+            return (sink, web);
         }
     }
 }
\ No newline at end of file
diff --git a/test/Serilog.AspNetCore.Tests/Support/Extensions.cs b/test/Serilog.AspNetCore.Tests/Support/Extensions.cs
new file mode 100644
index 0000000..54e6a1f
--- /dev/null
+++ b/test/Serilog.AspNetCore.Tests/Support/Extensions.cs
@@ -0,0 +1,12 @@
+using Serilog.Events;
+
+namespace Serilog.AspNetCore.Tests.Support
+{
+    public static class Extensions
+    {
+        public static object LiteralValue(this LogEventPropertyValue @this)
+        {
+            return ((ScalarValue)@this).Value;
+        }
+    }
+}
diff --git a/test/Serilog.AspNetCore.Tests/Support/SerilogWebApplicationFactory.cs b/test/Serilog.AspNetCore.Tests/Support/SerilogWebApplicationFactory.cs
new file mode 100644
index 0000000..92e5d09
--- /dev/null
+++ b/test/Serilog.AspNetCore.Tests/Support/SerilogWebApplicationFactory.cs
@@ -0,0 +1,13 @@
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc.Testing;
+
+namespace Serilog.AspNetCore.Tests.Support
+{
+    public class SerilogWebApplicationFactory : WebApplicationFactory<TestStartup>
+    {
+        protected override IWebHostBuilder CreateWebHostBuilder() => new WebHostBuilder().UseStartup<TestStartup>();
+        protected override void ConfigureWebHost(IWebHostBuilder builder) => builder.UseContentRoot(".");
+    }
+
+    public class TestStartup { }
+}

From 1af66c29b639503d4d9010065c0bff28ca6d78d5 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Fri, 24 Jul 2020 11:18:53 +1000
Subject: [PATCH 23/24] Drop the -dev suffix from the
 Serilog.Extensions.Hosting dependency

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 316d955..31f5836 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -27,7 +27,7 @@
 
   <ItemGroup>
     <PackageReference Include="Serilog" Version="2.9.0" />
-    <PackageReference Include="Serilog.Extensions.Hosting" Version="3.1.0-dev-*" />
+    <PackageReference Include="Serilog.Extensions.Hosting" Version="3.1.0" />
     <PackageReference Include="Serilog.Sinks.Console" Version="3.1.1" />
     <PackageReference Include="Serilog.Sinks.File" Version="4.1.0" />
     <PackageReference Include="Serilog.Sinks.Debug" Version="1.0.1" />

From d05c38c26d3441921bbd51fd8b8cef6bb1f87fc2 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Fri, 24 Jul 2020 11:39:08 +1000
Subject: [PATCH 24/24] Work around 500 error when attempting to publish
 symbols

---
 appveyor.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/appveyor.yml b/appveyor.yml
index 6f56235..39b0037 100644
--- a/appveyor.yml
+++ b/appveyor.yml
@@ -10,6 +10,7 @@ artifacts:
 - path: artifacts/Serilog.*.nupkg
 deploy:
 - provider: NuGet
+  skip_symbols: true
   api_key:
     secure: jZtLAmD4ALF9x1BZR1DiV3KhKlliWbzRUAw73xfMZaBsvz19123qLz2zw1+hPdcn
   on: