« 发行说明 Kibana 8.17.0 »
Elastic 文档 ›Kibana 指南 [8.17] ›发行说明

升级说明

编辑

升级说明

编辑

在升级之前，请查看 Kibana 8.x 中引入的重大变更和弃用，然后缓解其影响。

有关 Elastic 安全版本信息，请参阅Elastic 安全解决方案发行说明。

重大变更

编辑

Kibana API

编辑
获取案例指标 API 已变为内部 API。(8.10)

详细信息
获取案例指标 API 现在是内部 API。有关详细信息，请参阅 (#162506)。

删除了旧的项目监视器 API。(8.8)

详细信息
已删除 Elastic Observability 中 Synthetics 的项目监视器 API。有关详细信息，请参阅#155470。

影响
在 8.8.0 及更高版本中，当您使用项目监视器 API 时会出现错误。

删除了 current_upgrades 端点。(8.7)

详细信息
已删除 /api/fleet/current_upgrades 端点。有关详细信息，请参阅#147616。

影响
升级到 8.7.0 时，请使用 api/fleet/agents/action_status 端点。

删除了 preconfiguration API 路由。(8.7)

详细信息
已删除错误地作为通用版本发布的 /api/fleet/setup/preconfiguration API。有关详细信息，请参阅#147199。

影响
请勿使用 /api/fleet/setup/preconfiguration。要管理预配置的代理策略，请使用 kibana.yml。有关详细信息，请查看预配置设置。

更新了批量操作 API，以返回 actionId 而不是代理成功。(8.5)

详细信息
为了使批量操作响应保持一致，返回 actionId，而不是具有 success: True 或 success: False 结果的代理 ID。有关详细信息，请参阅#141757。

影响
当您使用 FleetBulkResponse 时，现在只会收到 actionId 响应。

从日志和指标 API 以及已保存的对象中删除了已弃用的配置字段。(8.0)

详细信息
在日志和指标 UI 上，已删除对以下 API 和已保存对象中已弃用字段的引用

  • timestamp
  • tiebreaker
  • container
  • pod
  • host

有关详细信息，请参阅#116821 和 #115874。

影响
当您升级到 8.0.0 时，您将无法使用对已弃用字段的引用。

删除了 /api/settings。(8.0)

详细信息
已删除 /api/settings REST API。有关详细信息，请参阅#114730。

影响
使用 /api/stats。

更改了 GET /api/status 的默认行为。(8.0)

详细信息
GET /api/status 报告了一个新的、更详细的有效负载。有关详细信息，请参阅#110830。

影响
要检索以前格式的 Kibana 状态，请使用 GET /api/status?v7format=true。

Kibana 平台

编辑
[警报] 一个新的子功能权限，用于控制用户对案例设置的访问。(8.12)

详细信息
配置了至少一个子功能权限的角色将无法像以前那样访问案例设置。所有未配置子功能权限的角色将不会受到影响。有关详细信息，请参阅 (#170635)。

[警报] 新的案例限制。(8.10)

详细信息
现在，对案例可以处理的对象数量或这些对象可以存储的数据量施加了限制。

有关完整列表，请参阅 #146945。

[警报] 更改了警报和案例的权限。(8.8)

详细信息
将警报附加到案例的权限已更改。有关详细信息，请参阅#147985。

影响
要将警报附加到案例，您必须对具有警报的 Observability 或 Security 功能具有 读取访问权限，并且对案例功能具有 全部访问权限。有关详细信息，请查看Kibana 权限和配置对案例的访问。

[警报] 删除了对 monitoring.cluster_alerts.allowedSpaces 的支持。(8.0)

详细信息
已删除 Kibana 用来创建 Stack Monitoring 警报的 monitoring.cluster_alerts.allowedSpaces 设置。有关详细信息，请参阅#123229。

影响
在升级到 8.0.0 之前，请从 kibana.yml 中删除 monitoring.cluster_alerts.allowedSpaces。

[警报] 删除了 xpack.task_manager.index 设置。(8.0)

详细信息
已删除 xpack.task_manager.index 设置。有关详细信息，请参阅#114558。

影响
在升级到 8.0.0 之前，请从 kibana.yml 中删除 xpack.task_manager.index。

[警报] 删除了删除 Elastic 管理的插件的功能。(8.0)

详细信息
已删除 xpack.actions.enabled 设置。有关详细信息，请参阅#113461。

影响
在升级到 8.0.0 之前，请从 kibana.yml 中删除 xpack.actions.enabled。

[数据视图] 删除了对临时数据视图的筛选器验证 (8.5)

详细信息
与未知数据视图（例如已删除的数据视图）关联的筛选器不再自动禁用。有关详细信息，请参阅#139431。

影响
与未知数据视图关联的筛选器现在会显示警告消息，而不是自动禁用。

[开发工具] 从控制台中删除了 addProcessorDefinition 函数。(8.10)

详细信息
从控制台插件启动合约（服务器端）中删除了函数 addProcessorDefinition。有关详细信息，请参阅 (#159041)。

[开发工具] 删除了 console.ssl 设置。(8.0)

详细信息
已删除 console.ssl 设置。有关详细信息，请参阅#123754。

影响
在升级到 8.0.0 之前，请从 kibana.yml 中删除 console.ssl。

[Elastic Common Schema] 将 doc_root.vulnerability.package 移至 doc_root.package (ECS)。(8.11)

详细信息
此更改会将 vulnerability.package 的所有实例更新为 ECS 标准包字段集。有关详细信息，请参阅 (#164651)。

[ES|QL] 重命名了用于启用 ES|QL 的高级设置。(8.14)

详细信息
从 UI 中隐藏 ES|QL 的高级设置已从 discover:enableESQL 重命名为 enableESQL。它默认启用，并且必须关闭才能从 Kibana 应用程序中禁用 ES|QL 功能。有关详细信息，请参阅 (#182074)。

[ES|QL] 从 ES|QL 中删除了 is_nan、is_finite 和 is_infinite 函数。(8.13)

详细信息
这些函数已从 ES|QL 查询中删除，因为它们不受支持。尝试使用它们时会抛出错误。有关详细信息，请参阅 (#174674)。

[Fleet] 添加了对通过上传端点进行安装的速率限制。(8.15)

详细信息
已向上传 api/fleet/epm/packages 端点添加了速率限制。有关详细信息，请参阅 #184036。

影响
如果您在不到 10 秒的时间内发出两个或更多请求，则后续请求会失败，并显示 429 请求过多。请等待 10 秒后再上传。此更改可能会破坏依赖于频繁包上传的用户的自动化。

[Fleet]删除了 Kafka 输出的条件主题。(8.13)

详细信息
Kafka 输出不再支持条件主题。有关详细信息，请参阅 (#176879)。

[Fleet]大多数 Fleet 安装的集成现在都是只读的，并在 Kibana UI 中标记为已管理标记。(8.13)

详细信息

Fleet 安装的集成内容不再可编辑。此内容在 Kibana UI 中标记为已管理，并且由 Elastic 管理。此内容无法编辑或删除。但是，可以克隆托管的可视化、仪表板和已保存的搜索。可以自定义克隆。

克隆仪表板时，克隆的面板将成为与原始配置和依赖项无关的完全独立的副本。

对于与特定可视化编辑器（如 Lens、TSVB 和 Maps）相关的托管内容，克隆会保留原始参考配置。这同样适用于编辑托管可视化中的任何已保存的搜索。

有关详细信息，请参阅 (#172393)。

[Fleet] 改进了默认输出的配置输出验证。(8.11)

详细信息
改进了配置输出验证，以不允许在 Kibana 配置中定义多个默认输出。有关详细信息，请参阅 (#167085)。

[Fleet] 从代理策略已保存的对象中删除了 package_policies 字段。(8.5)

详细信息
已删除代理策略和包策略之间的双向外键。有关详细信息，请参阅#138677。

影响
代理策略已保存的对象不再包括 package_policies 字段。

[Fleet] 在 kibana.yml 中定义时，xpack.agents.* 现在在 UI 中不可编辑。(8.4)

详细信息
当您在 kibana.yml 中配置 xpack.fleet.agents.fleet_server.hosts 和 xpack.fleet.agents.elasticsearch.hosts 时，您将无法在 Fleet UI 上更新这些字段。

有关详细信息，请参阅#135669。

影响
要在 Fleet UI 上配置 xpack.fleet.agents.fleet_server.hosts 和 xpack.fleet.agents.elasticsearch.hosts，请避免在 kibana.yml 中配置这些设置。

[Fleet] 为 Fleet 拆分包策略 upgrade 端点。(8.0)

详细信息
对于包策略升级，packagePolicy upgrade 端点格式支持可变升级操作（当 dryRun: false 时）和只读的干运行操作（当 dryRun: true 时）

 POST /package_policies/upgrade
 {
   packagePolicyIds: [...],
   dryRun: false
 }

有关详细信息，请参阅#118854。

影响
该端点现在分为两个单独的端点

 POST /package_policies/upgrade
 {
   packagePolicyIds: [...]
 }

 POST /package_policies/upgrade/dry_run
 {
   packagePolicyIds: [...]
 }
[常规设置] 更新了关闭期间的请求处理。(8.16)

详细信息
在关闭期间，Kibana 现在会根据 server.shutdownTimeout 设置等待所有正在进行的请求完成。在此期间，传入的套接字将被关闭，并且任何新的传入请求都将被拒绝。在此更新之前，新的传入请求会收到状态代码为 503 的响应，以及包含 {"message": "Kibana is shutting down and not accepting new incoming requests"} 的正文。有关更多信息，请参阅 #180986。

[通用设置] 移除 CONFIG_PATH 和 DATA_PATH 环境变量。(8.0)

详细信息
已移除 CONFIG_PATH 和 DATA_PATH 环境变量。有关更多信息，请参阅 #111535。

影响
将 CONFIG_PATH 环境变量替换为 KBN_PATH_CONF，并将 DATA_PATH 替换为 path.data 设置。

[通用设置] 移除对 csp.rules 配置的支持。(8.0)

详细信息
已移除对 csp.rules 配置属性的支持。有关更多信息，请参阅 #114379。

影响
不再需要配置默认的 csp.script_src、csp.workers_src 和 csp.style_src 值。

[通用设置] 更改并移除了已弃用的核心设置和核心插件中的已弃用设置。(8.0)

详细信息
server.cors 的弃用通知已从 level:critical 更改为 level:warning。

以下设置已更改

  • xpack.banners.placement 的 header 值已重命名为 top

已移除对以下配置设置的支持

  • newsfeed.defaultLanguage
  • cpu.cgroup.path.override
  • cpuacct.cgroup.path.override
  • server.xsrf.whitelist
  • xpack.xpack_main.xpack_api_polling_frequency_millis
  • KIBANA_PATH_CONF

有关更多信息，请参阅 #113653。

影响
* 提供给 xpack.banners.placement 配置的 header 值已重命名为 top * 根据浏览器区域设置检索 newsfeed.defaultLanguage 新闻源项目，默认为英语 * 将 cpu.cgroup.path.override 替换为 ops.cGroupOverrides.cpuPath * 将 cpuacct.cgroup.path.override 替换为 ops.cGroupOverrides.cpuAcctPath * 将 server.xsrf.whitelist 替换为 server.xsrf.allowlist * 将 xpack.xpack_main.xpack_api_polling_frequency_millis 替换为 xpack.licensing.api_polling_frequency * 使用 KBN_PATH_CONF 环境变量替换指向 Kibana 配置文件的 KIBANA_PATH_CONF 路径

[通用设置] 移除插件中的 enabled 设置。(8.0)

详细信息
已移除使用 {plugin_name}.enabled 来禁用插件的功能。某些插件，如 telemetry、newsfeed、reporting 和各种 vis_type 插件，将继续支持此设置。所有其他 Kibana 插件将不支持此设置。任何新插件只有在 configSchema 中指定时才会支持此设置。有关更多信息，请参阅 #113495。

已移除 xpack.security.enabled 设置。有关更多信息，请参阅 #111681。

影响
在升级到 8.0.0 之前

  • 从 kibana.yml 中删除 {plugin_name}.enabled。如果使用该设置来控制用户对 Kibana 应用程序的访问，请改用 功能 控制。
  • 将 xpack.security.enabled 替换为 elasticsearch.yml 中的 xpack.security.enabled。
[通用设置] 移除 --plugin-dir 命令行选项。(8.0)

详细信息
已移除 plugins.scanDirs 设置和 --plugin-dir 命令行选项。有关更多信息，请参阅 #113367。

影响
在升级到 8.0.0 之前，从 kibana.yml 中删除 plugins.scanDirs。

[通用设置] 移除对 optimize.* 设置的支持。(8.0)

详细信息
已移除旧的 optimize.* 设置。如果您的配置使用以下旧的 optimize.* 设置，Kibana 将无法启动

  • optimize.lazy
  • optimize.lazyPort
  • optimize.lazyHost
  • optimize.lazyPrebuild
  • optimize.lazyProxyTimeout
  • optimize.enabled
  • optimize.bundleFilter
  • optimize.bundleDir
  • optimize.viewCaching
  • optimize.watch
  • optimize.watchPort
  • optimize.watchHost
  • optimize.watchPrebuild
  • optimize.watchProxyTimeout
  • optimize.useBundleCache
  • optimize.sourceMaps
  • optimize.workers
  • optimize.profile
  • optimize.validateSyntaxOfNodeModules

有关更多信息，请参阅 #113296。

影响
要在开发中单独运行 @kbn/optimizer，请将 --no-optimizer 传递给 yarn start。有关更多详细信息，请参阅 #73154。

[通用设置] 移除 so/server/es 设置。(8.0)

详细信息
已移除一些 savedObjects、server 和 elasticsearch 设置。如果您的配置使用以下设置，Kibana 将无法启动

  • savedObjects.indexCheckTimeout
  • server.xsrf.token
  • elasticsearch.preserveHost
  • elasticsearch.startupTimeout

有关更多信息，请参阅 #113173。

影响
在升级到 8.0.0 之前，从 kibana.yml 中删除这些设置。

[通用设置] 添加了对内联脚本的要求。(8.0)

详细信息
要启动 Kibana，必须在 Elasticsearch 中启用内联脚本。有关更多信息，请参阅 #113068。

影响
启用内联脚本。

[通用设置] 移除 kibana.index 设置。(8.0)

详细信息
已移除 kibana.index、xpack.reporting.index 和 xpack.task_manager.index 设置。有关更多信息，请参阅 #112773。

影响
使用空间、跨集群复制或跨集群搜索。要迁移到空间，请将您的已保存对象从租户导出到默认空间。有关更多详细信息，请参阅 #82020。

[通用设置] 移除旧的日志记录。(8.0)

详细信息
日志记录配置和日志输出格式已更改。有关更多信息，请参阅 #112305。

影响
使用新的日志系统配置。

[通用设置] 移除 kibana.defaultAppId 设置。(8.0)

详细信息
已移除 kibana.yml 中已弃用的 kibana.defaultAppId 设置，该设置也可用作 kibana_legacy.defaultAppId。有关更多信息，请参阅 #109798。

影响
升级时，请从 kibana.yml 文件中删除 kibana.defaultAppId。要配置用户进入空间时的默认路由，请使用高级设置中的 defaultRoute。

[通用设置] 移除 courier:batchSearches 设置。(8.0)

详细信息
已移除高级设置中已弃用的 courier:batchSearches 设置。有关更多信息，请参阅 #109350。

影响
升级后，将不再提供 courier:batchSearches 设置。

[通用设置] 新的会话超时默认值。(8.0)

详细信息
会话超时 xpack.security.session.{lifespan|idleTimeout} 设置的默认值已更改。有关更多信息，请参阅 #106061。

影响
新的默认值如下

  • xpack.security.session.idleTimeout：3 天
  • xpack.security.session.lifespan：30 天
[通用设置] 移除将 server.host 设置为 0 的支持。(8.0)

详细信息
已移除使用 0 作为 server.host 配置 Kibana 的支持。请改用 0.0.0.0。有关更多信息，请参阅 #87114。

影响
您现在无法使用 0 作为 server.host。

[通用设置] 移除 xpack.security.public 和 xpack.security.authProviders 设置。(8.0)

详细信息
已移除 xpack.security.public 和 xpack.security.authProviders 设置。有关更多信息，请参阅 #38657。

影响
使用 xpack.security.authc.saml.realm 和 xpack.security.authc.providers 设置。

[通用设置] 移除 logging.useUTC 设置。(8.0)

详细信息
已移除 logging.useUTC 设置。有关更多信息，请参阅 #22696。

影响
默认时区为 UTC。要更改时区，请在 kibana.yml 中设置 logging.timezone: false。当系统（如 docker 容器）配置为非本地时区时，更改时区。

[索引管理] 移除对基于时间的间隔索引模式的支持。(8.0)

详细信息
基于时间的间隔索引模式在 5.x 中已弃用。在 6.x 中，您无法再创建基于时间的间隔索引模式，但它们继续按预期运行。在 8.0 中已移除对这些索引模式的支持。有关更多信息，请参阅 #35173。

影响
您必须将基于时间的索引模式迁移到通配符模式。例如，logstash-*。

[日志] 移除已弃用的别名配置条目。(8.0)

详细信息
已移除已弃用的 xpack.infra.sources.default.logAlias 和 xpack.infra.sources.default.logAlias 设置。有关更多信息，请参阅 #115974。

影响
升级之前，请先从 kibana.yml 中移除相关设置，然后在日志中配置这些设置。

[日志] 移除了设置中的可配置字段。(8.0)

详细信息
已移除 日志 和 指标 的可配置字段设置。有关更多信息，请参阅#61302。

影响
在 ECS 中配置这些设置。

[机器学习] 从机器学习中移除了 APM 作业。(8.0)

详细信息
已移除 APM Node.js 和 RUM JavaScript 异常检测作业模块。有关更多信息，请参阅 #119945。

影响
当您升级到 8.0.0 时，您将无法在机器学习中创建和查看 APM Node.js 和 RUM JavaScript 作业。

[机器学习] 当使用基本权限时，授予对机器学习功能的访问权限。(8.0)

详细信息
机器学习功能包含在基本权限中。有关更多信息，请参阅 #115444。

影响
如果您不想授予用户对机器学习功能的权限，请更新 用户 和 角色。

[Osquery] “全部”基本权限选项现在也适用于 Osquery。(8.3)

详细信息
Osquery Kibana 权限已更新，因此当所有功能的权限级别设置为全部时，现在也适用于 Osquery 权限的全部。之前，用户必须选择自定义选项才能授予对 Osquery 的任何访问权限。有关更多信息，请参阅#130523。

影响
这将影响将所有功能的权限设置为全部的用户角色。此更新之后，具有此角色的用户将可以访问 Kibana 中的 Osquery 页面。但是，要完全使用 Osquery 功能，这些要求保持不变：用户还需要对 logs-osquery_manager.result* 索引具有读取访问权限，并且必须将 Osquery Manager 集成部署到 Elastic Agent。

[已保存对象] 针对具有未知类型的已保存对象，迁移失败。(8.0)

详细信息
未知的已保存对象类型现在会导致 Kibana 迁移失败。有关更多信息，请参阅#107678。

影响
要完成迁移，请重新启用插件或从先前版本的索引中删除文档。

[已保存对象] 移除了对旧版导出的支持。(8.0)

详细信息
在 Kibana 8.0.0 及更高版本中，不支持来自 Kibana 6.x 的旧格式。有关更多信息，请参阅 #110738

影响
使用用户界面导入已保存的对象仅限于 .ndjson 格式的导入。

[安全] 移除了旧版审计日志记录器。(8.0)

详细信息
已移除旧版审计日志记录器。有关更多信息，请参阅#116191。

影响
审计日志将以新的 ECS 格式写入默认位置。要更改输出文件、过滤事件等，请使用审计日志设置。

[安全] 移除了 /api/security/v1/saml 路由。(8.0)

详细信息
已移除 /api/security/v1/saml 路由，并在 kibana.yml server.xsrf.whitelist 设置、Elasticsearch 和身份提供程序 SAML 设置中反映出来。有关更多信息，请参阅 #47929

影响
请使用 /api/security/saml/callback 路由，或等待升级到 8.0.0-alpha2，届时将恢复 /api/security/saml/callback 路由的重大更改。

[安全] 默认情况下拒绝旧版浏览器。(8.0)

详细信息
为了为大多数安装提供最大程度的保护，现在默认启用 csp.strict 配置。Kibana 不支持的旧版浏览器（例如 Internet Explorer 11）无法访问 Kibana，除非明确启用。Kibana 正式支持的所有浏览器都没有此问题。有关更多信息，请参阅 #41700

影响
要启用对旧版浏览器的支持，请在 kibana.yml 中设置 csp.strict: false。为了有效强制执行安全协议，我们强烈建议不要禁用 csp.strict，除非您必须支持 Internet Explorer 11。

[设置] 从存档根目录中移除了平台。(8.0)

详细信息
解压存档后，输出目录不再包含目标平台。例如，kibana-8.0.0-linux-aarch64.tar.gz 生成一个 kibana-8.0.0 文件夹。有关更多信息，请参阅#93835。

影响
要使用新文件夹，请更新配置管理工具和自动化。

[设置] 移除了对 TLS v1.0 和 v1.1 的默认支持。(8.0)

详细信息
已移除对 TLS v1.0 和 v1.1 的默认支持。有关更多信息，请参阅#90511。

影响
要启用支持，请在 node.options 配置文件中设置 --tls-min-1.0。要找到配置文件，请转到 kibana/config 文件夹或任何其他具有 KBN_PATH_CONF 环境变量的配置。例如，如果您使用的是基于 Debian 的系统，则配置文件位于 /etc/kibana 中。

[设置] 移除了对 sysv init 的支持。(8.0)

详细信息
所有受支持的操作系统都使用 systemd 服务文件。任何未将 service 别名为使用 kibana.service 的系统都应使用 systemctl start kibana.service 而不是 service start kibana。有关更多信息，请参阅#74424。

影响
如果您的安装使用带有 SysV 的 .deb 或 .rpm 包，请迁移到 systemd。

[设置] 默认情况下禁用响应日志记录。(8.0)

详细信息
在以前的版本中，当 logging.json:true 时，所有事件都记录在 json 中。使用新的日志记录配置，您可以选择具有布局的 json 和模式输出格式。有关更多信息，请参阅 #42353。

影响
要恢复先前的行为，请使用 kibana.yml 中的 appender.layout property 为每个自定义附加器配置日志格式。自定义附加器没有默认设置，必须显式配置每个附加器。

[共享和报告] 下载 CSV 端点已更改。(8.10)

详细信息
从仪表板应用程序中的已保存搜索下载 CSV 文件的 API 端点已更改，以反映这是一个内部 API。之前的 API 路径 /api/reporting/v1/generate/immediate/csv_searchsource 已更改为 /internal/reporting/generate/immediate/csv_searchsource。有关更多信息，请参阅#162288。

[共享和报告] CSV 报告现在使用 PIT 而不是 Scroll。(8.6)

详细信息
CSV 报告现在使用 PIT 而不是 Scroll。之前生成的 CSV 报告使用仅具有别名权限的索引别名，但对别名引用的索引没有权限，将不再生成。有关更多信息，请参阅#158338。

影响
要生成 CSV 报告，请授予对底层索引的 read 权限。

[共享和报告] 移除了旧版 CSV 导出类型。(8.1)

详细信息
已移除 /api/reporting/generate/csv 端点。有关更多信息，请参阅#121435。

影响
如果您使用的是 7.13.0 及更早版本，请重新生成您用于自动生成 CSV 报告的 POST URL。

[共享和报告] 移除了旧版 PDF 填充码。(8.1)

详细信息
您在 Kibana 6.2.0 中生成的 POST URL 不再起作用。有关更多信息，请参阅#121369。

影响
重新生成您用于自动生成 PDF 报告的 POST URL。

[共享和报告] 移除了报告设置。(8.0)

详细信息
已移除以下设置

  • xpack.reporting.capture.concurrency
  • xpack.reporting.capture.settleTime
  • xpack.reporting.capture.timeout
  • xpack.reporting.kibanaApp

有关更多信息，请参阅#114216。

影响
在升级到 8.0.0 之前，请从 kibana.yml 中移除这些设置。

[共享和报告] 不再支持旧版作业参数。(8.0)

详细信息
报告与使用 Kibana 6.2.0 及更早版本生成的 POST URL 代码段不再兼容。有关更多信息，请参阅 #52539

影响
如果您使用 POST URL 代码段自动生成 PDF 报告，请重新生成 POST URL 字符串。

[用户管理] 移除了在生产环境中使用 elasticsearch.username: elastic 的功能。(8.0)

详细信息
在生产环境中，您不再能够使用 elastic 超级用户来验证 Elasticsearch。有关更多信息，请参阅#122722。

影响
当您配置 elasticsearch.username: elastic 时，Kibana 将失败。

[可视化] 从 Lens 中移除了字段列表采样设置。(8.7)

详细信息
lens:useFieldExistenceSampling 已从高级设置中移除。此设置允许您启用文档采样来确定 Lens 中显示的字段。有关更多信息，请参阅#149482。

影响
在 8.1.0 及更高版本中，Kibana 默认使用 field caps API 来确定 Lens 中显示的字段。

[可视化] 移除了旧版饼图可视化设置。(8.7)

详细信息
visualization:visualize:legacyPieChartsLibrary 已从高级设置中移除。此设置允许您使用旧版图表库创建基于聚合的饼图可视化。有关更多信息，请参阅 #146990。

影响
在 7.14.0 及更高版本中，默认情况下可以使用新的基于聚合的饼图可视化。有关更多信息，请查看基于聚合的。

[可视化] 更改了 histogram:maxBars 默认设置。(8.6)

详细信息
为了在不更改高级设置的情况下配置更高分辨率的数据直方图聚合，默认的 histogram:maxBars 设置现在为 1000 而不是 100。有关更多信息，请参阅#143081。

影响
对于每个 空间，请完成以下操作以将 histogram:maxBars 更改为先前的默认设置

  1. 打开主菜单，然后单击堆栈管理 > 高级设置。
  2. 滚动或搜索 histogram:maxBars。
  3. 输入 100，然后单击保存更改。
[可视化] 移除了旧版 Timelion 图表库。(8.4)

详细信息
已移除 Timelion 可视化图表库的旧版实现。所有 Timelion 可视化现在都使用在 7.15.0 中引入的 elastic-charts 库。

有关更多信息，请参阅 #134336。

影响
在 8.4.0 及更高版本中，您无法配置 Timelion 旧版图表库的高级设置。有关可视化高级设置的信息，请查看可视化。

[可视化] 删除了 Quandl 和 Graphite 集成。(8.3)

详细信息
实验性的 .quandl 和 .graphite 函数以及高级设置已从 Timelion 中删除。有关更多信息，请查看 #129581。

影响
当您使用 vis_type_timelion.graphiteUrls kibana.yml 设置时，Kibana 会成功启动，但会记录 [WARN ][config.deprecation] You no longer need to configure "vis_type_timelion.graphiteUrls". 警告。

要留下您对删除 .quandl 和 .graphite 的反馈，请访问讨论论坛。

[可视化] 从旧版仪表盘可视化中删除了显示选项。(8.0)

详细信息
已从基于聚合的仪表盘可视化中删除 显示警告 选项。有关更多信息，请参阅 #113516。

影响
当您创建基于聚合的仪表盘可视化时，显示警告 选项不再在 选项 > 标签 中可用。

[可视化] 从 visEditors 插件中删除了设置。(8.0)

详细信息
已删除以下已弃用的 visEditors 插件设置

  • metric_vis.enabled
  • table_vis.enabled
  • tagcloud.enabled
  • metrics.enabled
  • metrics.chartResolution
  • chartResolution
  • metrics.minimumBucketSize
  • minimumBucketSize
  • vega.enabled
  • vega.enableExternalUrls
  • vis_type_table.legacyVisEnabled
  • timelion_vis.enabled
  • timelion.enabled
  • timelion.graphiteUrls
  • timelion.ui.enabled

有关更多信息，请参阅 #112643。

影响
在升级之前，请在 kibana.yml 中进行以下更改

  • 将 metric_vis.enabled 替换为 vis_type_metric.enabled
  • 将 table_vis.enabled 替换为 vis_type_table.enabled
  • 将 tagcloud.enabled 替换为 vis_type_tagcloud.enabled
  • 将 metrics.enabled 替换为 vis_type_timeseries.enabled
  • 将 metrics.chartResolution 和 chartResolution 替换为 vis_type_timeseries.chartResolution
  • 将 metrics.minimumBucketSize 和 minimumBucketSize 替换为 vis_type_timeseries.minimumBucketSize
  • 将 vega.enabled 替换为 vis_type_vega.enabled
  • 将 vega.enableExternalUrls 替换为 vis_type_vega.enableExternalUrls
  • 删除 vis_type_table.legacyVisEnabled
  • 将 timelion_vis.enabled 替换为 vis_type_timelion.enabled
  • 将 timelion.enabled 替换为 vis_type_timelion.enabled
  • 将 timelion.graphiteUrls 替换为 vis_type_timelion.graphiteUrls
  • 删除 timelion.ui.enabled
[可视化] 删除了变暗不透明度设置。(8.0)

详细信息
已删除 高级设置 中的 变暗不透明度 设置。有关更多信息，请参阅 #111704。

影响
当您升级到 8.0.0 时，您将无法再配置可视化的变暗不透明度。

[可视化] 删除了 TSVB 中的 Less 样式表支持。(8.0)

详细信息
在 TSVB 中，已删除自定义 Less 样式表。有关更多信息，请参阅 #110985。

影响
现有的 less 样式表会自动转换为 CSS 样式表。

[可视化] 禁用了 TSVB 中的输入字符串模式。(8.0)

详细信息
在 TSVB 中，已删除 索引模式选择模式 选项。有关更多信息，请参阅 #110571。

影响
要在 TSVB 可视化中使用索引模式和 Elasticsearch 索引

  1. 打开主菜单，然后单击堆栈管理 > 高级设置。
  2. 选择 允许 TSVB 中的字符串索引。
  3. 单击 保存更改。
[可视化] 删除了 proxyElasticMapsServiceInMaps 地图设置。(8.0)

详细信息
已删除 map.proxyElasticMapsServiceInMaps 设置。有关更多信息，请参阅 #116184。

影响
在内部网络上可访问的位置安装 Elastic 地图服务的本地版本，它是一个位于 Elastic Docker 注册表中的 Docker 服务。完成安装后，更新 kibana.yml 以指向该服务。

[可视化] 删除了 map.regionmap.*。(8.0)

详细信息
已删除 kibana.yml 中已弃用的 map.regionmap.* 设置。有关更多信息，请参阅 #109896。

影响
如果您的地图使用 map.regionmap 图层

  1. 删除 map.regionmap 图层。
  2. 要重新创建等值线图层，请使用 GeoJSON 上传将您的静态矢量数据索引到 Elasticsearch 中。
  3. 从索引的矢量数据创建等值线图层。
[可视化] 删除了仅仪表盘模式。(8.0)

详细信息
已删除旧版仅仪表盘模式。有关更多信息，请参阅 #108103。

影响
要授予用户仅访问仪表盘的权限，请创建一个新角色，然后仅分配 仪表盘 功能权限。有关更多信息，请参阅 Kibana 权限。

[可视化] 删除了 xpack.maps.showMapVisualizationTypes 设置。(8.0)

详细信息
已删除 kibana.yml 中已弃用的 xpack.maps.showMapVisualizationTypes 设置。有关更多信息，请参阅 #105979

影响
升级时，请从 kibana.yml 文件中删除 xpack.maps.showMapVisualizationTypes。

Elastic 可观测性解决方案

编辑
[APM] 删除了 apm_user。(8.3)

详细信息
删除了 apm_user 角色。有关更多信息，请查看 #132790。

影响
apm_user 角色已替换为 viewer 和 editor 内置角色。

[SLO] 新的 SLO 架构。(8.12)

详细信息
我们在 SLO 功能中引入了一个重大更改，该更改将破坏 8.12 之前创建的任何 SLO。这些 SLO 必须通过 API 手动重置，直到我们为其提供 UI 为止。随时间聚合的数据（汇总）仍可在 SLI v2 索引中使用，但在重置时不会用于摘要计算。

以前用于汇总每个 SLO 的摘要转换将不再使用，可以停止并删除

  • slo-summary-occurrences-7d-rolling
  • slo-summary-occurrences-30d-rolling
  • slo-summary-occurrences-90d-rolling
  • slo-summary-occurrences-monthly-aligned
  • slo-summary-occurrences-weekly-aligned
  • slo-summary-timeslices-7d-rolling
  • slo-summary-timeslices-30d-rolling
  • slo-summary-timeslices-90d-rolling
  • slo-summary-timeslices-monthly-aligned
  • slo-summary-timeslices-weekly-aligned

请注意，当安装新的 SLO（或在重置 SLO 后）时，我们会安装两个转换（一个用于汇总数据，另一个用于汇总汇总数据）。请勿删除新的 slo-summary-{slo_id}-{slo_revision} 转换。有关更多信息，请参阅 (#172224)。

[SLO] 引入了新的摘要搜索功能，这将导致 8.10 之前创建的 SLO 停止工作。(8.10)

详细信息

  • SLO 查找 API 正文参数已更改。
  • 汇总数据使用的索引映射已更改，并且我们添加了一个摘要索引，该索引将成为搜索的新事实来源。
  • 汇总转换已更新，但现有的 SLO 及其转换不会更新。

如果在 8.10 的先前版本中安装了一些 SLO，则在迁移到 8.10 后它们将无法工作。有两种方法可以处理此重大更改。建议的方法是在迁移到 8.10 之前删除所有 SLO。另一种方法是迁移到 8.10 并手动删除 SLO。

在迁移到 8.10 之前删除 SLO

使用 SLO UI 或 SLO 删除 API 删除所有现有的 SLO。这将处理保存的对象、转换和汇总数据。删除所有 SLO 后，删除剩余的汇总索引：.slo-observability.sli-v1*。请注意，这是 v1。

在迁移到 8.10 之后删除 SLO

在迁移到 8.10 之后，先前创建的 SLO 将不会显示在 UI 中，因为 API 正在使用新的索引。先前创建的 SLO 仍然存在，并且关联的转换仍在将数据汇总到先前的索引 .slo-observability.sli-v1* 中。现在无法使用 SLO 删除 API，因此请手动删除资源资源

  1. 查找所有现有的转换。所有与 SLO 相关的转换都以 slo- 前缀开头，此请求会返回所有这些转换

    GET _transform/slo-*

    记下所有转换 ID 以供稍后使用。

  2. 停止所有转换

    POST _transform/slo-*/_stop?force=true

  3. 删除所有转换

    从第一步返回的转换列表中，现在逐个删除它们

    DELETE _transform/{transform_id}?force=true

  4. 查找 SLO 保存的对象

    此请求列出所有 SLO 保存的对象。SLO ID 和保存的对象 ID 不同。

    GET kbn:/api/saved_objects/_find?type=slo

    记下响应中的所有保存的对象 ID。

  5. 删除 SLO 保存的对象

    对于每个保存的对象 ID，运行以下操作

    DELETE kbn:/api/saved_objects/slo/{Saved_Object_Id}

  6. 删除汇总索引 v1

    请注意，这是 v1。

    DELETE .slo-observability.sli-v1*
[Uptime] 当没有数据可用时，现在会隐藏 Uptime 应用程序。(8.9)

详细信息
当 Uptime 应用程序超过一周没有任何数据时，现在会从界面中隐藏。如果您有一个将数据推送到 Elasticsearch 的独立 Heartbeat，则 Uptime 应用程序被视为处于活动状态。您可以使用 Kibana 高级设置中的 始终显示旧版 Uptime 应用程序 选项禁用此自动行为。对于合成监控，我们现在建议使用新的 Synthetics 应用程序。有关更多信息，请参阅 #159118

[Uptime] 从 Uptime 设置中删除合成模式。(8.9)

详细信息
从 Synthetics 应用程序内或通过 Elastic Synthetics Fleet 集成创建的浏览器监视器和所有类型的监视器的数据将不再显示在 Uptime 中。有关更多信息，请参阅 #159012

Elastic Search 解决方案

编辑
必需的安全插件。(8.0)

详细信息
Enterprise Search 现在要求您启用 X-Pack 安全。有关更多信息，请参阅 #106307

影响
启用 X-Pack 安全。

Elastic 安全解决方案

编辑

有关完整的 Elastic 安全解决方案发布信息，请参阅 Elastic 安全解决方案发布说明。

[Elastic Defend] 将 filterQuery 转换为 KQL。(8.11)

详细信息
将 filterQuery 转换为 KQL 查询字符串。有关更多信息，请参阅 (#161806)。

弃用通知

编辑

以下功能已弃用，并将在未来日期删除。已弃用的功能不会对您的应用程序产生直接影响，但我们强烈建议您进行必要的更新以避免使用已弃用的功能。

使用 Kibana 升级助手 为您升级到下一版本的 Elastic Stack 做准备。该助手会识别您配置中的已弃用设置，并指导您完成解决问题的过程（如果启用了任何已弃用的功能）。要访问该助手，请转到 Stack Management > 升级助手。

Kibana API

编辑
已弃用 Agent 重新分配 API PUT 端点。(8.8)

详细信息
用于 agent 重新分配 API 的 PUT 端点已弃用。有关更多信息，请参阅 #152236。

影响
请使用 agent 重新分配 API 的 POST 端点。

已弃用 /agent_status Fleet API 中的 total。(8.8)

详细信息
/agent_status Fleet API 响应中的 total 字段已弃用。有关更多信息，请参阅 #151564。

影响
/agent_status Fleet API 现在返回以下状态

  • all — 所有活动和非活动
  • active — 所有活动
更新 Fleet API 以提高一致性。(8.0)

详细信息
已更新 Fleet API 以提高一致性

  • 某些名称中的连字符已更改为下划线。
  • packages 端点中的 pkgkey 路径参数已拆分。
  • 在某些响应中，response 和 list 属性已重命名为 items 或 item。

有关更多信息，请参阅 #119494。

影响
升级到 8.0.0 时，请使用以下 API 更改

  • 使用 enrollment_api_keys 而不是 enrollment-api-keys。
  • 使用 agent_status 而不是 agent-status。
  • 使用 service_tokens 而不是 service-tokens。
  • 使用 /epm/packages/{packageName}/{version} 而不是 /epm/packages/{pkgkey}。

  • 在以下情况下使用 items[] 而不是 response[]

    /api/fleet/enrollment_api_keys
/api/fleet/agents
/epm/packages/
/epm/categories
/epm/packages/_bulk
/epm/packages/limited
/epm/packages/{packageName}/{version}

    当动词为 POST 或 DELETE 时，使用 items[]。当动词为 GET 或 PUT 时，使用 item。

有关更多信息，请参阅 Fleet API。

Kibana 平台

编辑
[警报] UI 和测试中不再使用的操作变量已被替换。(8.10)

详细信息
以下规则操作变量已弃用。请改用推荐的变量（在括号中）

  • alertActionGroup (alert.actionGroup)
  • alertActionGroupName (alert.actionGroupName)
  • alertActionSubgroup (alert.actionSubgroup)
  • alertId (rule.id)
  • alertInstanceId (alert.id)
  • alertName (rule.name)
  • params (rule.params)
  • spaceId (rule.spaceId)
  • tags (rule.tags)

有关更多信息，请参阅 (#161136)。

[Discover] 搜索会话 在 8.15.0 中已弃用，并将在未来版本中删除。(8.15)

详细信息
搜索会话现已弃用，并将在未来版本中删除。默认情况下，运行时间超过 10 分钟的查询（高级设置 search:timeout 的默认值）将被取消。要允许查询运行更长时间，请考虑增加 search:timeout 或将其设置为 0，这将允许查询在用户等待屏幕上的结果时继续运行。

[常规设置] 已弃用临时任务管理器设置 (8.8)

详细信息
以下任务管理器设置已弃用

  • xpack.task_manager.ephemeral_tasks.enabled
  • xpack.task_manager.ephemeral_tasks.request_capacity
  • xpack.alerting.maxEphemeralActionsPerAlert

有关更多信息，请参阅 #154275。

影响
为了提高任务执行的弹性，请从 kibana.yml 文件中删除已弃用的设置。有关详细信息，请查看 Kibana 中的任务管理器设置。

[常规设置] 已弃用 xpack.data_enhanced.* 设置。(8.3)

详细信息
在 kibana.yml 中，xpack.data_enhanced.* 设置已弃用。有关更多信息，请查看 #122075。

影响
请改用 data.* 配置参数。

[常规设置] 已删除 xpack:defaultAdminEmail 设置。(8.0)

详细信息
用于监控的 xpack:default_admin_email 设置已删除。有关更多信息，请参阅 #33603

影响
请在 kibana.yml 中使用 xpack.monitoring.clusterAlertsEmail。

[安全] 已弃用交互用户的 ApiKey 身份验证。(8.4)

详细信息
通过 Web 浏览器使用 ApiKey 对交互用户进行身份验证的功能已弃用，并将在未来版本中删除。

有关更多信息，请参阅 #136422。

影响
要通过 Web 浏览器对交互用户进行身份验证，请使用其他身份验证方法。仅将 API 密钥用于对 Kibana 和 Elasticsearch 的编程访问。

[安全] 已弃用匿名身份验证凭据。(8.3)

详细信息
匿名身份验证提供程序的 apiKey（包括密钥和 ID/密钥对）和 elasticsearch_anonymous_user 凭据类型已弃用。有关更多信息，请查看 #131636。

影响
如果您已配置使用 apiKey 或 elasticsearch_anonymous_user 凭据类型的匿名身份验证提供程序，则即使未启用该提供程序，也会出现弃用警告。

[安全] 已弃用 v1 和 v2 security_linux 和 security_windows 作业。(8.3)

详细信息
security_linux 和 security_windows 的 v1 和 v2 作业配置已弃用。有关更多信息，请查看 #131166。

影响
以下 security_linux 和 security_windows 作业配置已更新为 v3

  • security_linux

    • v3_linux_anomalous_network_activity
    • v3_linux_anomalous_network_port_activity_ecs
    • v3_linux_anomalous_process_all_hosts_ecs
    • v3_linux_anomalous_user_name_ecs
    • v3_linux_network_configuration_discovery
    • v3_linux_network_connection_discovery
    • v3_linux_rare_metadata_process
    • v3_linux_rare_metadata_user
    • v3_linux_rare_sudo_user
    • v3_linux_rare_user_compiler
    • v3_linux_system_information_discovery
    • v3_linux_system_process_discovery
    • v3_linux_system_user_discovery
    • v3_rare_process_by_host_linux_ecs

  • security_windows

    • v3_rare_process_by_host_windows_ecs
    • v3_windows_anomalous_network_activity_ecs
    • v3_windows_anomalous_path_activity_ecs
    • v3_windows_anomalous_process_all_hosts_ecs
    • v3_windows_anomalous_process_creation
    • v3_windows_anomalous_script
    • v3_windows_anomalous_service
    • v3_windows_anomalous_user_name_ecs
    • v3_windows_rare_metadata_process
    • v3_windows_rare_metadata_user
    • v3_windows_rare_user_runas_event
    • v3_windows_rare_user_type10_remote_login
[设置] macOS x86_64 的新版本 Kibana 将在 8.17 之后结束。

详细信息
macOS x86_64 的新版本 Kibana 构建已弃用，将在 8.17 之后不再发布。macOS AArch64 的 Kibana 不受影响。

请使用 Docker 在 macOS 86x_64 上运行新版本的 Kibana。

[共享和报告] 从仪表板中的保存搜索面板下载 CSV 文件已被弃用，取而代之的是生成 CSV 报告。(8.14)

详细信息
从仪表板中的保存搜索面板导出 CSV 数据的机制已更改为生成 CSV 报告，而不是允许在不创建报告的情况下下载 CSV 数据。要保留原始行为，需要使用 xpack.reporting.csv.enablePanelActionDownload: true 设置更新 kibana.yml。此重大更改的范围仅限于从保存的搜索面板下载 CSV 文件；从其他类型的仪表板面板下载 CSV 文件保持不变。有关更多信息，请参阅 #178159。

[可视化] 已删除 metrics:allowCheckingForFailedShards 高级设置。(8.17)

详细信息
已删除 metrics:allowCheckingForFailedShards 高级设置。进行此更改后，无法再在 TSVB 中禁止显示有关失败分片的警告。有关更多信息，请参阅 (#197227)。

[可视化] 创建旧输入控件的功能已被隐藏。(8.9)

详细信息
创建新可视化时，创建旧输入控件的选项已隐藏。有关更多信息，请参阅 #156455

[可视化] 已删除旧字段统计信息。(8.9)

详细信息
先前在弹出窗口中显示的旧字段统计信息已删除。有关更多信息，请参阅 #155503

[可视化] 已弃用仪表板中的输入控制面板。(8.3)

详细信息
允许您向仪表板添加交互式筛选器的输入控制面板已弃用。有关更多信息，请查看 #132562。

影响
要将交互式筛选器添加到您的仪表板，请使用新控件。

[可视化] 已弃用 Lens 中的 自动 默认图例大小。(8.3)

详细信息
在 Lens 可视化编辑器中，图例宽度 的 自动 默认值已弃用。有关更多信息，请查看 #130336。

影响
当您创建 Lens 可视化时，图例宽度 的默认值现在是 中等。

Elastic 可观测性解决方案

编辑
可观测性 > 日志 > 资源管理器应用程序现已弃用，取而代之的是 Discover。(8.17)

详细信息
日志资源管理器和日志流应用程序现已弃用，并将在 9.0 中删除。我们将继续增强 Discover，以便在 9.x 中提供类似的功能。

已弃用 Observability AI 助手特定的高级设置 observability:aiAssistantLogsIndexPattern。(8.16)

详细信息
用于日志索引模式的 Observability AI 助手特定高级设置 observability:aiAssistantLogsIndexPattern 已弃用，不再使用。AI 助手现在将改用现有的 日志源 设置 observability:logSources。有关更多信息，请参阅 (#192003)。

日志流默认情况下已隐藏，取而代之的是日志资源管理器应用程序。(8.16)

详细信息
您可以在导航菜单中的日志 > 资源管理器下或在 Discover 中以单独的选项卡形式找到日志资源管理器应用程序。有关更多信息，请参阅 (#194519)。

影响
您仍然可以通过导航到 Stack Management > 高级设置并启用 observability:enableLogsStream 设置来再次显示日志流应用程序。

[APM] 重命名了 autocreate 数据视图 APM 设置。(8.0)

详细信息
已删除 xpack.apm.autocreateApmIndexPattern APM 设置。有关更多信息，请参阅 #120689。

影响
要在 APM 中自动创建数据视图，请使用 xpack.apm.autoCreateApmDataView。

[正常运行时间] 正常运行时间在 8.15.0 中已弃用。(8.15)

详细信息
当没有最近的 Heartbeat 数据时，正常运行时间应用程序已从 Kibana 中隐藏。迁移到 Synthetics 作为替代方案。有关更多详细信息，请参阅 正常运行时间文档。

[正常运行时间] 已弃用 Synthetics 和正常运行时间监视器计划 (8.8)

详细信息
Synthetics 和正常运行时间监视器计划以及 zip URL 字段已弃用。有关更多信息，请参阅 #154010 和 #154952。

影响
当您在正常运行时间监视器管理和 Synthetics 应用程序中创建监视器时，不受支持的计划会自动转移到最近受支持的计划。要使用 zip URL，请使用项目监视器。

[正常运行时间] 已弃用的 Elastic Synthetics 集成。(8.8)

详细信息
Elastic Synthetics 集成已弃用。有关更多信息，请参阅 #149506。

影响
要监控端点、页面和用户旅程，请转到 可观测性 → Synthetics（测试版）。

Elastic Security 解决方案

编辑

有关完整的 Elastic 安全解决方案发布信息，请参阅 Elastic 安全解决方案发布说明。

« 发行说明 Kibana 8.17.0 »