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