Skip to content

feat(zero-cache): restore the ZERO_CHANGE_STREAMER_URI option#4584

Merged
darkgnotic merged 6 commits into
mainfrom
darkgnotic/restore-change-streamer-uri-option
Jul 8, 2025
Merged

feat(zero-cache): restore the ZERO_CHANGE_STREAMER_URI option#4584
darkgnotic merged 6 commits into
mainfrom
darkgnotic/restore-change-streamer-uri-option

Conversation

@darkgnotic
Copy link
Copy Markdown
Contributor

Restore the ZERO_CHANGE_STREAMER_URI option and recommend it as the standard routing mechanism from the view-syncer to replication-manager.

Auto-discovery via ZERO_CHANGE_STREAMER_MODE is still supported but no longer the recommended configuration. An explicit routing component, while requiring additional setup on the developer's part, works for a wider range of production environments.

User report:

@darkgnotic darkgnotic requested a review from aboodman July 8, 2025 17:43
@vercel
Copy link
Copy Markdown

vercel Bot commented Jul 8, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
replicache-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 8, 2025 5:50pm
zbugs ✅ Ready (Inspect) Visit Preview Jul 8, 2025 5:50pm

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jul 8, 2025

🐰 Bencher Report

Branchdarkgnotic/restore-change-streamer-uri-option
TestbedLinux
Click to view all benchmark results
BenchmarkFile SizeBenchmark Result
kilobytes (KB)
(Result Δ%)
Upper Boundary
kilobytes (KB)
(Limit %)
zero-package.tgz📈 view plot
🚷 view threshold
1,212.42 KB
(+0.00%)Baseline: 1,212.41 KB
1,236.66 KB
(98.04%)
zero.js📈 view plot
🚷 view threshold
200.08 KB
(0.00%)Baseline: 200.08 KB
204.08 KB
(98.04%)
zero.js.br📈 view plot
🚷 view threshold
56.13 KB
(0.00%)Baseline: 56.13 KB
57.25 KB
(98.04%)
🐰 View full continuous benchmarking report in Bencher

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jul 8, 2025

🐰 Bencher Report

Branchdarkgnotic/restore-change-streamer-uri-option
TestbedLinux
Click to view all benchmark results
BenchmarkThroughputBenchmark Result
operations / second (ops/s) x 1e3
(Result Δ%)
Lower Boundary
operations / second (ops/s) x 1e3
(Limit %)
src/client/custom.bench.ts > big schema📈 view plot
🚷 view threshold
380.17 ops/s x 1e3
(+4.25%)Baseline: 364.67 ops/s x 1e3
332.07 ops/s x 1e3
(87.35%)
src/client/zero.bench.ts > basics > All 1000 rows x 10 columns (numbers)📈 view plot
🚷 view threshold
1.64 ops/s x 1e3
(+2.21%)Baseline: 1.60 ops/s x 1e3
1.55 ops/s x 1e3
(94.65%)
src/client/zero.bench.ts > pk compare > pk = N📈 view plot
🚷 view threshold
30.51 ops/s x 1e3
(+0.24%)Baseline: 30.43 ops/s x 1e3
29.51 ops/s x 1e3
(96.71%)
src/client/zero.bench.ts > with filter > Lower rows 500 x 10 columns (numbers)📈 view plot
🚷 view threshold
2.61 ops/s x 1e3
(+2.95%)Baseline: 2.53 ops/s x 1e3
2.46 ops/s x 1e3
(94.21%)
🐰 View full continuous benchmarking report in Bencher

@darkgnotic darkgnotic enabled auto-merge (squash) July 8, 2025 17:48
@darkgnotic darkgnotic merged commit adfb1a5 into main Jul 8, 2025
11 checks passed
@darkgnotic darkgnotic deleted the darkgnotic/restore-change-streamer-uri-option branch July 8, 2025 17:51
github-merge-queue Bot pushed a commit that referenced this pull request Dec 2, 2025
…er task registration (#5250)

Restore the original `replication-manager` behavior of delaying the
replication stream takeover to allow the task to be registered as a
healthy target by the load balancer (i.e. after a minimum number of
health checks). This fixes the temporary unreachability of the
replication-manager when the handoff happens before the load-balancer
has recognized the new replication-manager as healthy.

This original functionality was simplified away with the introduction of
auto-discovery (#4335), since that
replaced the dns and proxying component, but never restored when
proxy-based routing was reintroduced in
#4584 (and is now the recommended
configuration).

This new implementation is more compartmentalized than the original
implementation, encapsulating all of the logic in the
ChangeStreamerHttpService, so that the ChangeStreamerService itself is
agnostic to the details of health checks and startup delays.
darkgnotic added a commit that referenced this pull request Dec 2, 2025
…er task registration (#5250)

Restore the original `replication-manager` behavior of delaying the
replication stream takeover to allow the task to be registered as a
healthy target by the load balancer (i.e. after a minimum number of
health checks). This fixes the temporary unreachability of the
replication-manager when the handoff happens before the load-balancer
has recognized the new replication-manager as healthy.

This original functionality was simplified away with the introduction of
auto-discovery (#4335), since that
replaced the dns and proxying component, but never restored when
proxy-based routing was reintroduced in
#4584 (and is now the recommended
configuration).

This new implementation is more compartmentalized than the original
implementation, encapsulating all of the logic in the
ChangeStreamerHttpService, so that the ChangeStreamerService itself is
agnostic to the details of health checks and startup delays.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant