Skip to content

Add dashboard troubleshooting page#1255

Open
JamesNK wants to merge 1 commit into
release/13.5from
dashboard-troubleshooting
Open

Add dashboard troubleshooting page#1255
JamesNK wants to merge 1 commit into
release/13.5from
dashboard-troubleshooting

Conversation

@JamesNK

@JamesNK JamesNK commented Jun 13, 2026

Copy link
Copy Markdown
Member

Adds a new troubleshooting page for the Aspire dashboard with guidance on debugging connection errors between the dashboard and the app host.

Content

  • Symptoms of connection failures (no resources, missing console logs, error banners)
  • Viewing dashboard logs using aspire run --log-level Debug
  • Certificate and TLS errors with aspire certs trust/aspire certs clean commands
  • Firewall and network issues including HTTP/2 requirement for gRPC
  • Ping timeout errors when debugging explaining keep-alive timeout caused by debugger breakpoints

Also adds the page to the dashboard sidebar configuration.

Copilot AI review requested due to automatic review settings June 13, 2026 05:32
@JamesNK JamesNK requested a review from IEvangelist as a code owner June 13, 2026 05:32

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Aspire dashboard troubleshooting article to help users diagnose dashboard↔AppHost resource service connection failures, and exposes it in the dashboard docs sidebar.

Changes:

  • Added a new /dashboard/troubleshooting MDX page covering common connection symptoms, logging, TLS/certs, network/HTTP2, and debugging ping timeouts.
  • Added the new troubleshooting page to the dashboard sidebar topics (including localized sidebar labels).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
src/frontend/src/content/docs/dashboard/troubleshooting.mdx New troubleshooting documentation page for dashboard connection issues.
src/frontend/config/sidebar/dashboard.topics.ts Adds “Troubleshooting” to the dashboard docs navigation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +6 to +7
import { Steps } from '@astrojs/starlight/components';
import LearnMore from '@components/LearnMore.astro';
@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1255. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1255 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

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