Skip to content

docs: add builder observability page#140

Merged
yongkangc merged 1 commit intomainfrom
yk/tempo-builder-observability
Mar 11, 2026
Merged

docs: add builder observability page#140
yongkangc merged 1 commit intomainfrom
yk/tempo-builder-observability

Conversation

@decofe
Copy link
Copy Markdown
Member

@decofe decofe commented Mar 11, 2026

Summary

Adds a new dev-docs page documenting Tempo builder observability tooling, data sources, and investigation workflow.

Content

  • Workflow: outlier investigation loop (ValScope → BlockScope drill-down)
  • ValScope: what it shows, key pages, validator configs, testnet/mainnet URLs
  • BlockScope: execution-level dashboard, trace breakdowns, mempool overlap
  • Data sources table: all 5 services (VLogs external/internal, VM external/internal, Tempo Traces) with env vars, descriptions, and testnet/mainnet Tailscale endpoints
  • Known outlier patterns: execution cache mutex, late build start, persistence during building, long newPayload
  • Limitations: no external validator traces, instrumentation requires release, log parsing gaps

Context

Consolidates context from two Slack threads about tempo perf observability (alexey + joshie + chia).

Testing

bun run check and bun run build pass.

Prompted by: yk

Co-Authored-By: Derek Cofausper <256792747+decofe@users.noreply.github.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Mar 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
tempo-docs Building Building Preview, Comment Mar 11, 2026 4:09am

Request Review

@yongkangc yongkangc self-assigned this Mar 11, 2026
@yongkangc yongkangc merged commit 77ccc38 into main Mar 11, 2026
2 of 7 checks passed
@yongkangc yongkangc deleted the yk/tempo-builder-observability branch March 11, 2026 04:10
yongkangc added a commit that referenced this pull request Mar 11, 2026
tx-tomcat pushed a commit to Magnus-Foundation/magnus that referenced this pull request Apr 18, 2026
…tion (#789)

Applies latest spec changes from
tempoxyz/docs#140

- `has_liquidity` is renamed to `reserve_liquidity`. it now returns
error when there's not enough liquidity, and also increments
`pending_fee_swap_in` with the max swap amount
- `fee_swap` is renamed to `reserve_liquidity` and now its only task is
to decremenet `pending_fee_swap_in` with `refund_amount`
- In `calculate_burn_amounts`, `amount_user_token` is no longer
validated against pending swaps as this check is redundant, see
https://github.com/tempoxyz/docs/blob/c4d0f5fc2fd09a391867a6c973e28922b3111f5a/specs/src/FeeAMM.sol#L278

Not sure if it's actually breaking but I think this change might change
gas usage in some edge cases, so marking as such
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.

2 participants