Upgrade project to .NET 10 and Serilog batching sink

Updates target frameworks to include .NET 10.0 across the library and samples.
Refactors the Exceptionless sink to implement `IBatchedLogEventSink`, improving efficiency by processing log events in batches.
Modernizes sample applications to use ASP.NET Core Minimal APIs and demonstrates proper async flushing of logs.
Also includes various dependency updates for GitHub Actions and NuGet packages, and modernizes CI package publishing.

Author: niemyjski

.github/workflows/build-linux.yml

@@ -7,19 +7,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         fetch-depth: 0
     - name: Setup .NET Core
-      uses: actions/setup-dotnet@v4
+      uses: actions/setup-dotnet@v5
       with:
-        dotnet-version: 8.x
+        dotnet-version: |
+          8.x
+          10.x
     - name: Build Reason
       run: "echo ref: ${{github.ref}} event: ${{github.event_name}}"
     - name: Build Version
       shell: bash
       run: |
-        dotnet tool install --global minver-cli --version 5.0.0
+        dotnet tool install --global minver-cli --version 7.0.0
         version=$(minver --tag-prefix v)
         echo "MINVERVERSIONOVERRIDE=$version" >> $GITHUB_ENV
     - name: Build

.github/workflows/build-osx.yml

@@ -7,19 +7,21 @@ jobs:
     runs-on: macOS-latest
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         fetch-depth: 0
     - name: Setup .NET Core
-      uses: actions/setup-dotnet@v4
+      uses: actions/setup-dotnet@v5
       with:
-        dotnet-version: 8.x
+        dotnet-version: |
+          8.x
+          10.x
     - name: Build Reason
       run: "echo ref: ${{github.ref}} event: ${{github.event_name}}"
     - name: Build Version
       shell: bash
       run: |
-        dotnet tool install --global minver-cli --version 5.0.0
+        dotnet tool install --global minver-cli --version 7.0.0
         version=$(minver --tag-prefix v)
         echo "MINVERVERSIONOVERRIDE=$version" >> $GITHUB_ENV
     - name: Build

.github/workflows/build-windows.yml

@@ -7,19 +7,21 @@ jobs:
     runs-on: windows-latest
     steps:
     - name: Checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
       with:
         fetch-depth: 0
     - name: Setup .NET Core
-      uses: actions/setup-dotnet@v4
+      uses: actions/setup-dotnet@v5
       with:
-        dotnet-version: 8.x
+        dotnet-version: |
+          8.x
+          10.x
     - name: Build Reason
       run: "echo ref: ${{github.ref}} event: ${{github.event_name}}"
     - name: Build Version
       shell: bash
       run: |
-        dotnet tool install --global minver-cli --version 5.0.0
+        dotnet tool install --global minver-cli --version 7.0.0
         version=$(minver --tag-prefix v)
         echo "MINVERVERSIONOVERRIDE=$version" >> $GITHUB_ENV
     - name: Build
@@ -29,18 +31,15 @@ jobs:
     - name: Package
       if: github.event_name != 'pull_request'
       run: dotnet pack --configuration Release --no-build Serilog.Sinks.Exceptionless.slnx
-    - name: Install GitHub Package Tool
-      if: github.event_name != 'pull_request'
-      run: dotnet tool install gpr -g
     - name: Publish CI Packages
       shell: bash
       if: github.event_name != 'pull_request'
       run: |
-        for package in $(find -name "*.nupkg" | grep "minver" -v); do
+        for package in $(find . -name "*.nupkg" | grep "minver" -v); do
           echo "${0##*/}": Pushing $package...
 
           # GitHub
-          gpr push $package -k ${{ secrets.GITHUB_TOKEN }} || true
+          dotnet nuget push $package --api-key ${{ secrets.GITHUB_TOKEN }} --source https://nuget.pkg.github.com/Exceptionless/index.json --skip-duplicate || true
         done
     - name: Publish Release Packages
       shell: bash

README.md

