cloud/064-bstack-cli by isaiahb · Pull Request #2351 · Mentra-Community/MentraOS

isaiahb · 2026-03-28T23:10:04Z

No description provided.

New CLI tool at cloud/tools/bstack/ for instant production diagnostics: - bstack health: all-region health check with uptime monitors - bstack diagnostics: GC probes, event loop gaps, MongoDB, operation budget - bstack crash-timeline: what happened before a crash - bstack memory: RSS trend with growth rate and time-to-crash estimate - bstack gc/gaps/budget/slow-queries/cache: focused analysis per feature - bstack incidents: recent uptime incidents - bstack sources: list all BetterStack resources - bstack sql: raw ClickHouse SQL queries config.ts: complete inventory of all BetterStack source IDs, collector IDs, dashboard IDs, uptime monitors, region configs, and diagnostic features. Usage: cd cloud/tools/bstack && bun run bstack.ts <command> Requires: BETTERSTACK_USERNAME, BETTERSTACK_PASSWORD, BETTERSTACK_API_TOKEN Issue: cloud/issues/064-bstack-cli/spike.md

…27-28 12 open items tracked: - Cloudflare LB wrong domain (mobile uses mentra.glass, LB config on mentraglass.com) - France/East Asia need redeploy for new BetterStack source - MongoDB users.findOne 3.4s spike (definitive event loop gap cause) - SDK auth still hits DB (intentional tradeoff) - Bun runtime memory issues (known, monitoring) - MongoDB callback storm theory (needs proof) - Per-region uptime monitors (not set up) - Dashboard alerts (not set up) - Multi-region dashboards (only US Central) - Mobile reconnect improvements - MEMORY_TELEMETRY_ENABLED still not flipped - Cherry-pick hotfixes into dev Plus complete inventory of what was shipped and tools available.

…ff for next session

…tted)

coderabbitai · 2026-03-28T23:10:09Z

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 27b7afe2-f80e-4f4c-9979-241d506b2269

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch cloud/064-bstack-cli

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

github-actions · 2026-03-28T23:10:14Z

📋 PR Review Helper

📱 Mobile App Build

⏳ Waiting for build...

🕶️ ASG Client Build

⏳ Waiting for build...

🔀 Test Locally

gh pr checkout 2351

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ea76b518d3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

cloud/tools/bstack/bstack.ts

chatgpt-codex-connector · 2026-03-28T23:14:50Z

cloud/tools/bstack/config.ts

