升级 Elastic Agent 集成编辑

默认情况下,Kibana 需要互联网连接才能从 Elastic Package Registry 下载集成包。请确保 Kibana 服务器可以通过端口 443 连接到 https://epr.elastic.co。如果网络限制导致 Kibana 无法访问公共 Elastic Package Registry,您可以使用代理服务器或托管您自己的 Elastic Package Registry。要了解更多信息,请参阅无互联网环境

Elastic 会定期发布 Elastic Agent 集成更新。要使用新功能,请将已安装的集成升级到最新版本,并可选择升级集成策略以使用新版本。

在较大的部署中,您应该先在示例 Elastic Agent 上测试集成升级,然后再进行更大规模的升级。

将集成升级到最新版本编辑

  1. 在 Kibana 中,转到集成页面,然后打开已安装的集成选项卡。搜索并选择要升级的集成。请注意,版本号旁边有一个警告图标,表示有新版本可用。
  2. 单击设置选项卡,并注意有关新版本的消息。

    Settings tab under Integrations shows how to upgrade the integration
  3. 在升级集成之前,请决定是否也要将集成策略升级到最新版本。要使用新功能,您需要升级现有的集成策略。但是,升级可能会引入更改(例如字段更改),需要您解决冲突。

    • 选择升级集成策略以在升级集成时升级任何符合条件的集成策略。
    • 要继续使用旧的软件包版本,请取消选择升级集成策略。您仍然可以选择稍后手动升级集成策略
  4. 单击升级到最新版本

    如果您选择了升级集成策略并且存在冲突,请手动升级集成策略并在策略编辑器中解决冲突。

  5. 升级完成后,请验证已安装版本和最新版本是否匹配。

您必须单独升级独立代理。如果您使用 Kibana 创建和下载了独立代理策略,请参阅升级集成后升级独立代理策略

自动使集成策略保持最新状态编辑

某些集成包(例如系统)在 Fleet 设置期间默认安装。当 Fleet 检测到有新版本可用时,这些集成会自动升级。这些集成还提供了一个选项,可以自动升级集成策略。选中此选项(默认)后,当有新版本的集成可用时,Fleet 会在后台自动升级您的策略。如果在升级过程中发生冲突,则不会升级您的集成策略,您需要手动升级集成策略

要使集成策略自动保持最新状态,请执行以下操作

  1. 在 Kibana 中,转到集成页面,然后打开已安装的集成选项卡。搜索并选择要配置的集成。
  2. 单击设置,并确保已选中自动使集成策略保持最新状态

    Settings tab under Integrations shows how to keep integration policies up to date automatically

    如果设置选项卡上没有此选项,则表示您正在查看的集成不支持此功能。

手动升级集成策略编辑

如果您在升级集成时无法升级集成策略,请手动升级它们。

  1. 单击策略选项卡,然后找到要升级的集成策略。

    Policies tab under Integrations shows how to upgrade the package policy
  2. 单击升级以开始升级过程。

    升级将在策略编辑器中打开。

    Upgrade integration example in the policy editor
  3. 进行任何必要的配置更改,并在必要时解决冲突。有关更多信息,请参阅解决冲突
  4. 对每个具有过时集成的策略重复此过程。

冲突太多无法解决?有关手动步骤,请参阅故障排除文档

解决冲突编辑

尝试升级集成策略时,集成版本之间可能存在重大更改或冲突。例如,如果新版本的集成具有必填字段并且未指定默认值,则 Fleet 无法在没有用户输入的情况下执行升级。如果实验性软件包在版本之间对其字段和配置设置进行了重大重组,也可能会发生冲突。

如果 Fleet 在自动升级集成策略时检测到冲突,则不会尝试升级它。您需要

  1. 手动升级集成策略.
  2. 使用策略编辑器修复任何冲突或错误。

    Resolve field conflicts in the policy editor
    1. 查看字段冲突下,请注意,您可以单击以前的配置以查看旧集成策略的原始 JSON 表示形式并比较值。当字段在版本之间已弃用或删除时,此功能非常有用。

      View previous configuration to resolve conflicts
    2. 在策略编辑器中,修复所有错误,然后单击升级集成