22.0.0

October 2023 (version 22.0.0) aka Swiss Locomotive release

Codenamed as Swiss Locomotive
Read the Docs: Ocelot 22.0

Focused On

Logging feature. Performance review, redesign and improvements with new best practices to log

• Proposing a centralized WriteLog method for the OcelotLogger
• Factory methods for computed strings such as string.Format or interpolated strings
• Using ILogger.IsEnabled before calling the native WriteLog implementation and invoking string factory method

Quality of Service feature. Redesign and stabilization, and it produces less log records now.

• Fixing issue with Polly Circuit Breaker not opening after max number of retries reached
• Removing useless log calls that could have an impact on performance
• Polly lib reference updating to latest 8.2.0 with some code improvements

Documentation for Logging, Request ID, Routing and Websockets

• Logging
• Request ID
• Routing
• Websockets

Testing improvements and stabilization aka bug fixing

• Routing bug fixing: query string placeholders including CatchAll one aka {everything} and query string duplicates removal
• QoS bug fixing: Polly circuit breaker exceptions
• Testing bug fixing: rare failed builds because of unstable Polly tests. Acceptance common logic for ports

Honoring 🏅 aka Top Contributors 👏

1^st 🥇 goes to Guillaume Gnaegi for delivering 2 features in 99 files changed
2^nd 🥈 goes to Raynald Messié for delivering 2 features in 15 files changed
3^rd 🥉 goes to @jlukawska for delivering 1 feature in 51 files changed

Starring ⭐ aka Release Influencers

⭐⭐⭐ @raman-m
⭐⭐ Guillaume Gnaegi, @ggnaegi
⭐⭐ Raynald Messié, @RaynaldM
⭐ Samuel Poirier, @sam9291
⭐ Stjepan, @wast
⭐ @jlukawska

Features in Release 22.0.0

Logbook

• _{349825f by raman-m on Tuesday, November 28 at 15:45 →}
  Switch off the PublishToNuget task
• _{22bc5b6 by raman-m on Monday, November 27 at 22:05 →}
  Release 22.0 | +semver: breaking
• _{b2246a5 by Raynald Messié on Friday, November 24 at 23:21 →}
  #1783 Less logs for circuit breakers (Polly exceptions) (#1786)
• _{388ebc3 by Guillaume Gnaegi on Friday, November 24 at 21:59 →}
  #1744 Avoid calls to 'Logger.Log' if LogLevel not enabled in appsettings.json (#1745)
• _{04ad9bf by raman-m on Tuesday, November 21 at 19:56 →}
  Resolve issues with projects after auto-merging. Format Document
• _{ec55504 by Samuel Poirier on Saturday, November 04 at 13:15 →}
  #1179 Add missing documentation for Secured WebSocket #1180
• _{dabb4b5 by Guillaume Gnaegi on Saturday, November 04 at 09:27 →}
  #1550 #1706 Addressing the QoS options ExceptionsAllowedBeforeBreaking issue (#1753)
• _{ae43f32 by Stjepan on Wednesday, November 01 at 12:41 →}
  #952 #1174 Merge query strings without duplicate values (#1182)
• _{ab3d8e6 by jlukawska on Friday, October 27 at 21:20 →}
  Find available port in integration tests (#1173)
• _{3b776a7 by Raynald Messié on Friday, October 13 at 18:40 →}
  #1712 Bump to Polly 8.0 (#1714)