+  if (!API_TOKEN) {
+    console.error("❌ BETTERSTACK_API_TOKEN not set.");
+    console.error("   This is the management API token from BetterStack → Integrations → API.");
+    process.exit(1);


Avoid exiting process when uptime token is missing

cmdHealth wraps uptime monitor fetching in try/catch and prints a fallback message, but validateApiToken() calls process.exit(1) directly, so the catch path is never reached. This makes bstack health terminate with a non-zero exit whenever BETTERSTACK_API_TOKEN is unset, even though region health checks already completed and the code intends monitor fetching to be optional.

Useful? React with 👍 / 👎.

Fixed in 407bb40. validateApiToken() now throws an error instead of calling process.exit(1). cmdHealth checks API_TOKEN before calling fetchUptime() and prints a fallback message if it's not set, so region health checks still complete successfully.

cloud/tools/bstack/bstack.ts

…ate 065 tracking with DNS findings and current status

…udit, observability gaps, BetterStack evidence

…ation

…mmary at disposal time

…objects/10min inside stable sessions, proposed observability O1-O3

…for Vector log collection

…d JSON to stdout for Vector collection, fixes createFilteredStream double-parse

cloudflare-workers-and-pages · 2026-03-29T04:18:57Z

Deploying mentra-live-ota-site with Cloudflare Pages

Latest commit:	`4b5d6fc`
Status:	✅ Deploy successful!
Preview URL:	https://c25af164.mentra-live-ota-site.pages.dev
Branch Preview URL:	https://cloud-064-bstack-cli.mentra-live-ota-site.pages.dev

View logs

cloudflare-workers-and-pages · 2026-03-29T04:21:03Z

Deploying mentra-store-dev with Cloudflare Pages

Latest commit:	`4b5d6fc`
Status:	✅ Deploy successful!
Preview URL:	https://5c4bae06.augmentos-appstore-2.pages.dev
Branch Preview URL:	https://cloud-064-bstack-cli.augmentos-appstore-2.pages.dev

View logs

cloudflare-workers-and-pages · 2026-03-29T04:22:33Z

Deploying dev-augmentos-console with Cloudflare Pages

Latest commit:	`4b5d6fc`
Status:	✅ Deploy successful!
Preview URL:	https://c75175dc.dev-augmentos-console.pages.dev
Branch Preview URL:	https://cloud-064-bstack-cli.dev-augmentos-console.pages.dev

View logs

cloudflare-workers-and-pages · 2026-03-29T04:24:09Z

Deploying prod-augmentos-account with Cloudflare Pages

Latest commit:	`4b5d6fc`
Status:	✅ Deploy successful!
Preview URL:	https://679d2751.augmentos-e84.pages.dev
Branch Preview URL:	https://cloud-064-bstack-cli.augmentos-e84.pages.dev

View logs

… flatten transforms, phased rollout

…vel fields, filter to cloud containers only

…meric→string, nest metadata in _meta

…ry, eliminates heap growth

…ken throw, region source routing, duration normalization

isaiahb added 4 commits March 28, 2026 14:49

docs(065): comprehensive update — two root causes, full context hando…

dfbb965

…ff for next session

fix: add .heap/ to gitignore (prevent 117MB snapshot from being commi…

ea76b51

…tted)

isaiahb self-assigned this Mar 28, 2026

isaiahb requested a review from a team as a code owner March 28, 2026 23:10

chatgpt-codex-connector bot reviewed Mar 28, 2026

View reviewed changes

isaiahb added 9 commits March 28, 2026 16:32

Merge remote-tracking branch 'origin/dev' into cloud/064-bstack-cli

119ecd3

refactor: move incidents CLI from packages/ to tools/ (alongside bstack)

9257cd0

fix: correct East Asia health URL (asiaeastapi, not eastasiaapi), upd…

34a5e32

…ate 065 tracking with DNS findings and current status

docs(066): spike — WebSocket disconnect churn investigation, client a…

d8397e3

…udit, observability gaps, BetterStack evidence

docs(066): spec — WebSocket disconnect churn observability instrument…

cdc1ab2

…ation

docs(066): add A8 ws-dispose log event to spec — session lifecycle su…

147a33e

…mmary at disposal time

docs(067): spike — heap growth investigation, 4 snapshots prove 200K …

a566a1d

…objects/10min inside stable sessions, proposed observability O1-O3

ci: add US West deploy workflow + BetterStack logs Helm chart values …

c789188

…for Vector log collection

feat(067): add LOG_STDOUT_JSON mode to pino logger — writes structure…

4b5d6fc

…d JSON to stdout for Vector collection, fixes createFilteredStream double-parse

isaiahb added 5 commits March 28, 2026 21:38

docs(067): spec — switch from @logtail/pino to Vector log collection,…

747e67b

… flatten transforms, phased rollout

fix(067): Vector values — fix VRL syntax, flatten Pino JSON to top-le…

97d13cf

…vel fields, filter to cloud containers only

fix(067): Vector transform — normalize msg→message, time→dt, level nu…

fb5f627

…meric→string, nest metadata in _meta

feat(067): remove @logtail/pino transport — Vector handles log delive…

0ba9552

…ry, eliminates heap growth

fix(064): address code review — nested health response, validateApiTo…

407bb40

…ken throw, region source routing, duration normalization

isaiahb merged commit 6fe12d6 into dev Mar 29, 2026
9 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

cloud/064-bstack-cli#2351

cloud/064-bstack-cli#2351
isaiahb merged 18 commits intodevfrom
cloud/064-bstack-cli

isaiahb commented Mar 28, 2026

Uh oh!

coderabbitai bot commented Mar 28, 2026 •

edited

Loading

Review skipped

Uh oh!

github-actions bot commented Mar 28, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Uh oh!

Uh oh!

chatgpt-codex-connector bot Mar 28, 2026

Uh oh!

isaiahb Mar 29, 2026

Uh oh!

Uh oh!

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

isaiahb commented Mar 28, 2026

Uh oh!

coderabbitai bot commented Mar 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

github-actions bot commented Mar 28, 2026

📋 PR Review Helper

📱 Mobile App Build

🕶️ ASG Client Build

🔀 Test Locally

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connector bot Mar 28, 2026

Choose a reason for hiding this comment

Uh oh!

isaiahb Mar 29, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying mentra-live-ota-site with Cloudflare Pages

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Deploying mentra-store-dev with Cloudflare Pages

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Deploying dev-augmentos-console with Cloudflare Pages

Uh oh!

cloudflare-workers-and-pages bot commented Mar 29, 2026

Deploying prod-augmentos-account with Cloudflare Pages

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

coderabbitai bot commented Mar 28, 2026 •

edited

Loading

cloudflare-workers-and-pages bot commented Mar 29, 2026 •

edited

Loading