Skip to content

docs(tracing): document allocation cost-trace hardening batch (June)#219

Open
simozzy wants to merge 1 commit into
mainfrom
docs/cost-trace-batch-june
Open

docs(tracing): document allocation cost-trace hardening batch (June)#219
simozzy wants to merge 1 commit into
mainfrom
docs/cost-trace-batch-june

Conversation

@simozzy

@simozzy simozzy commented Jul 1, 2026

Copy link
Copy Markdown
Member

What

Consolidates the June allocation cost-tracing work into the docs, in one coherent story. Supersedes #217 and #218 (both edited June's What's New and would collide) — please close those in favour of this.

Changes

Usage guide (tracing-allocations.mdx) — adds a "Results built by more than one allocation" note: the agent lists the candidate steps and asks which to trace, or auto-routes to the right one when the question narrows to rows only that step produced (Tier B, sc-22795 / plaid #6427, #6428).

June What's New (releases/2026-06.mdx) — folds the hardening into the existing "Allocation root-cause tracing" entry rather than listing internal-sounding bug fixes:

  • multi-writer handling (report candidates / auto-route)
  • real-world column names — spaces, parentheses, % (sc-22787 #6420, sc-22790 #6425)
  • StarRocks as well as Databend/Postgres (sc-22791 #6420)
  • friendly table names (sc-22801 #6433)
  • data-freshness now covers driver/basis tables (sc-22802 #6434)

Scope notes

  • Only merged work is documented. The anomaly-percentile fix (sc-22803, plaid #6435) is excluded until it merges — a follow-up can add "more accurate anomaly signals" then.
  • REST trace endpoint (plaid #6430) intentionally not documented — the agent/MCP flow is the customer-facing surface; the REST route is integration plumbing.
  • No usage-guide changes for the correctness fixes (friendly-name / freshness) — the guide is a conversational "what you can ask" page and doesn't document output internals; those fixes just make documented behaviour work.

🤖 Generated with Claude Code

Supersedes #217 and #218. Consolidates the June cost-tracing work into one
coherent story:

- Usage guide: a "results built by more than one allocation" note — the agent
  reports candidate steps and asks which to trace, or auto-routes when the
  question narrows to one step's rows (Tier B, sc-22795 / #6427, #6428).
- June What's New: fold the hardening into the existing "Allocation root-cause
  tracing" entry — multi-writer handling, real-world column names (spaces /
  parens / %), StarRocks as well as Databend/Postgres, friendly table names,
  and driver/basis-table data-freshness (sc-22787/22790/22791/22801/22802).

Only merged work is documented; the anomaly-percentile fix (sc-22803, plaid
#6435) is excluded until it lands. The REST trace endpoint is intentionally
not documented (agent/MCP is the customer-facing surface).

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
plaidcloud-docs fc08a3f Commit Preview URL

Branch Preview URL
Jul 01 2026, 03:31 PM

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