升级 Elastic Agent 集成
编辑升级 Elastic Agent 集成编辑
默认情况下,Kibana 需要互联网连接才能从 Elastic Package Registry 下载集成包。请确保 Kibana 服务器可以通过端口 443
连接到 https://epr.elastic.co
。如果网络限制导致 Kibana 无法访问公共 Elastic Package Registry,您可以使用代理服务器或托管您自己的 Elastic Package Registry。要了解更多信息,请参阅无互联网环境。
Elastic 会定期发布 Elastic Agent 集成更新。要使用新功能,请将已安装的集成升级到最新版本,并可选择升级集成策略以使用新版本。
在较大的部署中,您应该先在示例 Elastic Agent 上测试集成升级,然后再进行更大规模的升级。
将集成升级到最新版本编辑
- 在 Kibana 中,转到集成页面,然后打开已安装的集成选项卡。搜索并选择要升级的集成。请注意,版本号旁边有一个警告图标,表示有新版本可用。
-
单击设置选项卡,并注意有关新版本的消息。
-
在升级集成之前,请决定是否也要将集成策略升级到最新版本。要使用新功能,您需要升级现有的集成策略。但是,升级可能会引入更改(例如字段更改),需要您解决冲突。
- 选择升级集成策略以在升级集成时升级任何符合条件的集成策略。
- 要继续使用旧的软件包版本,请取消选择升级集成策略。您仍然可以选择稍后手动升级集成策略。
-
单击升级到最新版本。
如果您选择了升级集成策略并且存在冲突,请手动升级集成策略并在策略编辑器中解决冲突。
- 升级完成后,请验证已安装版本和最新版本是否匹配。
您必须单独升级独立代理。如果您使用 Kibana 创建和下载了独立代理策略,请参阅升级集成后升级独立代理策略。
自动使集成策略保持最新状态编辑
某些集成包(例如系统)在 Fleet 设置期间默认安装。当 Fleet 检测到有新版本可用时,这些集成会自动升级。这些集成还提供了一个选项,可以自动升级集成策略。选中此选项(默认)后,当有新版本的集成可用时,Fleet 会在后台自动升级您的策略。如果在升级过程中发生冲突,则不会升级您的集成策略,您需要手动升级集成策略。
要使集成策略自动保持最新状态,请执行以下操作
- 在 Kibana 中,转到集成页面,然后打开已安装的集成选项卡。搜索并选择要配置的集成。
-
单击设置,并确保已选中自动使集成策略保持最新状态。
如果设置选项卡上没有此选项,则表示您正在查看的集成不支持此功能。
手动升级集成策略编辑
如果您在升级集成时无法升级集成策略,请手动升级它们。
-
单击策略选项卡,然后找到要升级的集成策略。
-
单击升级以开始升级过程。
升级将在策略编辑器中打开。
- 进行任何必要的配置更改,并在必要时解决冲突。有关更多信息,请参阅解决冲突。
- 对每个具有过时集成的策略重复此过程。
冲突太多无法解决?有关手动步骤,请参阅故障排除文档。
解决冲突编辑
尝试升级集成策略时,集成版本之间可能存在重大更改或冲突。例如,如果新版本的集成具有必填字段并且未指定默认值,则 Fleet 无法在没有用户输入的情况下执行升级。如果实验性软件包在版本之间对其字段和配置设置进行了重大重组,也可能会发生冲突。
如果 Fleet 在自动升级集成策略时检测到冲突,则不会尝试升级它。您需要
- 手动升级集成策略.
-
使用策略编辑器修复任何冲突或错误。
-
在查看字段冲突下,请注意,您可以单击以前的配置以查看旧集成策略的原始 JSON 表示形式并比较值。当字段在版本之间已弃用或删除时,此功能非常有用。
- 在策略编辑器中,修复所有错误,然后单击升级集成。
-