高级设置
使用 高级设置（Advanced settings） 页面可以修改管理 UDB-SX Dashboards 行为的设置。你可以使用这些设置来自定义应用的外观和感受、更改某些功能的行为等等。界面示例如下图所示。
要访问 高级设置，转到 控制面板管理 并选择 高级设置。该页面分为以下部分：常规、外观、发现、通知、搜索、时间线和可视化。每个部分包含其各自的一组设置。你可以通过编辑字段来修改这些设置。修改完成后，选择 保存更改 以应用更改。某些设置需要修改 [udbsx_dashboards.yml 文件] 并重启 UDB-SX Dashboards。
所需权限
要修改设置，你必须具有进行更改的权限。有关将角色访问权限分配给租户的指导，请参阅多租户配置。
高级设置说明
以下表格说明核心高级设置。
常规设置
| Setting | Description |
|---|---|
csv:quoteValues |
定义是否对包含特殊字符或多行值的值使用双引号 " 包裹。默认值为 On。 |
csv:separator |
定义导出值的分隔符字符或字符串。默认值为 ,。 |
dateFormat |
定义显示日期的格式。默认值为 MMM D, YYYY @ HH:mm:ss.SSS。 |
dateFormat:dow |
定义一周从哪一天开始。默认值为 Sunday。 |
dateFormat:scaled |
定义时间戳的格式。时间戳格式会根据测量间隔（小时、分钟、秒和毫秒）的不同而变化。键为 ISO8601 格式的时间段：YYYY-MM-DD。 |
dateFormat:tz |
定义 UDB-SX Dashboards 使用的时区。默认使用浏览器检测到的时区。 |
dateNanosFormat |
定义以纳秒表示的日期格式。默认值为 MMM D, YYYY @ HH:mm:ss.SSSSSSSSS。 |
defaultIndex |
定义 UDB-SX 集群中所有索引的默认索引。如果未添加任何索引，defaultIndex 为 null。但如果添加了一个或多个索引，defaultIndex 会被分配为列表中的第一个索引。默认值为 null。 |
defaultRoute |
定义入口点。使用此设置可更改 UDB-SX Dashboards 的着陆页。该设置必须为相对 URL。默认值为 /app/home。 |
fields:popularLimit |
定义要显示的 N 个热门字段的数量。默认值为 10。 |
filterEditor:suggestValues |
定义筛选编辑器是否建议字段值。默认值为 Off。 |
filters:pinnedByDefault |
定义筛选器是否默认固定。要使筛选器在所有应用中都可见，可以选择筛选器然后选择 Pin across all apps。默认值为 Off。 |
format:bytes:defaultPattern |
定义字节格式的默认数字格式。默认值为 0,0.[0]b。 |
format:currency:defaultPattern |
定义货币格式的默认数字格式。默认值为 ($0,0.[00])。 |
format:defaultTypeMap |
使用映射定义每种字段类型的默认格式名称。如果字段类型未指定，则使用 _default_。 |
format:number:defaultLocale |
定义数字的语言区域。默认值为 en。 |
format:number:defaultPattern |
定义数字格式的默认数字格式。默认值为 0,0.[000]。 |
format:percent:defaultPattern |
定义百分比格式的默认数字格式。默认值为 0,0.[000]%。 |
histogram:barTarget |
为使用 auto 间隔的日期直方图定义指定的柱条数量。默认值为 50。 |
histogram:maxBars |
定义日期直方图中显示的最大柱条数。默认值为 100。 |
history:limit |
定义要在历史记录中存储的最近值数量。默认值为 10。 |
indexPattern:placeholder |
定义创建索引模式时使用的占位符值。 |
metaFields |
启用非 _source 字段合并到文档中。默认包括 _source、_id、_type、_index 和 _score。 |
metrics:max_buckets |
定义单个数据源可返回的最大桶数。默认值为 2000。 |
query:allowLeadingWildcards |
定义在查询子句中是否允许 * 作为第一个字符。默认值为 On。 |
query:queryString:options |
定义 Lucene 查询字符串解析器的选项。默认值为 { "analyze_wildcard": true }。 |
reporting:useFOR |
启用或禁用用于在报表中嵌入外部内容的 ForeignObject 渲染。reporting:useFOR 和 reporting:useOcr 仅在安装 reporting 插件后可见。默认值为 On。 |
reporting:useOcr |
启用或禁用 PDF 报表的光学字符识别（OCR）。reporting:useFOR 和 reporting:useOcr 仅在安装 reporting 插件后可见。默认值为 Off。 |
savedObjects:listingLimit |
定义在查看列表页面时要获取的对象数量。默认值为 1000。 |
savedObjects:perPage |
定义加载对话框中每页显示的对象数量。默认值为 20。 |
search:queryLanguage |
定义 UDB-SX Dashboards 的查询语言。默认值为 DQL。 |
shortDots:enable |
启用或禁用长字段缩写功能。默认值为 Off。 |
sort:options |
定义排序参数的选项。默认值为 boolean。 |
state:storeInSessionStorage |
启用或禁用 URL 会话存储。默认值为 Off。 |
timepicker:quickRanges |
定义时间筛选中显示的快速选择时间范围。 |
timepicker:refreshIntervalDefaults |
定义时间筛选的默认刷新间隔（毫秒）。默认值为 0。 |
timepicker:timeDefaults |
定义数据分析的默认时间段。默认值为 Last 15 minutes。 |
truncate:maxHeight |
定义表格单元格的最大高度。默认值为 115 像素。 |
外观设置
| Setting | Description |
|---|---|
accessibility:disableAnimations |
启用或禁用动画。默认值为 Off。 |
pageNavigation |
定义导航窗格样式。默认值为 Modern。 |
theme:darkMode |
启用或禁用深色模式。默认值为 Off。深色模式仅在 UDB-SX Dashboards 2.10 及更高版本可用。 |
theme:version |
定义当前及后续版本使用的主题。默认值为 v7。 |
发现设置
| Setting | Description |
|---|---|
context:defaultSize |
定义在上下文视图中显示的周边条目数量。默认值为 5。 |
context:step |
定义上下文大小的增量。默认值为 5。 |
context:tieBreakerFields |
定义用于在具有相同时间戳值的文档之间破平局的字段。使用当前索引模式中第一个存在且可排序的字段。默认值为 _doc。 |
defaultColumns |
定义 Discover 页面默认显示的列。默认值为 _source。 |
discover:aggs:terms:size |
定义在字段下拉菜单中选择 Visualize 时可视化的术语数量。默认值为 20。 |
discover:modifyColumnsOnSwitch |
定义在切换索引模式时是否移除不可用列。默认值为 On。 |
discover:sampleSize |
定义表中显示的行数。默认值为 20。 |
discover:searchOnPageLoad |
定义 Discover 首次加载时是否运行搜索。该设置不影响已保存搜索的加载。默认值为 On。 |
discover:sort:defaultOrder |
定义时间型索引模式的排序方式。默认值为 Descending。 |
doc_table:hideTimeColumn |
定义是否在 Discover 应用和所有已保存仪表板搜索中隐藏 Time 列。默认值为 Off。 |
doc_table:highlight |
定义是否在 Discover 应用和仪表板的已保存搜索中高亮显示结果。高亮有助于查找和识别结果，但在处理大文档时可能会降低请求速度。 |
通知设置
| Setting | Description |
|---|---|
notifications:banner |
定义用于临时用户通知的自定义横幅。支持 Markdown。 |
notifications:lifetime:banner |
定义横幅通知的显示时长。默认值为 3000000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:error |
定义错误通知的显示时长。默认值为 300000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:info |
定义信息通知的显示时长。默认值为 5000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:warning |
定义警告通知的显示时长。默认值为 10000 毫秒。将字段设置为 Infinity 可禁用通知。 |
搜索设置
| Setting | Description |
|---|---|
courier:batchSearches |
启用或禁用仪表板面板的加载方式。禁用时，面板单独加载，且当用户导航或更新查询时搜索请求会终止。启用时，当所有数据加载完毕后，所有面板一起加载，并且搜索不会终止。默认值为 Off。 |
courier:customRequestPreference |
指定是否将 请求偏好设置 与 custom 设置一起使用。默认值为 _local。 |
courier:ignoreFilterIfFieldNotInIndex |
启用或禁用对使用不同索引的可视化的仪表板的支持。禁用时，所有过滤器将应用于所有可视化。启用时，如果可视化的索引不包含被过滤的字段，则忽略该可视化的过滤器。默认值为 Off。 |
courier:maxConcurrentShardRequests |
定义 UDB-SX Dashboards 可为 _msearch 请求发起的最大并发分片请求数。设置为 0 可禁用该设置并使用 UDB-SX 设置的默认值。默认值为 0。 |
courier:setRequestPreference |
定义哪个分片处理你的搜索请求。选项包括 Session ID、Custom 和 None。Session ID 限制操作以便所有搜索请求在相同分片上运行并重用分片缓存，可能提高性能。Custom 用于定义自定义偏好值。使用 courier:customRequestPreference 可自定义你的偏好值。None 表示不设置偏好，此选项可能提供更好性能（请求可分散到所有分片副本），但结果可能不一致，因为不同分片可能处于不同的刷新状态。默认值为 Session ID。 |
search:includeFrozen |
指定是否在搜索结果中包含冻结索引。启用后，冻结索引将包含在搜索结果中。搜索冻结索引可能会增加搜索时间。默认值为 Off。 |
时间线设置
| Setting | Description |
|---|---|
timeline:es.default_index |
定义使用 .opensearch() 函数时默认要搜索的 UDB-SX 索引。如果未设置，则 .opensearch() 函数将搜索所有索引。默认值为 _all。 |
timeline:es.timefield |
定义使用 .opensearch() 函数时的默认时间戳字段。如果未设置，则 .opensearch() 函数使用 @timestmap 字段。默认值为 @timestmap。 |
timeline:graphite.url |
（实验性）定义 graphite 主机 URL。 |
timeline:max_buckets |
定义单个数据源可返回的最大桶数。默认值为 2000。 |
timeline:min_interval |
定义在使用 auto 间隔时计算的最小间隔。默认值为 1ms。 |
timeline:quandl.key |
（实验性）定义你访问 Quandl 数据所需的唯一标识符（API key）。 |
timeline:target_buckets |
定义 UDB-SX Dashboards 在为可视化计算自动间隔时尝试使用的桶数量。默认值为 200。 |
可视化设置
| Setting | Description |
|---|---|
visualization:colorMapping |
为可视化中的值分配颜色。默认值为 #00A69B。 |
visualization:dimmingOpacity |
定义当突出显示其他图表元素时被变暗的图表项的不透明度。值越低，突出显示的元素越显眼。该值必须在 0 到 1 之间。默认值为 0.5。 |
visualization:enablePluginAugmentation |
启用或禁用通过折线图可视化访问插件功能。默认值为 On。 |
line chart visualizations |
定义每个可视化关联的最大增强（augmentation）数。默认值为 10。每个可视化关联超过 10 个插件资源可能导致性能问题。 |
visualization:heatmap:maxBuckets |
定义单个数据源在热力图可视化中可返回的最大桶数。较高的桶数可能对浏览器渲染性能产生负面影响。默认值为 50。 |
visualization:regionmap:customVectorMapMaxSize |
定义可从自定义矢量地图加载的最大要素数。默认值为 1000。 |
visualization:regionmap:showWarnings |
指定当术语无法与区域地图上的形状匹配时是否显示警告。默认值为 On。 |
visualization:tileMap:WMSdefaults |
定义坐标地图中 Web Map Service (WMS) 地图服务器的默认 属性。默认值为 enabled: false。 |
visualization:tileMap:maxPrecision |
定义地图上可显示的最大 geohash 精度，7 表示高，10 表示非常高，12 为最大值。默认值为 7。 |
visualize:disableBucketAgg |
在可视化中停用特定的 bucket 聚合。该设置接受逗号分隔的 bucket 聚合名称列表，例如 significant_terms 和 terms。 |
visualize:enableLabs |
启用或禁用实验性可视化。启用后，你可以创建、查看和编辑实验性可视化；禁用时只能使用生产就绪的可视化。默认值为 On。 |