升级 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 UI 中选择某些选项时会自动安装。它们都具有自动升级集成策略的选项
- Elastic Agent - 在 Elastic Agent 策略中启用默认的收集代理日志或收集代理指标选项时自动安装）。
- Fleet Server - 通过 Fleet UI 设置 Fleet Server 时自动安装。
- 系统 - 在 Elastic Agent 策略中启用默认的收集系统日志和指标选项时自动安装）。
Elastic Defend 集成也具有自动升级安装策略的选项。
请注意，对于以下集成，当集成自动更新时，集成策略也会自动升级。此行为无法禁用。
对于支持自动升级集成策略选项的集成，当选择此选项（默认值）时，Fleet 会在有新版本的集成可用时自动升级您的策略。如果升级过程中存在冲突，您的集成策略将不会升级，您需要手动升级集成策略。
要自动保持集成策略最新
- 在 Kibana 中，转到集成页面并打开已安装的集成选项卡。搜索并选择您要配置的集成。
-
单击设置并确保已选中自动保持集成策略最新。
如果设置选项卡上没有此选项，则表示您正在查看的集成不支持此功能。
手动升级集成策略
编辑如果您无法在升级集成时升级集成策略，请手动升级它们。
-
单击策略选项卡，找到您要升级的集成策略。
-
单击升级以开始升级过程。
升级将在策略编辑器中打开。
- 进行任何必要的配置更改，并在必要时解决冲突。有关更多信息，请参阅解决冲突。
- 对每个具有过时集成的策略重复此过程。
冲突过多无法解决？请参阅故障排除文档以获取手动步骤。
解决冲突
编辑尝试升级集成策略时，集成版本之间可能存在重大更改或冲突。例如，如果新版本的集成具有必填字段并且未指定默认值，则 Fleet 无法在没有用户输入的情况下执行升级。如果实验性软件包在版本之间对其字段和配置设置进行了重大重构，也可能发生冲突。
如果 Fleet 在自动升级集成策略时检测到冲突，它将不会尝试升级它。您需要
- 手动升级集成策略.
-
使用策略编辑器修复任何冲突或错误。
-
在查看字段冲突下，请注意，您可以单击先前配置以查看旧集成策略的原始 JSON 表示形式并比较值。此功能在字段在版本之间已弃用或删除时非常有用。
- 在策略编辑器中，修复任何错误并单击升级集成。
-