18518043094
83%

Ran 15 Oct 2025 05:48AM UTC

Jobs 1

Files 60

Run time 1min

Badge

Embed ▾

Committed 14 Oct 2025 06:00PM UTC coverage: 86.047% (+0.05%) from 85.997%

Build # 18518043094

Build Type

push

github

Committed by

web-flow

Commit Message

Improved warning for Observer mode (#7433)

This is purely a documentation/info update, which catches a situation
where a correctly configured leaf cluster would fail to elect a meta
leader, but the user would be left completely clueless as to why.

When a cluster is started the first time(!) it will check if leaf nodes
connections to SYS are configured. If this is the case the leaf cluster
MAY be an extension of a hub cluster. It cannot verify this until the
connection is actually made and it can compare jetstream domains (its an
extension only if the domains are the same)
As a result the cluster goes into "Observer mode" in which meta leader
election is deferred till the hub is connection via a SYS leaf node
connection.

BUT, not hint is printed on the FIRST start- only on the SECOND start of
the cluster a hint was printed.
The /healthz probe fails with a 503 and no further details beyond
`"JetStream has not established contact with a meta leader"`

This leaves the user completely clueless as to why the meta leader was
not elected. `nats server report jetstream` also gives no hint as to the
reason.

This change prints the extension_hint warning on first start and extends
the explanation.

[skip ci]

Signed-off-by: Michael Röschter <michael@roeschter.de>

Coverage Stats

74682 of 86792 relevant lines covered (86.05%)

341023.24 hits per line

Coverage Regressions

Lines	Coverage	∆	File
817	82.72	0.16%	src/github.com/nats-io/nats-server/server/jetstream_cluster.go
621	83.64	0.01%	src/github.com/nats-io/nats-server/server/filestore.go
133	87.16	-0.04%	src/github.com/nats-io/nats-server/server/monitor.go
15	86.19	-0.16%	src/github.com/nats-io/nats-server/server/stream.go
11	81.5	0.13%	src/github.com/nats-io/nats-server/server/opts.go
10	87.09	0.09%	src/github.com/nats-io/nats-server/server/raft.go
5	88.72	0.24%	src/github.com/nats-io/nats-server/server/consumer.go
5	73.37	0.61%	src/github.com/nats-io/nats-server/server/jetstream_api.go
5	90.45	-0.12%	src/github.com/nats-io/nats-server/server/leafnode.go
4	94.38	-0.16%	src/github.com/nats-io/nats-server/server/gateway.go
4	93.51	-0.16%	src/github.com/nats-io/nats-server/server/route.go
2	86.35	-0.09%	src/github.com/nats-io/nats-server/server/events.go
2	97.05	-0.16%	src/github.com/nats-io/nats-server/server/sublist.go
1	94.89	-0.02%	src/github.com/nats-io/nats-server/server/client.go

Jobs

ID	Job ID	Ran	Files	Coverage
1	18518043094.1	15 Oct 2025 05:48AM UTC	60	86.05	GitHub Action Run

nats-io / nats-server / 18518043094
83%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 18518043094

nats-io / nats-server / 18518043094 83%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Coverage Regressions

Jobs

Source Files on build 18518043094

nats-io / nats-server / 18518043094
83%

README BADGES
x