Fixed:

• v9 over-escapes log bodies: quotes, <, >, & and non-ASCII are unicode-escaped (regression from v8) by @olsh

Full Changelog: v9.0.0...v9.0.1

🚀 The reasons behind v9 - a ground-up rewrite

v9 is a ground-up rewrite of the sink on Serilog 4.x native batching, with a streaming serialization pipeline. On the common workload it allocates ~55× less and runs ~4.5× faster than v8 - see Benchmarks.

Implemented:

• Add support for actual structured metadata
• Support the work with Serilog's properties TraceId & SpanId
• Change queueLimit from infinity to prevent OutOfMemoryException
• Loki Url is not validated on bootstrap
• Pluggable exception serialization via ILokiExceptionFormatter

Fixed:

• Exception while emitting periodic batch from LokiSink
• Level property keeps getting renamed and added to the LokiLogEvent if the grafana server is down
• Handling of Serilog.Events.LogEvent in LokiBatchFormatter is not thread-safe
• Tenant RegExpression is not valid for valid X-Scope-OrgID header values
• Property doesn't render correctly if property, used as a part of it is mapped to the label
• Message template is not updated while property renaming
• Default value of period is not corresponding the XML-doc

Breaking changes:

• Targets net8.0, net9.0, net10.0 (all earlier TFMs are EOL); requires Serilog 4.3.1+; FSharp.Core becomes a transitive dependency
• batchPostingLimit → batchSizeLimit; queueLimit is now bounded by default (50 000)
• Removed IReservedPropertyRenamingStrategy / reservedPropertyRenamingStrategy, useInternalTimestamp, leavePropertiesIntact
• Removed the ILokiHttpClient hierarchy (LokiHttpClient, LokiGzipHttpClient) - inject a standard HttpClient or HttpMessageHandler; gzip is a DelegatingHandler concern
• Fatal is rendered as fatal (was critical) - update dashboards/alerts
• Properties promoted via propertiesAsLabels are also kept in the log body; reserved body keys are prefixed with _
• uri and tenant are validated at startup (throw ArgumentException)

📚 Before upgrading, please read Upgrading from v8 to v9 and Breaking changes.

Full Changelog: v8.3.2...v9.0.0

Fixed:

• ~fix tenant regex validation by @smolo-de

Fixed:

• Sink throws when JsonSerializer Reflection Is Disabled in .NET 8.0 by @baliestri

Implemented

• Add nanosecond support for timestamps for versions prior to .NET 7 thanks @danielhuntleyalpine for the suggestion

Implemented

• Allow override of LokiJsonTextFormatter.Format
• Review dependencies and use minimal required version
• Tenant header for multitenancy by @mgalczynski
• Allow override of LokiJsonTextFormatter.Format
• Public assemblies should have a strong name)

Fixed:

• Lack of microseconds and nanoseconds in .NET 7 and later by @Zagrebelin
• Fix typo in project url by @tom-englert

New Contributors

• @mgalczynski made their first contribution in #194
• @Zagrebelin made their first contribution in #209
• @tom-englert made their first contribution in #214

Full Changelog: v8.1.0...v8.2.0

Implemented:

• Public assemblies should have a strong name)

Fixed:

• Fix typo in project url by @tom-englert

Fixed:

• Lack of microseconds and nanoseconds in .NET 7 and later

Implemented:

• Tenant header for multitenancy
• Extended assess to protected for Allow override of LokiJsonTextFormatter.Format

Stabilization release.

• Allow override of LokiJsonTextFormatter.Format
• Review dependencies and use minimal required version