Repository navigation
docs: Update troubleshooting guide for 8.0 and add Cloud troubleshooting page - #2085
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
|
Direct preview links to pages changed in this PR: |
Contributor
enriquegh
enabled auto-merge (squash)
October 9, 2026 21:15
enriquegh
added a commit
that referenced
this pull request
Oct 9, 2026
The Help Center moved new support requests from `https://help.sourcegraph.com/hc/en-us/requests/new` to `https://help.sourcegraph.com/inbox/new`. This updates the six remaining links on five pages: - `docs/code-navigation/how-to/index-other-languages.mdx` - `docs/code-navigation/how-to/adding-scip-to-workflows.mdx` (two links) - `docs/integration/browser-extension/how-tos/troubleshooting.mdx` - `docs/getting-started/personalization/badges.mdx` - `docs/admin/repo/perforce.mdx` `docs/self-hosted/observability/troubleshooting.mdx` is left alone because #2085 fixes it. Not changed, needs follow-up: `docs/batch-changes/faq.mdx` links to the Help Center article `/hc/en-us/articles/28471221973133-Changing-Ownership-Of-A-Batch-Change-Before-User-Deletion`, which now returns 404. ## Test plan - `https://help.sourcegraph.com/inbox/new` loads the Help Center sign-in page with `returnPath=/inbox/new`. - Baseline-filtered link check (`--check-anchors --check-self-links --check-external`): no new dead links. - `npx cspell@10` on the changed files: 0 issues. - Vercel preview: all five pages render `href="https://help.sourcegraph.com/inbox/new"` (six links total) and no `hc/en-us/requests/new`. Co-authored-by: Amp <amp@ampcode.com>
marcleblanc2
approved these changes
Oct 12, 2026
Amp-Thread-ID: https://ampcode.com/threads/T-726be5c1-be6e-4eaf-9008-a0e55c66fed4 Co-authored-by: Amp <amp@ampcode.com>
… action Amp-Thread-ID: https://ampcode.com/threads/T-726be5c1-be6e-4eaf-9008-a0e55c66fed4 Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-726be5c1-be6e-4eaf-9008-a0e55c66fed4 Co-authored-by: Amp <amp@ampcode.com>
Co-authored-by: Amp <amp@ampcode.com> Amp-Thread-ID: https://ampcode.com/threads/T-726be5c1-be6e-4eaf-9008-a0e55c66fed4
enriquegh
force-pushed
the
enrique/troubleshooting-accuracy
branch
from
October 12, 2026 20:07
d315780 to
1b10424
Compare
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Checked https://sourcegraph.com/docs/self-hosted/observability/troubleshooting against
sourcegraph@v8.0.0,sourcegraph/zoekt, anddeploy-sourcegraph-k8s, and added a troubleshooting page for Sourcegraph Cloud.Self-hosted troubleshooting guide (8.0 accuracy)
gitserver: echo_command_duration_testalert (20ms+ for 30s) and the "Git commands running on each gitserver instance" panel.USE_ENHANCED_LANGUAGE_DETECTION=false"solution". The variable no longer exists in the codebase; it dates from 3.11.gitserver_disk_free_percentis nowsrc_gitserver_disk_space_available/src_gitserver_disk_space_total./site-admin/report-bugis now/user/settings/report-bug, and/site-admin/repositoriesis now/admin/repositories(/site-admin/*only redirects)./site-admin/usage-statisticsno longer exists, so usage stats now point to Sourcegraph Analytics. The status notifications and Code host connections page replace the "cloud icon".#Logs,#accessing-prometheus, and#accessing-jaeger(twice).count:999999is nowcount:all.x-trace-urlheader is documented.max_map_countguidance now matches the zoektmemory_map_areas_percentage_usedalert (2× repos per replica), and the page mentions shard merging./admin/diagnostics).Existing headings are unchanged, so the redirect to
#scenario-search-timeoutsstill works.New: Troubleshooting Sourcegraph Cloud (
/cloud/troubleshooting)Cloud site admins cannot use most of the self-hosted guide. The Observability admin page is hidden on Cloud for anyone who isn't a Sourcegraph operator. It also hides
/-/debug/{grafana,jaeger,prometheus}for customers. The new page is a self-contained checklist of what Cloud admins can collect and send to support:x-traceIDtrace=1It is added under Sourcegraph Cloud in the nav.
cloud/index.mdxnow links to it instead of to the self-hosted observability docs.Test plan
pnpm run check links --check-anchors --check-self-links: no findings on the changed pages. The 4 anchors this page used to break are fixed;cloud/index.mdxstill has 2 broken anchors from before this PR.dev/check-hostnames.mjs,tsc --noEmit, andcontentlayer2 buildpass.#check-diagnostics, Cloud page sections) are present, with no console errors.Changed links on the Vercel preview
docs/self-hosted/observability/troubleshooting.mdx/self-hosted/observability/tracing#accessing-jaeger/self-hosted/observability/tracing#jaeger