加载中

升级 Elastic Agent 集成

重要事项

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

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

提示

在大型部署中，您应该在推出大规模升级计划之前，先在示例 Elastic Agent 上测试集成升级。

  1. 在 Kibana 中，转到 Integrations 页面，打开 Installed integrations 选项卡。搜索并选择要升级的集成。请注意，版本号旁边有一个警告图标，表示有新版本可用。

  2. 单击 Settings 选项卡，并注意关于新版本的消息。

    Settings tab under Integrations shows how to upgrade the integration

  3. 在升级集成之前，决定是否同时将集成策略升级到最新版本。要使用新功能和新特性，您需要升级现有的集成策略。但是，升级可能会引入更改，例如字段更改，这需要您解决冲突。

    • 选择 Upgrade integration policies，以便在集成升级时升级所有符合条件的集成策略。
    • 要继续使用旧的软件包版本，请取消选择 Upgrade integration policies。您仍然可以稍后选择手动升级集成策略。

  4. 单击 Upgrade to latest version。

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

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

注意

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

某些集成包，例如 System，在 Fleet 设置期间会默认安装。当 Fleet 检测到新版本可用时，这些集成会自动升级。

当您在 Fleet UI 中选择某些选项时，以下集成会自动安装。所有这些集成也都有一个选项可以自动升级集成策略

  • Elastic Agent - 在 Elastic Agent 策略中启用默认的 Collect agent logs 或 Collect agent metrics 选项时自动安装）。
  • Fleet Server - 通过 Fleet UI 设置 Fleet Server 时自动安装。
  • System - 在 Elastic Agent 策略中启用默认的 Collect system logs and metrics 选项时自动安装）。

Elastic Defend 集成也有一个选项可以自动升级安装策略。

请注意，对于以下集成，当集成自动更新时，集成策略也会自动升级。此行为无法禁用。

对于支持自动升级集成策略选项的集成，当选择此选项（默认）时，当有新版本的集成可用时，Fleet 会自动升级您的策略。如果在升级过程中存在冲突，您的集成策略将不会升级，您需要手动升级集成策略。

自动保持集成策略最新

  1. 在 Kibana 中，转到 Integrations 页面，打开 Installed integrations 选项卡。搜索并选择要配置的集成。

  2. 单击 Settings 并确保已选择 Keep integration policies up to data automatically。

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

    如果在此 Settings 选项卡上没有此选项，则您正在查看的集成不支持此功能。

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

  1. 单击 Policies 选项卡，找到要升级的集成策略。

    Policies tab under Integrations shows how to upgrade the package policy

  2. 单击 Upgrade 开始升级过程。

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

    Upgrade integration example in the policy editor

  3. 进行任何必要的配置更改，并在必要时解决冲突。有关详细信息，请参阅解决冲突。

  4. 对每个集成过期的策略重复此过程。

冲突太多无法解决？请参阅故障排除文档中的手动步骤。

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

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

  1. 手动升级集成策略.

  2. 使用策略编辑器修复任何冲突或错误。

    Resolve field conflicts in the policy editor

    1. 在 Review field conflicts 下，请注意您可以单击 previous configuration 查看旧集成策略的原始 JSON 表示，并比较值。当字段在版本之间被弃用或移除时，此功能非常有用。

      View previous configuration to resolve conflicts

    2. 在策略编辑器中，修复任何错误并单击 Upgrade integration。

© . All rights reserved.