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
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

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
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