Skip to content

the panel chart cached one chain's 7d series and served it on every other tab - #3364

Merged
Flotapponnier merged 1 commit into
devfrom
fix/panel-chart-reuses-first-chain
Oct 29, 2026
Merged

Flotapponnier merged 1 commit into
devfrom
fix/panel-chart-reuses-first-chain

Conversation

@Flotapponnier

Copy link
Copy Markdown
Collaborator

This is the bug Lucas reported. #3362 was not it, and its description has been corrected.

The symptom, and the clue that solved it

Bench 001's First to report showed the same shares on Base, BNB Chain, Solana and Robinhood Chain, while Head lag right beside it moved per chain.

Florent narrowed it to "only 7D and 30D", which is the whole diagnosis. 1H, 6H and 24H render from the embedded per-filter series that ships with the page. 7D, 30D, 90D and 1Y are lazy-fetched, and only those were wrong.

The cause

The lazy panel caches were keyed by panel id alone:

if (lazyPanel7d[activePanelId] && lazyPanel30d[activePanelId]) return;

The effects do list chainProp in their dependencies and do re-run on a tab change, and the fetch URL has carried the chain ever since the main series was fixed for this same reason (see the chain prop docs in index.tsx). It never got that far: the first chain a reader opened filled the entry, and every later chain hit that guard and returned before fetching.

That is also why the server looked innocent. The API answers correctly for every chain; nobody was asking it a second time.

What was published

Measured against the live series with EU-WEST selected, as in the report:

chain real leader share what the chart showed
Base Serialized 74.7 % Codex ahead
BNB Chain Mobula 64.8 % Codex ahead
Robinhood Chain Serialized 93.3 % Codex ahead
Solana Codex 73.4 % right, by luck

So three chains out of four named the wrong leader, which is worse than the "same numbers everywhere" it looked like.

The fix

Keyed on panel + chain + region + tier, through one panelSeriesCacheKey helper, reads and writes together.

The 90d/1y writes are included deliberately. A first pass rekeyed their reads and left their writes on the old key, which would have made that cache never hit and refetch on every render. Checking the write sites caught it before it shipped.

Seven tests on the key, including the two orderings a naive concatenation would collide (chain=a,region=b must not equal chain=ab).

Gates

pnpm test 770 pass 0 fail, tsc --noEmit clean, eslint clean on the touched files (the one warning in chart.tsx about a zoom dependency is pre-existing).

Needs a cherry-pick to main: production is where Lucas is looking.

…ther tab

This is the bug Lucas actually reported, and #3362 was not it.

Bench 001's First to report showed the same shares on Base, BNB, Solana and
Robinhood while head lag beside it moved per chain. Florent narrowed it to
"only 7D and 30D", which is the whole diagnosis: 1H, 6H and 24H render from
the embedded per-filter series, and 7D, 30D, 90D and 1Y are lazy-fetched.

The lazy caches were keyed by panel id alone:

    if (lazyPanel7d[activePanelId] && lazyPanel30d[activePanelId]) return;

The effects DO list chainProp in their deps and DO re-run on a tab change, and
the fetch URL has carried the chain since the main series was fixed for this
same reason. It never got there: the first chain opened filled the entry, and
every later chain hit that guard and returned before fetching.

What it published, measured against the live series with EU-WEST selected:

    base       Serialized 74.7 %     the chart named Codex
    bnb        Mobula     64.8 %     the chart named Codex
    robinhood  Serialized 93.3 %     the chart named Codex
    solana     Codex      73.4 %     right, by luck

So three chains out of four named the wrong leader, which is worse than the
"same numbers everywhere" it looked like.

Keyed on panel + chain + region + tier now, through one panelSeriesCacheKey
helper, reads and writes together. The 90d/1y writes are included: they had
been left on the old key by the first pass, which would have made that cache
never hit and refetch on every render.

Seven tests on the key, including the two orderings a naive concatenation
would collide.

