feat: add semantic logging support for Akka.NET 1.5.56+#294
Merged
Arkatufus merged 11 commits intoDec 3, 2025
Merged
Conversation
Enhances SerilogLogger to leverage Akka.NET's new semantic logging APIs introduced in version 1.5.56. This change enables structured logging with proper message template and parameter extraction. Changes: - Modified SerilogLogger.GetFormat() and GetArgs() to unwrap SerilogPayload and use semantic logging pattern (checks for LogMessage and extracts template) - Serilog now receives proper message templates instead of formatted strings - Added comprehensive test suite (SemanticLoggingSpecs.cs) with 9 tests covering: * Named and positional template properties * Multiple properties handling * Destructuring operator (@) support * Stringification operator ($) support * Format specifiers handling * ForContext integration * Akka metadata preservation All existing tests pass (765 tests). Backwards compatible with earlier Akka.NET versions through LogMessage type checking. Depends on: Akka.NET >= 1.5.56
- Updated Akka.NET dependency from 1.5.25 to 1.5.56 - Commented out OutputType and StartupObject in test project to enable test discovery - Added xunit.runner.visualstudio package for better IDE integration - Required for semantic logging API support
This was referenced Nov 20, 2025
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds semantic logging support to leverage Akka.NET's new semantic logging APIs introduced in version 1.5.56.
This enhancement enables Serilog to receive properly structured message templates and parameters instead of pre-formatted strings, enabling richer structured logging capabilities.
Changes
GetFormat()andGetArgs()methods to unwrapSerilogPayloadand use semantic logging patternTest Coverage
New test suite includes:
@) support$) support:N2) handlingAll 765 existing tests pass.
Backwards Compatibility
Fully backwards compatible through
LogMessagetype checking. Works with both older and newer Akka.NET versions.Dependencies
Requires Akka.NET >= 1.5.56 (not yet released)
Notes