仪表板配置
更新: 2026-10-16 15:20:09 字数: 0 字 时长: 0 分钟
仪表板在启动时一次性完成配置。配置来源包括命令行参数、环境变量与 appsettings.json。
常用配置项
地址与身份
| 配置键 | 说明 |
|---|---|
ASPNETCORE_URLS | 前端监听地址，默认 http://localhost:18888。 |
Dashboard:Frontend:PublicUrl | 仪表板对外公开的地址（反向代理场景）。 |
Dashboard:ApplicationName | 显示在界面上的应用名称。 |
认证
| 配置键 | 可选值 | 说明 |
|---|---|---|
Dashboard:Frontend:AuthMode | Unsecured / BrowserToken / OpenIdConnect | 浏览器访问认证方式。 |
Dashboard:Frontend:BrowserToken | 字符串 | 固定浏览器令牌。 |
Dashboard:Otlp:AuthMode | Unsecured / ApiKey / Certificate | 接收遥测的认证方式。 |
Dashboard:Otlp:PrimaryApiKey | 字符串 | OTLP 主 API Key。 |
Dashboard:Otlp:SecondaryApiKey | 字符串 | 轮换期间使用的备用 Key。 |
Dashboard:Api:AuthMode | Unsecured / ApiKey | HTTP 遥测 API 的认证。 |
Dashboard:Api:PrimaryApiKey | 字符串 | HTTP API 主 Key。 |
Dashboard:Api:Enabled | true / false | 是否启用 HTTP 遥测 API。 |
资源服务（AppHost 连接）
| 配置键 | 说明 |
|---|---|
Dashboard:ResourceServiceClient:Url | AppHost 资源服务地址。 |
Dashboard:ResourceServiceClient:AuthMode | Unsecured / ApiKey / Certificate |
Dashboard:ResourceServiceClient:ApiKey | 访问资源服务的 API Key。 |
遥测上限
| 配置键 | 说明 |
|---|---|
Dashboard:TelemetryLimits:MaxLogCount | 保留的最大日志条数。 |
Dashboard:TelemetryLimits:MaxTraceCount | 保留的最大追踪数。 |
Dashboard:TelemetryLimits:MaxMetricsCount | 保留的最大指标数。 |
Dashboard:TelemetryLimits:MaxSpanEventCount | 单个 span 的最大事件数。 |
Dashboard:TelemetryLimits:MaxAttributeCount / MaxAttributeLength | 属性数量与长度上限。 |
Dashboard:TelemetryLimits:MaxResourceCount | 最大资源数。 |
数据持久化
| 配置键 | 说明 |
|---|---|
Dashboard:Data:PersistenceMode | 持久化模式（如仅内存、落盘）。 |
Dashboard:Data:Directory | 数据目录。 |
UI 行为
| 配置键 | 说明 |
|---|---|
Dashboard:UI:DisableResourceGraph | 关闭资源关系图。 |
Dashboard:UI:DisableAgentHelp | 关闭代理帮助入口。 |
Dashboard:UI:DisableImport | 关闭数据导入。 |
Dashboard:Frontend:MaxConsoleLogCount | 前端控制台日志上限。 |
OTLP 相关
| 配置键 | 说明 |
|---|---|
Dashboard:Otlp:Cors:AllowedOrigins | 允许跨域发送遥测的来源。 |
Dashboard:Otlp:Cors:AllowedHeaders | 允许的请求头。 |
Dashboard:Otlp:AllowedCertificates | 允许的客户端证书（证书认证场景）。 |
Dashboard:Otlp:SuppressUnsecuredMessage | 关闭「未启用认证」的警告提示。 |
配置方式
json
{
"Dashboard": {
"Frontend": {
"AuthMode": "BrowserToken"
},
"TelemetryLimits": {
"MaxLogCount": 20000
}
}
}bash
Dashboard__Frontend__AuthMode=BrowserToken
Dashboard__TelemetryLimits__MaxLogCount=20000bash
docker run --rm -it -d --name aspire-dashboard \
-p 18888:18888 -p 4317:18889 -p 4318:18890 \
-e ASPIRE_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS=false \
mcr.microsoft.com/aspire/dashboard:latest配置键到环境变量的转换
.NET 配置中冒号（:）在环境变量里写成双下划线（__）。因此 Dashboard:Frontend:AuthMode 对应 Dashboard__Frontend__AuthMode。
调整遥测上限
默认上限对大多数场景足够。如果应用日志量大，仪表板会出现「数据被截断」提示，这时按需调大 MaxLogCount 等配置即可。
上限过高会占用内存
遥测数据默认保存在内存中，上限调得过高会显著增加仪表板进程的内存占用。
