[docs] Document dashboard startup telemetry

[aspire-repo-bot]

Documents changes from microsoft/aspire#20846

@JamesNK

Target branch

Targeting release/17.0 based on the source PR milestone 17.0.

Why this is needed

microsoft/aspire#20846 adds an aspire/dashboard/startup product telemetry event recording startup result, duration, launch context, and (on failure) an error type. It also introduces the Dashboard:LaunchContext configuration option (DASHBOARD__LAUNCHCONTEXT environment variable), which the AppHost, the aspire dashboard run CLI command, and container deployments use to report where the dashboard was launched from. This is new user-facing telemetry behavior and a new configuration option, neither of which was previously documented.

This PR was drafted because the automated signal check flagged docs_required, based on:

• cli_command_file_changed — src/Aspire.Cli/Commands/DashboardRunCommand.cs was changed to set the new DASHBOARD__LAUNCHCONTEXT environment variable to cli.
• pr_body_has_cli_flag_mention — the PR body includes CLI command usage.

What changed

• src/frontend/src/content/docs/dashboard/microsoft-collected-dashboard-telemetry.mdx: Added a new "Startup telemetry" section describing the aspire/dashboard/startup event — startup result, duration, launch context values (apphost, cli, container, unknown), and the failure error types (invalid_config, address_in_use, canceled, or the exception type). Notes that this event is always recorded (not IDE-scoped like other usage telemetry) and uses the same ASPIRE_DASHBOARD_TELEMETRY_OPTOUT opt-out.
• src/frontend/src/content/docs/dashboard/configuration.mdx: Added a Dashboard:LaunchContext row to the "Other" options table, documenting the environment variable, default launchers, and fallback-to-unknown behavior.

Both pages were updated in place; no new pages were created.

Validation

Documentation-only change; no build or test commands were run. Content follows the existing structure and tables already used on both pages.

Generated by PR Documentation Check for #20846 · copilot · auto · 77.2 AIC · ⌖ 13.7 AIC · ⊞ 20.4K · ◷

[aspire-repo-bot]

Frontend HTML artifact ready

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

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

[Copilot]

🟡 Changes recommended

The promised telemetry details are absent, configuration behavior is incomplete, and an existing disclosure row is removed.

3 open findings

• Document startup telemetry scope, fields, and opt-out · New
• Preserve existing Copilot feedback disclosure row · New
• Document container configuration and unknown-value fallback · New

What changed in this PR

Documents Aspire 17.0 dashboard startup telemetry and its launch-context configuration.

Changes:

• Adds dashboard startup to the telemetry disclosure table.
• Adds the Dashboard:LaunchContext configuration option.

File	Description
microsoft-collected-dashboard-telemetry.mdx	Adds startup telemetry disclosure.
configuration.mdx	Documents launch-context configuration.

🧠 Review effort: Balanced

---

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.