仪表板简介
更新: 2026-10-16 15:20:09 字数: 0 字 时长: 0 分钟
什么是 Aspire 仪表板？
Aspire 项目模板包含一个功能强大的仪表板，用于全面的应用监控与检查。它本质上是一个本地 OpenTelemetry 查看器，也可以脱离 AppHost 单独使用。
仪表板可实时追踪应用程序的关键方面，包括日志、调用追踪和环境配置。它通过提供清晰直观的应用状态与结构视图，来提升开发体验。
主要功能
- 查看来自已配置 OpenTelemetry 导出的应用的结构化日志、追踪与指标。
- 跨本地服务跟踪一条分布式追踪，并把它的日志关联起来。
- 在连接到 AppHost 时，查看资源健康状态并停止、启动或重启资源。
- 持久化资源与遥测数据，便于检查与对比已完成的运行。
- 为资源应用、AppHost shell、认证对话框与自动化提供交互式终端。
- 通过 Aspire CLI 或可选的 MCP 服务器，把应用可观测性数据共享给 AI 编码代理。
两种使用方式
| 方式 | 启动方式 | 能做什么 |
|---|---|---|
| 随 AppHost 一起启动 | aspire run / F5 | 遥测 + 资源生命周期控制 + 终端 + 配置查看。 |
| 独立运行（Standalone） | aspire dashboard run | 仅作为 OTLP 查看器接收任意应用的遥测，无资源生命周期控制。 |
随 Aspire 项目使用
仪表板与 C# / TypeScript AppHost 深度集成。开发期间启动 AppHost 会自动拉起仪表板，并配置好它与资源之间的连接。
应用仍需自行导出遥测
仪表板不会自动为您的应用插桩。应用需要配置 OpenTelemetry SDK 与导出器，才会把数据发送过来。ASP.NET Core 项目通过 ServiceDefaults 已经完成了这一步。
独立模式
独立仪表板是一个纯粹的 OTLP 查看器，可以接收任何配置了 OpenTelemetry 的应用的数据，包括 Python 与 Node.js 应用。它不提供 AppHost 的资源生命周期控制。详见独立运行仪表板。
配置与启动
仪表板在启动时完成配置，包括前端地址、OTLP 地址、资源服务端点、认证方式、遥测上限等。详见仪表板配置。
架构
仪表板前端通过 gRPC 与资源服务器通信，使用 Grpc.AspNetCore NuGet 包。整体上：
text
浏览器 ──HTTP──► 仪表板前端 ──gRPC──► 资源服务（AppHost 侧）
应用 ──OTLP───► 仪表板 OTLP 端点（gRPC 4317 / HTTP 4318）安全
仪表板展示的信息相当敏感：资源的环境变量里可能有密钥，遥测数据里可能有运行时敏感内容。
请谨慎对待仪表板的访问控制
- 不要把仪表板暴露到公网。
- 保持认证开启，不要使用
Unsecured模式。 - 登录令牌（
.../login?t=xxx）等同于凭据，不要提交到版本库或粘贴到公开渠道。
详见安全注意事项。