@@ -45,4 +45,14 @@ _logger.Log(logLevel, eventId, state, exception, formatter);
 
 * [Documentation](https://github.com/serilog/serilog/wiki)
 
-Copyright © 2023 Serilog Contributors - Provided under the [Apache License, Version 2.0](http://apache.org/licenses/LICENSE-2.0.html).
+### Flushing Background Queues
+
+Exceptionless events are queued in memory and submitted to the API in the background. If your application process crashes or exits, pending logs may be lost. You should always ensure that you flush the Serilog sink when shutting down:
+
+```csharp
+await Log.CloseAndFlushAsync(); // Recommended for modern async apps
+// or
+Log.CloseAndFlush();
+```
+
+Copyright © 2026 Serilog Contributors - Provided under the [Apache License, Version 2.0](http://apache.org/licenses/LICENSE-2.0.html).

sample/ConsoleDemo/ConsoleDemo.csproj

@@ -1,13 +1,13 @@
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
         <OutputType>Exe</OutputType>
-        <TargetFrameworks>net8.0</TargetFrameworks>
+        <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
         <IsPackable>false</IsPackable>
     </PropertyGroup>
     <ItemGroup>
       <ProjectReference Include="..\..\src\Serilog.Sinks.Exceptionless\Serilog.Sinks.Exceptionless.csproj" />
     </ItemGroup>
     <ItemGroup>
-      <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
+      <PackageReference Include="Serilog.Sinks.Console" Version="6.1.1" />
     </ItemGroup>
 </Project>

sample/ConsoleDemo/Program.cs

@@ -7,7 +7,7 @@ namespace ConsoleDemo
 {
     public class Program
     {
-        public static void Main()
+        public static async System.Threading.Tasks.Task Main()
         {
             ExceptionlessClient.Default.Startup("API_KEY");
 
@@ -30,7 +30,7 @@ public static void Main()
                 Log.Error(ex, "Something went wrong");
             }
 
-            Log.CloseAndFlush();
+            await Log.CloseAndFlushAsync();
         }
 
         private static void Fail()

sample/SampleWeb/Authentication/TestAuthenticationHandler.cs

@@ -11,8 +11,8 @@ namespace SampleWeb.Authentication
     public class TestAuthenticationHandler : AuthenticationHandler<AuthenticationSchemeOptions>
     {
         public TestAuthenticationHandler(IOptionsMonitor<AuthenticationSchemeOptions> options,
-            ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock)
-            : base(options, logger, encoder, clock)
+            ILoggerFactory logger, UrlEncoder encoder)
+            : base(options, logger, encoder)
         {
         }
 

sample/SampleWeb/Controllers/ValuesController.cs

@@ -1,28 +1,80 @@
 using System;
-using Microsoft.AspNetCore.Hosting;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Security.Claims;
+using Exceptionless;
+using Exceptionless.Models;
+using Exceptionless.Models.Data;
+using Microsoft.AspNetCore.Authentication;
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
+using Microsoft.Extensions.Logging;
+using SampleWeb.Authentication;
 using Serilog;
+using Serilog.Context;
 
-namespace SampleWeb
+var builder = WebApplication.CreateBuilder(args);
+
+builder.Host.UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
+    .ReadFrom.Configuration(hostingContext.Configuration)
+    .Enrich.FromLogContext()
+    .WriteTo.Debug()
+    .WriteTo.Console()
+    .WriteTo.Exceptionless());
+
+builder.Services.AddAuthentication("Test").AddScheme<AuthenticationSchemeOptions, TestAuthenticationHandler>("Test", options => { });
+builder.Services.AddAuthorization();
+builder.Services.AddHttpContextAccessor();
+builder.Services.AddExceptionless("API_KEY");
+
+var app = builder.Build();
+
+app.UseExceptionless();
+app.UseSerilogRequestLogging();
+app.UseHttpsRedirection();
+app.UseAuthentication();
+app.UseAuthorization();
+
+app.MapGet("/values", (ClaimsPrincipal user, ILogger<Program> logger) =>
+{
+    using var _ = logger.BeginScope(new Dictionary<string, object> { ["Tags"] = new string[] { "Tag1", "Tag2" } });
+    logger.LogInformation("Get was called");
+
+    return $"[{Activity.Current?.Id}] {user.Identity?.Name}";
+});
+
+app.MapGet("/values/advanced-topic-user", (ClaimsPrincipal user, ILogger<Program> logger) =>
+{
+    using (LogContext.PushProperty(Event.KnownDataKeys.UserInfo, new UserInfo(user.Identity?.Name + " Custom", "Test User Full Name"), true))
+    {
+        logger.LogInformation("This log event will have a custom user set.");
+    }
+
+    return $"[{Activity.Current?.Id}] {user.Identity?.Name}";
+});
+
+app.MapGet("/values/advanced-topic-user-description", ([FromQuery] string description, ClaimsPrincipal user, ILogger<Program> logger) =>
 {
-    public class Program
+    using (LogContext.PushProperty(Event.KnownDataKeys.UserDescription, new UserDescription(user.Identity?.Name, description), true))
     {
-        public static void Main(string[] args)
-        {
-            CreateHostBuilder(args).Build().Run();
-        }
-
-        public static IHostBuilder CreateHostBuilder(string[] args)
-        {
-            return Host.CreateDefaultBuilder(args)
-                .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>())
-                .UseSerilog((hostingContext, services, loggerConfiguration) => loggerConfiguration
-                    .ReadFrom.Configuration(hostingContext.Configuration)
-                    .Enrich.FromLogContext()
-                    .WriteTo.Debug()
-                    .WriteTo.Console()
-                    .WriteTo.Exceptionless()
-                );
-        }
+        logger.LogError(new Exception("Test"), "This error event will have a user description set on it.");
     }
+
+    return $"[{Activity.Current?.Id}] {user.Identity?.Name}";
+});
+
+try
+{
+    Log.Information("Starting web host");
+    await app.RunAsync();
+}
+catch (Exception ex)
+{
+    Log.Fatal(ex, "Host terminated unexpectedly");
+}
+finally
+{
+    await Log.CloseAndFlushAsync();
 }

sample/SampleWeb/Program.cs

@@ -1,12 +1,12 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
     <PropertyGroup>
-        <TargetFramework>net8.0</TargetFramework>
+        <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
         <IsPackable>false</IsPackable>
     </PropertyGroup>
 
     <ItemGroup>
         <PackageReference Include="Exceptionless.AspNetCore" Version="6.0.4" />
-        <PackageReference Include="Serilog.AspNetCore" Version="8.0.1" />
+        <PackageReference Include="Serilog.AspNetCore" Version="10.0.0" />
     </ItemGroup>
 
     <ItemGroup>