Skip to content

docs(weave): add ingest sampling guide for self-managed instances#2882

Draft
dbrian57 wants to merge 2 commits into
mainfrom
weave/ingest-sampling-docs
Draft

docs(weave): add ingest sampling guide for self-managed instances#2882
dbrian57 wants to merge 2 commits into
mainfrom
weave/ingest-sampling-docs

Conversation

@dbrian57

@dbrian57 dbrian57 commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Description

Adds a new page, Configure ingest sampling for self-managed Weave (weave/guides/platform/ingest-sampling.mdx), documenting the server-side ingest sampler: what it is and why to use it, the Weave-classic-only scope, the eval carve-out, the stable per-trace hash decision, configuration via WEAVE_INGEST_SAMPLE_RATE and WEAVE_INGEST_SAMPLE_DRY_RUN, the DogStatsD counters, and requirements/limitations (SDK version gate, raw OTel excluded, carve-out limits).

Also:

  • Adds the page to the Deploy and scale nav group in docs.json (English nav only; localized navs go through the translation pipeline).
  • Adds inbound cross-links from the platform overview (weave/guides/platform.mdx) and the self-managed setup guide (weave/guides/platform/weave-self-managed.mdx).
  • The page links out to the per-op tracing_sample_rate docs and the OTel guide.

Adapted from the internal engineering handoff. The internal roadmap ("What's next") is intentionally excluded pending product sign-off, and unbuilt items aren't presented as available. Content was drafted following the style-guide skill passes.

Warning

Do not merge until the next on-prem server image containing the sampler is cut and customers can use it (sampler merged in wandb/core #46786, WB-36399). An MDX comment at the top of the new page repeats this and must be removed before merge.

Recommendations for technical review

  • Confirm the SDK version gate with Roman: this page states Weave Python SDK 0.53.0+ / TypeScript SDK 0.16.1+, but an earlier tracking ticket referenced Python 0.52.44. The version gates whether traffic is sampled at all.
  • Confirm the exact DogStatsD counter names are OK to publish, or move them to an internal runbook.
  • Confirm "Weave TypeScript SDK" is the correct public name for what the handoff calls the Node SDK (0.16.1).
  • Before merge: delete the hold-for-publish MDX comment at the top of ingest-sampling.mdx.
  • Optional, needs product sign-off: decide whether to add a forward-looking note about the agents-data-model sampler and per-project rates.

Testing

  • Local build succeeds without errors (mint dev) — page renders under Deploy and scale.
  • Local link check succeeds without errors (mint broken-links).
  • docs.json validated as JSON.

Related issues

🤖 Generated with Claude Code

Adds a new page under Deploy and scale documenting server-side ingest
sampling for self-managed Weave (WEAVE_INGEST_SAMPLE_RATE, dry run,
eval carve-out, SDK version requirements), with cross-links from the
platform overview and the self-managed setup guide.

Hold merging until the next on-prem server image containing the
sampler ships. Open items are noted in an MDX comment at the top of
the new page (SDK version gate confirmation, DogStatsD counter names).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@w-b-hivemind

w-b-hivemind Bot commented Jul 9, 2026

Copy link
Copy Markdown

HiveMind Sessions

2 sessions · 46m · $13

Session Agent Duration Tokens Cost Lines
Review W&B Ingest Sampling Documentation
a66adceb-232d-457a-a5f3-8a1f5a7ec099
claude 8m 45.0K $4.45 +32 -67
Adding Weave Ingest Sampling Documentation
00e9d19c-54f1-4d30-a128-896b29fe41e4
claude 38m 53.0K $8.40 +145 -4
Total 46m 98.0K $13 +177 -71
Screenshots

View all sessions in HiveMind →

Run claude --resume a66adceb-232d-457a-a5f3-8a1f5a7ec099 to pickup where you left off.

@mintlify

mintlify Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
wandb 🟢 Ready View Preview Jul 9, 2026, 3:44 PM

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

📚 Mintlify Preview Links

🔗 View Full Preview

✨ Added (1 total)

📄 Pages (1)

File Preview
weave/guides/platform/ingest-sampling.mdx Ingest Sampling

📝 Changed (3 total)

📄 Pages (2)

File Preview
weave/guides/platform.mdx Platform
weave/guides/platform/weave-self-managed.mdx Weave Self Managed
⚙️ Other (1)
File
docs.json

🤖 Generated automatically when Mintlify deployment succeeds
📍 Deployment: 85ab793 at 2026-07-10 20:46:02 UTC

@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Checker Results

All links are valid!

No broken links were detected.

Checked against: https://wb-21fd5541-weave-ingest-sampling-docs.mintlify.app

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