升级 Kibana

Elastic Stack 自我管理

升级 Kibana 时，您还需要升级 Observability 和 Elastic Security 解决方案，它们使用 Kibana 作为主要界面。

当升级多个连接到同一 Elasticsearch 集群的 Kibana 实例时，请确保在开始升级之前关闭所有过时的实例。

Kibana 不支持滚动升级。但是，当过时的实例关闭后，您可以同时启动所有已升级的实例，这样所有实例都可以并行参与升级。

对于拥有超过 10 个 Kibana 实例和超过 10,000 个已保存对象的较大型部署，您可以通过启动单个 Kibana 实例并等待其完成升级，然后再启动其余实例来减少升级停机时间。

在开始之前，请确保您已完成升级准备步骤。然后，采取以下额外步骤以确保您已准备好升级。

Elasticsearch 集群的问题可能会阻止 Kibana 升级成功。

在升级过程中，Kibana 会创建新的索引，并将更新后的文档写入其中。如果集群接近低水位标记，Kibana 将很可能无法创建这些索引。读取、转换和写入更新后的文档会消耗大量内存，比常规操作使用更多的可用堆。您必须确保有足够的堆内存可用，以防止请求超时或由于断路器异常而引发错误。您还应确保所有分片都已复制并分配。

一个健康的集群应具有

• 足够的可用磁盘空间，至少是 .kibana 和 .kibana_task_manager 索引所占存储空间的两倍。
• 足够的堆内存大小
• “绿色”的集群状态

当您升级不同的 Kibana 版本时，升级可能会失败。请确保所有 Kibana 实例运行的版本、配置和插件都相同。

升级 Kibana

1. 关闭所有 Kibana 实例。Kibana 不支持滚动升级。在较旧的 Kibana 实例运行时进行升级可能导致数据丢失或升级失败。

2. 安装 deb 或 rpm 包

   a. 使用 rpm 或 dpkg。这将把所有文件安装到正确的位置，并且不会覆盖配置文件。b. 通过删除现有插件并使用 kibana-plugin 脚本重新安装相应版本的插件来升级任何插件。有关更多信息，请参阅 Kibana 插件。

3. 从 zip 或 tar.gz 存档安装

   a. 将存档解压到一个新目录，以确保您不会覆盖 config 或 data 目录。b. 将旧安装中的 config 目录中的文件复制到新安装中。c. 将旧安装中的 data 目录中的文件复制到新安装中。

   重要提示

   如果您使用监控功能，则在升级 Kibana 时必须重新使用数据目录。否则，Kibana 实例将被分配一个新的永久 UUID，并在监控数据中成为一个新实例。

   d. 使用 kibana-plugin 脚本为新安装安装所有插件的相应版本。有关更多信息，请参阅 Kibana 插件。

4. 启动 Kibana。

成功升级 Kibana 后，升级 Elastic APM，然后升级您的摄取组件。