高级设置
使用 **高级设置** 页面修改控制 OpenSearch Dashboards 行为的设置。这些设置可用于自定义应用程序的外观和感觉、更改某些功能的行为等。界面视图如下图所示。
要访问 **高级设置**，请前往 **仪表板管理** 并选择 **高级设置**。该页面分为以下几个部分：常规、外观、发现、通知、搜索、时间线 和 可视化。每个部分都包含一组相应的设置。您可以通过编辑其字段来修改这些设置。完成更改后，选择 **保存** 以应用它们。
**注意**
某些设置要求您修改 opensearch_dashboards.yml 文件 并重启 OpenSearch Dashboards。
所需权限
要修改设置，您必须拥有修改权限。有关向租户分配角色访问权限的指导，请参阅多租户配置。
高级设置说明
下表描述了核心高级设置。
常规设置
下表描述了 **常规** 设置。
| 设置 | 描述 |
|---|---|
csv:quoteValues | 定义是否将包含特殊字符或多行值的值用双引号 " 括起来。默认值为 开启。 |
csv:separator | 定义是否使用特定字符或字符串来分隔导出的值。默认值为 ,。 |
dateFormat | 定义日期的显示格式。默认值为 MMM D, YYYY @ HH:mm:ss.SSS。 |
dateFormat:dow | 定义一周的开始日期。默认值为 Sunday。 |
dateFormat:scaled | 定义时间戳的格式。时间戳格式根据测量之间的时间量（小时、分钟、秒和毫秒）而变化。键是 ISO8601 格式的时间段：YYYY-MM-DD。 |
dateFormat:tz | 定义 OpenSearch Dashboards 的时区。默认值为浏览器检测到的时区。 |
dateNanosFormat | 定义表示带纳秒的日期的格式。默认值为 MMM D, YYYY @ HH:mm:ss.SSSSSSSSS。 |
defaultIndex | 定义 OpenSearch 集群中所有索引的默认索引。如果没有添加索引，defaultIndex 将设置为 null。但是，如果添加了一个或多个索引，defaultIndex 将被赋值为列表中第一个索引的值。默认值为 null。 |
defaultRoute | 定义网关入口点。使用此设置可更改 OpenSearch Dashboards 的着陆页。该设置必须是相对 URL。默认值为 /app/home。 |
fields:popularLimit | 定义要显示的 N 个字段的数量。默认值为 10。 |
filterEditor:suggestValues | 定义过滤器编辑器是否建议字段值。默认值为 关闭。 |
filters:pinnedByDefault | 定义过滤器是否自动固定。要使过滤器在所有应用程序中可见，您可以选择该过滤器，然后选择 **固定到所有应用** 选项。默认值为 关闭。 |
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 | 定义 * 是否允许作为查询子句中的第一个字符。默认值为 开启。 |
query:queryString:options | 定义 Lucene 查询字符串解析器的选项。默认值为 { "analyze_wildcard": true }。 |
reporting:useFOR | 启用或禁用 ForeignObject 渲染，以便将外部内容嵌入到报告中。reporting:useFOR 和 reporting:useOcr 选项仅在安装报告插件后可见。默认值为 开启。 |
reporting:useOcr | 启用或禁用 PDF 报告上的光学字符识别 (OCR)。reporting:useFOR 和 reporting:useOcr 选项仅在安装报告插件后可见。默认值为 关闭。 |
savedObjects:listingLimit | 定义在查看列表页面时要获取的对象数量。默认值为 1000。 |
savedObjects:perPage | 定义在加载对话框的每页上显示的对象数量。默认值为 20。 |
search:queryLanguage | 定义 OpenSearch Dashboards 的查询语言。默认值为 DQL。 |
shortDots:enable | 启用或禁用长字段的缩短功能。默认值为 关闭。 |
sort:options | 定义排序参数的选项。默认值为 boolean。 |
state:storeInSessionStorage | 启用或禁用 URL 会话存储。默认值为 关闭。 |
timepicker:quickRanges | 定义要在时间过滤器中显示的快速选择时间范围。 |
timepicker:refreshIntervalDefaults | 定义时间过滤器的默认刷新间隔，单位为毫秒。默认值为 0。 |
timepicker:timeDefaults | 定义数据分析的默认时间段。默认值为 Last 15 minutes。 |
truncate:maxHeight | 定义表格单元格的最大高度。默认值为 115 像素。 |
外观设置
下表描述了 **外观** 设置。
| 设置 | 描述 |
|---|---|
accessibility:disableAnimations | 启用或禁用动画。默认值为 关闭。 |
pageNavigation | 定义导航窗格样式。默认值为 Modern。 |
theme:darkMode | 启用或禁用深色模式。默认值为 关闭。深色模式仅在 OpenSearch Dashboards 2.10 及更高版本中可用。 |
theme:version | 定义 OpenSearch Dashboards 当前版本及后续版本要使用的主题。默认值为 v7。 |
发现设置
下表描述了 **发现** 设置。
| 设置 | 描述 |
|---|---|
context:defaultSize | 定义在上下文视图中显示的周围条目数量。默认值为 5。 |
context:step | 定义上下文大小增量或减量的步长。默认值为 5。 |
context:tieBreakerFields | 定义用于打破时间戳值相同的文档之间僵局的字段。使用当前索引模式中存在且可排序的第一个字段。默认值为 _doc。 |
defaultColumns | 定义在 **发现** 页面上默认显示的列。默认值为 _source。 |
discover:aggs:terms:size | 定义在字段下拉菜单中选择 **可视化** 按钮时可视化的词项数量。默认值为 20。 |
discover:modifyColumnsOnSwitch | 定义是否从新索引模式中移除不可用的列。默认值为 开启。 |
discover:sampleSize | 定义表格中显示的行数。默认值为 20。 |
discover:searchOnPageLoad | 定义首次加载 Discover 时是否运行搜索。此设置不影响已保存搜索的加载。默认值为 On。 |
discover:sort:defaultOrder | 定义如何对基于时间的索引模式进行排序。默认值为 Descending。 |
doc_table:hideTimeColumn | 定义是否在 Discover 应用程序和所有已保存的仪表板搜索中隐藏 Time 列。默认值为 Off。 |
doc_table:highlight | 定义是否在 Discover 应用程序和仪表板上已保存的搜索中突出显示结果。突出显示可以更容易地查找和识别结果，但在处理大型文档时，也可能减慢请求速度。 |
通知设置
下表描述了 通知 设置。
| 设置 | 描述 |
|---|---|
notifications:banner | 定义临时用户通知的自定义横幅。支持 Markdown。 |
notifications:lifetime:banner | 定义横幅通知的显示持续时间。默认值为 3000000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:error | 定义错误通知的显示持续时间。默认值为 300000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:info | 定义信息通知的显示持续时间。默认值为 5000 毫秒。将字段设置为 Infinity 可禁用通知。 |
notifications:lifetime:warning | 定义警告通知的显示持续时间。默认值为 10000 毫秒。将字段设置为 Infinity 可禁用通知。 |
搜索设置
下表描述了 搜索 设置。
| 设置 | 描述 |
|---|---|
courier:batchSearches | 启用或禁用仪表板面板的加载方式。禁用时，面板单独加载，当用户离开或更新查询时，搜索请求结束。启用时，所有数据加载完成后，所有面板一起加载，且搜索不会结束。默认值为 Off。 |
courier:customRequestPreference | 指定是否将 请求偏好设置 与 custom 设置一起使用。默认值为 _local。 |
courier:ignoreFilterIfFieldNotInIndex | 启用或禁用对包含使用不同索引的可视化的仪表板的支持。禁用时，所有过滤器将应用于所有可视化。启用时，如果可视化的索引不包含正在过滤的字段，则可视化过滤器将被忽略。默认值为 Off。 |
courier:maxConcurrentShardRequests | 定义 OpenSearch Dashboards 可以为 _msearch 请求发起的并发分片请求的最大数量。设置为 0 可禁用此设置并使用 OpenSearch 设置的默认值。默认值为 0。 |
courier:setRequestPreference | 定义哪些分片处理您的搜索请求。选项包括 会话 ID、自定义 和 无。会话 ID 限制操作，使所有搜索请求在同一分片上运行，并在请求之间重用分片缓存，从而提高性能。自定义 用于定义您自己的偏好设置。使用 courier:customRequestPreference 来自定义您的偏好值。无 意味着未设置任何偏好。此选项可以提供更好的性能，因为请求可以分布在所有分片副本上。但是，结果可能不一致，因为不同的分片可能处于不同的刷新状态。默认值为 Session ID。 |
search:includeFrozen | 指定是否在搜索结果中包含冻结索引。如果启用，冻结索引将包含在搜索结果中。搜索冻结索引会增加搜索时间。默认值为 Off。 |
时间轴设置
下表描述了 时间轴 设置。
| 设置 | 描述 |
|---|---|
timeline:es.default_index | 定义使用 .opensearch() 函数搜索的默认 OpenSearch 索引。如果未设置，则 .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 密钥）。 |
timeline:target_buckets | 定义 OpenSearch Dashboards 在可视化中计算自动间隔时尝试使用的桶数。默认值为 200。 |
可视化设置
下表描述了 可视化 设置。
| 设置 | 描述 |
|---|---|
visualization:colorMapping | 为可视化中的值分配颜色。默认值为 #00A69B。 |
visualization:dimmingOpacity | 定义当其他图表元素被突出显示时，变暗的图表项目的不透明度。值越低，突出显示的元素就越突出。该值必须介于 0 和 1 之间。默认值为 0.5。 |
visualization:enablePluginAugmentation | 启用或禁用通过折线图可视化访问插件功能。默认值为 On。 |
` 折线图可视化 | 定义每个可视化关联的最大增强数量。默认值为 10`。为每个可视化关联超过 10 个插件资源可能会导致性能问题。 | |
visualization:heatmap:maxBuckets | 定义单个数据源在热力图可视化中可以返回的最大桶数。桶数越高，可能会对浏览器渲染性能产生负面影响。默认值为 50。 |
visualization:regionmap:customVectorMapMaxSize | 定义可以从自定义矢量地图加载的最大特征数。默认值为 1000。 |
visualization:regionmap:showWarnings | 指定当术语无法与区域地图上的形状关联时是否显示警告。默认值为 On。 |
visualization:tileMap:WMSdefaults | 定义坐标地图中 Web 地图服务 (WMS) 地图服务器的默认 属性。默认值为 enabled: false。 |
visualization:tileMap:maxPrecision | 定义可以在地图上显示的最大地理哈希精度，其中 7 为高，10 为非常高，12 为最大值。默认值为 7。 |
visualize:disableBucketAgg | 停用可视化中的特定桶聚合。此设置接受逗号分隔的桶聚合名称列表，例如 significant_terms 和 terms。 |
visualize:enableLabs | 启用或禁用实验性可视化。启用时，您可以创建、查看和编辑实验性可视化。禁用时，您只能使用可投入生产的可视化。默认值为 On。 |