Note #3362 is still a real fix and stays: /api/series rebuilds a panel's
series from the raw spec whenever the blob misses, and that path dropped the
dimensions. It is latent rather than what Lucas saw, because the blob does
carry the per-filter panel series and was answering correctly throughout. The
PR body claimed otherwise and has been corrected.
@Flotapponnier
Flotapponnier merged commit ff4e56f into dev Oct 29, 2026
2 checks passed
@Flotapponnier
Flotapponnier deleted the fix/panel-chart-reuses-first-chain branch October 29, 2026 15:04
Flotapponnier added a commit that referenced this pull request Oct 29, 2026
…ther tab (#3364)

This is the bug Lucas actually reported, and #3362 was not it.

Bench 001's First to report showed the same shares on Base, BNB, Solana and
Robinhood while head lag beside it moved per chain. Florent narrowed it to
"only 7D and 30D", which is the whole diagnosis: 1H, 6H and 24H render from
the embedded per-filter series, and 7D, 30D, 90D and 1Y are lazy-fetched.

The lazy caches were keyed by panel id alone:

    if (lazyPanel7d[activePanelId] && lazyPanel30d[activePanelId]) return;

The effects DO list chainProp in their deps and DO re-run on a tab change, and
the fetch URL has carried the chain since the main series was fixed for this
same reason. It never got there: the first chain opened filled the entry, and
every later chain hit that guard and returned before fetching.

What it published, measured against the live series with EU-WEST selected:

    base       Serialized 74.7 %     the chart named Codex
    bnb        Mobula     64.8 %     the chart named Codex
    robinhood  Serialized 93.3 %     the chart named Codex
    solana     Codex      73.4 %     right, by luck

So three chains out of four named the wrong leader, which is worse than the
"same numbers everywhere" it looked like.

Keyed on panel + chain + region + tier now, through one panelSeriesCacheKey
helper, reads and writes together. The 90d/1y writes are included: they had
been left on the old key by the first pass, which would have made that cache
never hit and refetch on every render.

Seven tests on the key, including the two orderings a naive concatenation
would collide.

Note #3362 is still a real fix and stays: /api/series rebuilds a panel's
series from the raw spec whenever the blob misses, and that path dropped the
dimensions. It is latent rather than what Lucas saw, because the blob does
carry the per-filter panel series and was answering correctly throughout. The
PR body claimed otherwise and has been corrected.
Flotapponnier added a commit that referenced this pull request Oct 29, 2026
… tab (#3363)

* a panel's 7d chart ignored the chain tab, so First to report read the same everywhere (#3362)

Lucas spotted it on production: bench 001's "First to report" view showed
Codex 68.8% and Serialized 29.5% identically on Base, BNB Chain, Solana and
Robinhood Chain, while the head-lag view beside it moved per chain as it
should. The shares are a per-chain race, so one set of numbers on four chains
is not a coincidence, it is an unfiltered query.

It was. Two paths build a panel's PromQL and only one of them scoped it:

  values + 24h series  specToBenchmark -> applyDimensionsToSpec -> injectLabels
  7d + 30d series      /api/series/[slug]?panel=... -> hand-rolled

The second exists because slimBenchmarkForCache and the snapshot both strip
seriesByProvider7d/30d on purpose, so the chart refetches them on tab click.
That route loads the raw spec off disk, never passes it through
applyDimensionsToSpec, and injected only the provider selector:

  avg by (aggregator) (head_lag_first_share_pct{aggregator="codex"})

averaged over every chain and every region. The blob branch above it is
correctly keyed by filterSig, but it can never hit for a panel because the
series it looks for are the ones that were stripped, so every request fell
through to the unscoped build. Bench 001 declares the selector as `{}`, which
is what made it invisible in review: it looks filtered and matches everything.

Both paths now call one exported panelMetricQuery, so they cannot drift again,
and ignore_dimensions is honoured in both rather than in one (bench 282's
blank-on-71-of-75-views trap). The route's own cache key moves to v10 because
entries written before this hold a cross-chain average under a per-chain key.

Ten tests on the shared function. Verified they fail: putting the dropped
dimensions back turns 5 of them red, so this is a guard and not a guess.

Not a regression from today's Prometheus work. head_lag_first_share_pct comes
from the monitor job, which was kept, and no head_lag metric was touched.

* the panel chart cached one chain's 7d series and served it on every other tab (#3364)

This is the bug Lucas actually reported, and #3362 was not it.

Bench 001's First to report showed the same shares on Base, BNB, Solana and
Robinhood while head lag beside it moved per chain. Florent narrowed it to
"only 7D and 30D", which is the whole diagnosis: 1H, 6H and 24H render from
the embedded per-filter series, and 7D, 30D, 90D and 1Y are lazy-fetched.

The lazy caches were keyed by panel id alone:

    if (lazyPanel7d[activePanelId] && lazyPanel30d[activePanelId]) return;

The effects DO list chainProp in their deps and DO re-run on a tab change, and
the fetch URL has carried the chain since the main series was fixed for this
same reason. It never got there: the first chain opened filled the entry, and
every later chain hit that guard and returned before fetching.

What it published, measured against the live series with EU-WEST selected:

    base       Serialized 74.7 %     the chart named Codex
    bnb        Mobula     64.8 %     the chart named Codex
    robinhood  Serialized 93.3 %     the chart named Codex
    solana     Codex      73.4 %     right, by luck

So three chains out of four named the wrong leader, which is worse than the
"same numbers everywhere" it looked like.

Keyed on panel + chain + region + tier now, through one panelSeriesCacheKey
helper, reads and writes together. The 90d/1y writes are included: they had
been left on the old key by the first pass, which would have made that cache
never hit and refetch on every render.

Seven tests on the key, including the two orderings a naive concatenation
would collide.

Note #3362 is still a real fix and stays: /api/series rebuilds a panel's
series from the raw spec whenever the blob misses, and that path dropped the
dimensions. It is latent rather than what Lucas saw, because the blob does
carry the per-filter panel series and was answering correctly throughout. The
PR body claimed otherwise and has been corrected.
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