Skip to content

Add "Record a HAR file" troubleshooting page#850

Merged
emrcbrn merged 1 commit into
netbirdio:mainfrom
emrcbrn:docs/record-har-file
Jul 14, 2026
Merged

Add "Record a HAR file" troubleshooting page#850
emrcbrn merged 1 commit into
netbirdio:mainfrom
emrcbrn:docs/record-har-file

Conversation

@emrcbrn

@emrcbrn emrcbrn commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

What

Adds a dedicated Record a HAR file how-to at /help/recording-a-har-file, under Troubleshooting → Report a bug. Support regularly needs a HAR to debug dashboard, login/SSO, and reverse-proxy issues, and there was no page to point people to.

The page:

  • Explains what a HAR is and why Support asks for it: the failure is in browser↔server traffic that a debug bundle can't capture.
  • Leads with a security warning: a HAR carries cookies, auth headers, and session tokens, so share it privately and prefer the sanitized export.
  • Names the two common mistakes: open DevTools before reproducing, and enable "Preserve log" so SSO redirects don't wipe the capture.
  • Links each browser's official export docs (Chrome, Edge, Firefox), with inline steps for Safari since Apple doesn't document the export.

Nav & cross-links

  • Nested Community/NetBird Support under the Report a bug Overview item, so the new page reads as a sibling of the reporting cluster rather than a fourth flat peer.
  • Cross-linked the HAR page from both support pages and the Report bugs overview, next to the existing debug-bundle mention.

Screenshots

New page, dark and light:

Dark Light

Report a bug submenu (Overview → Community/NetBird, HAR as sibling) and the cross-link in context:

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added a help page explaining how to record, export, and securely share HAR files.
    • Added navigation for the new HAR recording guidance.
  • Documentation

    • Updated bug-reporting and support instructions to request debug bundles, version details, reproduction steps, and HAR files for dashboard, login, or reverse-proxy issues.
    • Added warnings about sensitive information in HAR files and advised sharing them privately.

New /help/recording-a-har-file how-to under Troubleshooting > Report a
bug, covering HAR capture in Chrome, Edge, Firefox, and Safari with the
"preserve log" gotcha and a security warning about tokens in HAR files.

Nest Community/NetBird Support under the Report a bug "Overview" item so
the new page reads as a sibling of the reporting cluster rather than a
fourth flat peer. Cross-link the HAR page from the two support pages and
the Report bugs overview, next to the existing debug-bundle mention.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 4ab8a9da-a88c-4c0c-9594-da39d6fa622f

📥 Commits

Reviewing files that changed from the base of the PR and between ae35274 and 69c1e2a.

📒 Files selected for processing (5)
  • src/components/NavigationDocs.jsx
  • src/pages/help/community-support.mdx
  • src/pages/help/netbird-support.mdx
  • src/pages/help/recording-a-har-file.mdx
  • src/pages/help/report-bug-issues.mdx

📝 Walkthrough

Walkthrough

A new HAR recording help page was added, support guidance now references HAR files for selected issue types, and documentation navigation was reorganized to expose the new page.

Changes

HAR support workflow

Layer / File(s) Summary
HAR recording documentation
src/pages/help/recording-a-har-file.mdx
Adds browser-agnostic and browser-specific HAR recording, export, sanitization, safety, and sharing instructions.
Support guidance integration
src/pages/help/community-support.mdx, src/pages/help/netbird-support.mdx, src/pages/help/report-bug-issues.mdx
Updates support instructions and links to request HAR files for dashboard, login, or reverse-proxy issues.
Support navigation
src/components/NavigationDocs.jsx
Nests Community Support and NetBird Support under Overview and adds Record a HAR file as a sibling entry.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: techhuttv, sunsetdrifter

Poem

A rabbit found a HAR to share,
With careful steps and warning flair.
Through nested paths the helpers hop,
To support’s door without a stop.
“Keep secrets safe!” the bunny sings.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: adding a new “Record a HAR file” troubleshooting page.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.


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.

@emrcbrn emrcbrn merged commit 3ab1e21 into netbirdio:main Jul 14, 2026
3 checks passed
@emrcbrn emrcbrn deleted the docs/record-har-file branch July 14, 2026 11:24
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