Skip to content

observer: block headroom SLI demo#533

Draft
x3c41a wants to merge 4 commits into
mainfrom
ndk/slo-observer-papi-demo
Draft

observer: block headroom SLI demo#533
x3c41a wants to merge 4 commits into
mainfrom
ndk/slo-observer-papi-demo

Conversation

@x3c41a
Copy link
Copy Markdown
Contributor

@x3c41a x3c41a commented May 13, 2026

Adds a standalone observer/ directory with a small PAPI script that exercises one chain-derived SLI for Bulletin Chain: block headroom.

For each finalized block on Paseo Bulletin, the script counts transactionStorage.Stored events and sums the size field of TransactionStorage::Transactions(N), then classifies the block as good (both count < 0.8 × 512 and bytes < 0.8 × 8 MB) or bad. Running SLI = good / (good + bad). SLO window is 2 weeks.

Out of scope here, planned as follow-up PRs:

  • Block production SLI
  • Authorization lifecycle SLI
  • Read-ability (Bitswap) SLI

See observer/README.md for run instructions and current limitations.

Adds observer/ with a small PAPI script that exercises three SLIs against
a Bulletin RPC (Paseo today):

- Block production: actual vs expected by slot cadence
- Block headroom: per-block stored count and bytes below 80% of caps
- Authorization lifecycle: event-derived model vs on-chain storage

Demo only. No Prometheus exporter, no alerting, no Bitswap probe (follow-up).
README documents how to run against Paseo and current limitations.
@socket-security
Copy link
Copy Markdown

socket-security Bot commented May 13, 2026

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addednpm/​tsx@​4.21.01001008184100

View full report

Parablocks are produced at the relay-chain slot cadence under async
backing, not at the AURA SlotDuration constant. The expected-block
denominator in the production SLI must use 6s to match reality.

Also document that the SLO window is 2 weeks.
@x3c41a x3c41a marked this pull request as draft May 13, 2026 15:57
x3c41a added 2 commits May 13, 2026 17:57
Strip how-to-read-the-code prose from README and the file header.
Keep the why (what these SLIs are, the 2-week window, scope limits)
and the only how that's necessary: the three commands to run.
Drop block production and authorization tracking from the demo so this
PR lands one SLI at a time. The other two SLIs (and the Bitswap
Read-ability probe) get their own PRs once this one's reviewed.
@x3c41a x3c41a changed the title observer: PAPI demo for chain-derived SLIs observer: block headroom SLI demo May 13, 2026
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