microsoft / microsoft/aspire.dev

[GitHub Discussions] Telemetry & Dashboard documentation gaps

Open
#353 0 comments 0 reactions 1 assignee View on GitHub

@IEvangelist is already working on this.

Since Jun 2, 2026.

external feedback
Dominant language
MDX
Stars
193
Forks
87
Avg merge
1d 22h
Merged PRs (30d)
73

Description

Summary

Based on analysis of 820 GitHub discussions from dotnet/aspire.

Question counts:

Topic Questions
Dashboard 88 total
Dashboard in Production 15+
OpenTelemetry Config 20+
Logging 15+
Metrics 10+

Gaps in Existing Docs

1. ⚠️ Dashboard in Production (15+ questions)

Docs exist: standalone-aspire-dashboard ✅ covers:

  • Docker run command with port mapping
  • OTLP port configuration (4317 ΓåÆ 18889)
  • Login token retrieval from logs
  • OpenTelemetry SDK configuration (OTEL_EXPORTER_OTLP_ENDPOINT)
  • Limitations: in-memory only, no persistence, no GitHub Copilot

Explicit warning in doc: "The dashboard is designed as a development and short-term diagnostic tool"

Discussions still asking about:

What's missing from standalone-aspire-dashboard:

  • Production deployment patterns (when appropriate)
  • Dashboard behind proxy/ingress (nginx, K8s ingress)
  • Azure-specific deployment troubleshooting
  • Persistent telemetry alternatives (Azure Monitor, etc.)

2. ⚠️ Custom OTEL Configuration (20+ questions)

Docs exist: telemetry, standalone-aspire-dashboard ✅ cover basics

Discussions still asking about:

What's missing:

  • Custom OTEL collector configuration (config.yaml examples)
  • Third-party metrics integration
  • Pull-based metrics patterns (Prometheus scrape)
  • Java/JVM OTEL configuration
  • OTEL exporter error handling/visibility

3. ⚠️ Logging Configuration

Discussions:

What's missing:

  • Log filtering/reduction patterns
  • Scoped logging configuration
  • Azure Functions logging noise reduction

Data Source

  • GitHub Discussions: 820 total
  • Telemetry-related: 88 discussions
  • Date range: Project inception - February 2026
  • Verified against: aspire-list_docs (9 dashboard/telemetry docs), aspire-get_doc for detailed review

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.