创建独立 Elastic Agent 策略

编辑

为了快速入门,可以使用 Kibana 将集成添加到代理策略中,然后下载该策略作为独立 Elastic Agent 策略的起点。这种方法可以节省时间,减少错误,并使用许多手动添加起来很繁琐的详细信息填充策略。此外,在 Kibana 中添加集成会在您启动 Elastic Agent 之前加载所需的资源,例如索引模板和摄取管道。

如果您是 Fleet 用户并且已经拥有想要以独立模式使用的代理策略,请转到 Fleet > 代理 并单击 添加代理。按照运行独立模式下的步骤下载策略文件。

您不需要 Fleet 即可执行以下步骤,但在自管理集群中,必须在 Elasticsearch 配置中启用 API 密钥(设置 xpack.security.authc.api_key.enabled: true)。

  1. 在 Kibana 的主菜单中,单击 添加集成,然后搜索您想要使用的 Elastic Agent 集成。阅读说明以确保集成与 Elastic Agent 兼容。
  2. 单击集成以查看更多详细信息,然后单击 添加 <集成>

    Add Nginx integration screen with agent policy selected

    如果您正在添加第一个集成并且没有安装 Elastic Agent,Kibana 可能会显示一个页面,引导您完成配置集成和安装 Elastic Agent 的步骤。如果您看到此页面,请单击 安装 Elastic Agent,然后单击 独立模式 链接。请按照产品内的说明操作,而不是此处描述的步骤。

  3. 配置集成 下,输入集成的名称和说明。
  4. 单击“已启用流”旁边的向下箭头,并确保设置适合您的主机。
  5. 应用于代理策略 下,选择现有策略,或单击 创建代理策略 并创建一个新的策略。
  6. 完成后,保存并继续。

    弹出窗口将为您提供将 Elastic Agent 添加到主机的选项。

    Popup window showing the option to add Elastic Agent to your hosts
  7. (可选) 要向代理策略添加更多集成,请单击 稍后添加 Elastic Agent 并返回到 集成 页面。对每个集成重复之前的步骤。
  8. 完成添加集成后,在弹出窗口中,单击 将 Elastic Agent 添加到您的主机 以打开 添加代理 浮层。
  9. 单击 运行独立模式 并按照产品内的说明下载 Elastic Agent(如果您尚未下载)。
  10. 单击 下载策略 下载策略文件。

    Add data screen with option to download the default agent policy

下载的策略已经包含您的设置的默认 Elasticsearch 地址和端口。如果您使用代理或负载均衡器,则可能需要更改它们。根据需要修改策略,确保您提供连接到 Elasticsearch 的凭据。

如果您需要在部署策略后向策略添加集成,则需要再次执行这些步骤并将更新的策略重新部署到运行 Elastic Agent 的主机。

有关启动代理的详细信息,包括 Elasticsearch 用户所需的权限,请参阅 安装独立 Elastic Agent

升级集成后升级独立代理策略

编辑

由于独立代理不受 Fleet 管理,因此无法自动升级到新的集成包版本。当您在 Kibana 中升级集成(或它被自动升级)时,您需要更新独立策略以使用新的功能和特性。

如果您想添加新的集成,也需要更新独立策略。

要更新独立策略,请使用与创建和下载原始策略文件相同的步骤。

  1. 按照创建独立 Elastic Agent 策略下的步骤创建和下载新策略,然后将新策略文件与旧策略文件进行比较。
  2. 可以使用新策略并将您的自定义应用于它,或者更新旧策略以包含升级添加的更改,例如字段更改。

确保更新运行 Elastic Agent 的目录中的独立代理策略,而不是您下载安装包的目录。有关已安装 Elastic Agent 文件位置的信息,请参阅 安装布局