Skip to content

aspire-dashboard-setup.md

Latest commit

 

History

History
64 lines (41 loc) · 2.37 KB

aspire-dashboard-setup.md

File metadata and controls

64 lines (41 loc) · 2.37 KB

Setting Up Aspire Dashboard Locally (Optional)

Optional: This step is not required to run the workshop. The Aspire Dashboard provides a rich UI for viewing OpenTelemetry traces, metrics, and logs in real-time — useful for observing agent behaviour, LLM prompt flows, and tool calls during local development.

The .NET Aspire Dashboard is a web-based UI for viewing OpenTelemetry traces, metrics, and logs in real-time.

For full setup details, see the reference guide: aspire-dashboard-setup.md

Prerequisites

Setup Instructions

  1. Pull the latest Aspire Dashboard Docker image:

    docker pull mcr.microsoft.com/dotnet/aspire-dashboard:latest

  2. Run the Aspire Dashboard container:

    docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard \
  -e DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS=true \
  mcr.microsoft.com/dotnet/aspire-dashboard:latest

    This starts the dashboard and maps:

    • Port 18888 — web UI
    • Port 4317 — OTLP endpoint (used by the application to send telemetry)

    The DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS=true environment variable allows unauthenticated access, suitable for local development.

  3. Open the dashboard:

    • Local: Navigate to http://localhost:18888
    • GitHub Codespaces: Go to the Ports panel in VS Code, find port 18888, and click the globe icon to open it in your browser.

Dashboard Overview

The dashboard has three main tabs:

Tab What you can see
Traces Distributed traces, execution flow, LLM prompts, and tool calls (when sensitive data is enabled)
Metrics Application performance metrics and resource utilization
Logs Structured logs with filtering and search

Additional Resources