.NET .NET Aspire 仪表板概述

.NET Aspire 项目模板包括一个复杂的仪表板，用于全面的应用监视和检查。 仪表板也可以在 独立模式下使用。

仪表板支持实时跟踪应用的关键方面，包括日志、跟踪和环境配置。 它旨在通过提供应用的状态和结构的清晰且深入的视图来增强开发体验。

仪表板的主要功能包括：

• 实时跟踪日志、跟踪和环境配置。
• 用于 停止、启动和重启资源的用户界面。
• 收集和显示日志和遥测;在直观的 UI 中 查看结构化日志、跟踪和指标 。
• 使用 GitHub 内置于仪表板中的 AI 驱动的助手 Copilot 增强调试。

将仪表板用于 .NET.NET Aspire 项目

仪表板已集成到 .NET.NET Aspire*。AppHost。 在开发期间，启动项目时会自动启动仪表板。 它配置为显示 .NET.NET Aspire 项目的资源和遥测数据。

有关在 .NET.NET Aspire 开发期间使用仪表板的详细信息，请参阅 浏览仪表板功能。

独立模式

.NET Aspire 仪表板也作为 Docker 映像提供，可以独立使用，无需 .NET Aspire其余部分。 独立仪表板提供了用于查看遥测的出色 UI，可供任何应用程序使用。

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard `
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

前面的 Docker 命令：

• 从 mcr.microsoft.com/dotnet/aspire-dashboard:9.0 映像启动容器。
• 公开两个端口的容器实例：
  • 将仪表板的 OTLP 端口 18889 映射到主机的端口 4317。 端口 4317 从应用接收 OpenTelemetry 数据。 应用使用 OpenTelemetry 协议 （OTLP）发送数据。
  • 将仪表板的端口 18888 映射到主机的端口 18888。 端口 18888 具有仪表板 UI。 导航到浏览器中 http://localhost:18888 以查看仪表板。

有关详细信息，请参阅 独立 .NET.NET Aspire 仪表板。

配置

仪表板在启动时进行配置。 配置包括前端和 OTLP 地址、资源服务终结点、身份验证、遥测限制等。

有关详细信息，请参阅 .NET.NET Aspire 仪表板配置。

建筑

仪表板用户体验是使用各种技术构建的。 前端使用 📦 Grpc.AspNetCore NuGet 包生成到资源服务器。 请考虑下图，说明 .NET.NET Aspire 仪表板的体系结构：

安全

.NET .NET Aspire 仪表板提供对应用的强大见解。 UI 显示有关资源的信息，包括其配置、控制台日志和深入遥测。

仪表板中显示的数据可能很敏感。 例如，配置可以包括环境变量中的机密，遥测可以包括敏感的运行时数据。 应注意保护对仪表板的访问。

有关详细信息，请参阅 .NET.NET Aspire 仪表板安全注意事项。

后续步骤