Get the Diagnostics Bundle Out

"What do the logs say?" β€” this is how you answer that question in three steps, without hunting through folders.

🐞 When to use it

Anything you cannot explain from the screen: audio that stutters, a panel that stops updating, a radio that will not connect, an upgrade that did nothing, a page whose buttons went dead.

A report without evidence turns into a guessing game. The bundle exists so that the first answer is a verdict, not a question.

🧭 Three steps

#What you doWhy it matters
1Open 🐞 Something went wrong and describe the symptom β€” what happens, when it started, radio model and frequency"Audio stutters about once a second since I moved to the Windows box" is answerable; "it does not work" is not
2Press Build bundleCollects logs, a redacted config, an environment snapshot and runs the health checks
3Press Upload to maintainer β€” or Save locallyUpload only happens when you click it

The page requires you to be logged into the local MRRC UI; without a session it answers 401/403.

πŸ“¦ What is inside

  • Log tails β€” the last part of each role's log, not the whole history
  • Redacted configuration β€” a whitelist; secrets are replaced, omitted keys are counted
  • Environment snapshot β€” platform, versions, devices
  • Automatic health summary β€” log freshness, audio health, hotfix and WDSP state, startup count and time span (restarts versus crashes), audio-device verdict

What is never inside

The user database, certificate private keys, session secrets, passwords and tokens. None of them are packaged, redacted or not.

πŸ“΄ If the upload does not go through

Firewall, no route to the receiver, or a machine that never reaches the internet: choose Save locally, then hand the file over by whatever channel you already use.

The bundle is a plain file; uploading early just saves you a step.

πŸ”Ž What happens after

  1. New reports are fetched and digested, and each one is triaged against this project's rules β€” conservative verdicts, no verdict without evidence, "environment problem" is not a defect.
  2. Every conclusion becomes a card: id / symptom / diagnosis with evidence / conclusion / what to do.
  3. Cards are published to the public answers page, searchable by report id or keyword.

Thin evidence produces need_more_info, never a guess β€” which is exactly why the health summary is part of the bundle.

πŸ“š Where the details live