.NET .NET Aspire 仪表板概述

.NET Aspire 项目模板提供了一个复杂的仪表板,用于全面的应用监视和检查,它还 独立模式。 通过此仪表板,可以实时密切跟踪应用的各个方面,包括日志、跟踪和环境配置。 它旨在增强开发体验,提供应用的状态和结构的深入概述。 仪表板公开了 停止、启动和重启资源的功能,以及查看日志和遥测数据并与之交互。

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

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

“.NET.NET Aspire 仪表板资源”页的屏幕截图。

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

独立模式

.NET Aspire 仪表板也作为 Docker 映像提供,无需 rest.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 命令:

  • 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 包 NuGet 包构建到资源 server。 请考虑下图,说明 .NET.NET Aspire 仪表板的体系结构:

显示 .NET.NET Aspire 仪表板体系结构的关系图。

安全

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

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

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

后续步骤