github.com/redis/go-redis/v9

🚀 Highlights

Redis 8.6 Support

Added support for Redis 8.6, including new commands and features for streams idempotent production and HOTKEYS.

Smart Client Handoff (Maintenance Notifications) for Cluster

This release introduces comprehensive support for Redis Cluster maintenance notifications via SMIGRATING/SMIGRATED push notifications. The client now automatically handles slot migrations by:

• Relaxing timeouts during migration (SMIGRATING) to prevent false failures
• Triggering lazy cluster state reloads upon completion (SMIGRATED)
• Enabling seamless operations during Redis Enterprise maintenance windows

(#3643) by @ndyakov

OpenTelemetry Native Metrics Support

Added comprehensive OpenTelemetry metrics support following the OpenTelemetry Database Client Semantic Conventions. The implementation uses a Bridge Pattern to keep the core library dependency-free while providing optional metrics instrumentation through the new extra/redisotel-native package.

Metric groups include:

• Command metrics: Operation duration with retry tracking
• Connection basic: Connection count and creation time
• Resiliency: Errors, handoffs, timeout relaxation
• Connection advanced: Wait time and use time
• Pubsub metrics: Published and received messages
• Stream metrics: Processing duration and maintenance notifications

(#3637) by @ofekshenawa

✨ New Features

• HOTKEYS Commands: Added support for Redis HOTKEYS feature for identifying hot keys based on CPU consumption and network utilization (#3695) by @ofekshenawa
• Streams Idempotent Production: Added support for Redis 8.6+ Streams Idempotent Production with ProducerID, IdempotentID, IdempotentAuto in XAddArgs and new XCFGSET command (#3693) by @ofekshenawa
• NaN Values for TimeSeries: Added support for NaN (Not a Number) values in Redis time series commands (#3687) by @ofekshenawa
• DialerRetries Options: Added DialerRetries and DialerRetryTimeout to ClusterOptions, RingOptions, and FailoverOptions (#3686) by @naveenchander30
• ConnMaxLifetimeJitter: Added jitter configuration to distribute connection expiration times and prevent thundering herd (#3666) by @cyningsun
• Digest Helper Functions: Added DigestString and DigestBytes helper functions for client-side xxh3 hashing compatible with Redis DIGEST command (#3679) by @ofekshenawa
• SMIGRATED New Format: Updated SMIGRATED parser to support new format and remember original host:port (#3697) by @ndyakov
• Cluster State Reload Interval: Added cluster state reload interval option for maintenance notifications (#3663) by @ndyakov

🐛 Bug Fixes

• PubSub nil pointer dereference: Fixed nil pointer dereference in PubSub after WithTimeout() - pubSubPool is now properly cloned (#3710) by @Copilot
• MaintNotificationsConfig nil check: Guard against nil MaintNotificationsConfig in initConn (#3707) by @veeceey
• wantConnQueue zombie elements: Fixed zombie wantConn elements accumulation in wantConnQueue (#3680) by @cyningsun
• XADD/XTRIM approx flag: Fixed XADD and XTRIM to use = when approx is false (#3684) by @ndyakov
• Sentinel timeout retry: When connection to a sentinel times out, attempt to connect to other sentinels (#3654) by @cxljs

⚡ Performance

• Fuzz test optimization: Eliminated repeated string conversions, used functional approach for cleaner operation selection (#3692) by @feiguoL
• Pre-allocate capacity: Pre-allocate slice capacity to prevent multiple capacity expansions (#3689) by @feelshu

🧪 Testing

• Comprehensive TLS tests: Added comprehensive TLS tests and example for standalone, cluster, and certificate authentication (#3681) by @ndyakov
• Redis 8.6: Updated CI to use Redis 8.6-pre (#3685) by @ndyakov

🧰 Maintenance

• Deprecation warnings: Added deprecation warnings for commands based on Redis documentation (#3673) by @ndyakov
• Use errors.Join(): Replaced custom error join function with standard library errors.Join() (#3653) by @cxljs
• Use Go 1.21 min/max: Use Go 1.21's built-in min/max functions (#3656) by @cxljs
• Proper formatting: Code formatting improvements (#3670) by @12ya
• Set commands documentation: Added comprehensive documentation to all set command methods (#3642) by @iamamirsalehi
• MaxActiveConns docs: Added default value documentation for MaxActiveConns (#3674) by @codykaup
• README example update: Updated README example (#3657) by @cxljs
• Cluster maintnotif example: Added example application for cluster maintenance notifications (#3651) by @ndyakov

👥 Contributors

We'd like to thank all the contributors who worked on this release!

@12ya, @Copilot, @codykaup, @cxljs, @cyningsun, @feelshu, @feiguoL, @iamamirsalehi, @naveenchander30, @ndyakov, @ofekshenawa, @veeceey

---

Full Changelog: https://github.com/redis/go-redis/compare/v9.17.0...v9.18.0

🚀 Highlights

Go Version Update

This release updates the minimum required Go version to 1.21. This is part of a gradual migration strategy where the minimum supported Go version will be three versions behind the latest release. With each new Go version release, we will bump the minimum version by one, ensuring compatibility while staying current with the Go ecosystem.

Stability Improvements

This release includes several important stability fixes:

• Fixed a critical panic in the handoff worker manager that could occur when handling nil errors
• Improved test reliability for Smart Client Handoff functionality
• Fixed logging format issues that could cause runtime errors

✨ New Features

• OpenTelemetry metrics improvements for nil response handling (#3638) by @fengve

🐛 Bug Fixes

• Fixed panic on nil error in handoffWorkerManager closeConnFromRequest (#3633) by @ccoVeille
• Fixed bad sprintf syntax in logging (#3632) by @ccoVeille

🧰 Maintenance

• Updated minimum Go version to 1.21 (#3640) by @ndyakov
• Use Go 1.20 idiomatic string<->byte conversion (#3435) by @justinhwang
• Reduce flakiness of Smart Client Handoff test (#3641) by @kiryazovi-redis
• Revert PR #3634 (Observability metrics phase1) (#3635) by @ofekshenawa

👥 Contributors

We'd like to thank all the contributors who worked on this release!

@justinhwang, @ndyakov, @kiryazovi-redis, @fengve, @ccoVeille, @ofekshenawa

---

Full Changelog: https://github.com/redis/go-redis/compare/v9.18.0-beta.1...v9.18.0-beta.2

🚀 Highlights

Request and Response Policy Based Routing in Cluster Mode

This beta release introduces comprehensive support for Redis COMMAND-based request and response policy routing for cluster clients. This feature enables intelligent command routing and response aggregation based on Redis command metadata.

Key Features:

• Command Policy Loader: Automatically parses and caches COMMAND metadata with routing/aggregation hints
• Enhanced Routing Engine: Supports all request policies including:
  • default(keyless) - Commands without keys
  • default(hashslot) - Commands with hash slot routing
  • all_shards - Commands that need to run on all shards
  • all_nodes - Commands that need to run on all nodes
  • multi_shard - Commands that span multiple shards
  • special - Commands with custom routing logic
• Response Aggregator: Intelligently combines multi-shard replies based on response policies:
  • all_succeeded - All shards must succeed
  • one_succeeded - At least one shard must succeed
  • agg_sum - Aggregate numeric responses
  • special - Custom aggregation logic (e.g., FT.CURSOR)
• Raw Command Support: Policies are enforced on Client.Do(ctx, args...)

This feature is particularly useful for Redis Stack commands like RediSearch that need to operate across multiple shards in a cluster.

Connection Pool Improvements

Fixed a critical defect in the connection pool's turn management mechanism that could lead to connection leaks under certain conditions. The fix ensures proper 1:1 correspondence between turns and connections.

✨ New Features

• Request and Response Policy Based Routing in Cluster Mode (#3422) by @ofekshenawa

🐛 Bug Fixes

• Fixed connection pool turn management to prevent connection leaks (#3626) by @cyningsun

🧰 Maintenance

• chore(deps): bump rojopolis/spellcheck-github-actions from 0.54.0 to 0.55.0 (#3627)

👥 Contributors

We'd like to thank all the contributors who worked on this release!

@cyningsun, @ofekshenawa, @ndyakov

---

Full Changelog: https://github.com/redis/go-redis/compare/v9.17.1...v9.18.0-beta.1