安装 Fleet 管理的 Elastic Agent

安装 Fleet 管理的 Elastic Agent编辑

要快速上手，请阅读我们的端到端指南之一

正在寻找升级信息？请参阅升级 Elastic Agent。

只想了解如何安装 Elastic Agent？继续阅读本页。

您始终需要

具有 Fleet 和集成上 All 权限的 Kibana 用户。 由于许多集成资产在各个空间之间共享，因此用户需要在所有空间中拥有 Kibana 权限。
Fleet Server 运行在 Elastic Agent 可访问的位置。 Elastic Agent 必须与 Fleet Server 和 Elasticsearch 建立直接网络连接。如果您使用的是 Elastic Cloud 上的托管 Elasticsearch 服务，则 Fleet Server 作为集成服务器的一部分已经可用。对于自管理部署，请参阅部署本地和自管理。
Kibana 从 Elastic Package Registry 下载集成包的互联网连接。 确保 Kibana 服务器可以连接到端口 443 上的 https://epr.elastic.co。如果您的环境存在网络流量限制，则可以通过多种方法解决此问题。有关更多信息，请参阅隔离环境。

如果您使用的是使用组织证书的 Fleet Server，您还需要

证书颁发机构 (CA) 证书，用于配置传输层安全性 (TLS) 以加密流量。 如果您的组织已经使用 Elastic Stack，您可能已经拥有 CA 证书。如果您没有 CA 证书，您可以在为自管理的 Fleet Server 配置 SSL/TLS 中了解有关生成证书的更多信息。

如果您运行的是 Elastic Agent 7.9 或更早版本，请停止 Agent 并将其从主机中手动删除。

您只能在每个主机上安装一个 Elastic Agent。

Elastic Agent 可以监控其部署所在的主机，并且可以收集和转发来自无法直接部署的远程服务和硬件的数据。

要安装 Elastic Agent 并将其注册到 Fleet 中

在 Fleet 中，打开 Agent 选项卡，然后单击 添加 Agent。
在 添加 Agent 侧边栏中，选择现有 Agent 策略或创建一个新策略。如果您创建了一个新策略，Fleet 将生成一个新的 Fleet 注册令牌。

对于本地部署，您可以将一个策略专门用于网络边界中的所有 Agent，并将该策略配置为包含特定 Fleet Server（或 Fleet Server 集群）。

在将 Fleet Server 添加到策略中了解更多信息。
确保选中 注册到 Fleet。
通过选择您的主机操作系统并按照 在您的主机上安装 Elastic Agent 步骤操作，下载、安装和注册主机上的 Elastic Agent。请注意，显示的命令适用于 AMD 平台，但 ARM 包也可用。有关可用包的完整列表，请参阅 Elastic Agent 下载页面。
1. 如果您将 Agent 注册到使用组织证书的 Fleet Server 中，您必须将 --certificate-authorities 选项添加到产品内说明中提供的命令中。如果您不包含证书，您将看到以下错误：“x509: 证书由未知机构签名”。

大约一分钟后，Agent 将注册到 Fleet，下载 Agent 策略中指定的配置，并开始收集数据。

注意

如果您遇到“x509: 证书由未知机构签名”错误，您可能正在尝试注册到使用自签名证书的 Fleet Server。要在非生产环境中解决此问题，请传递 --insecure 标志。有关更多信息，请参阅故障排除指南。
您也可以使用 --tag 标志来指定要应用于已注册 Elastic Agent 的逗号分隔的标签列表。有关更多信息，请参阅按标签筛选 Agent 列表。
有关已安装 Elastic Agent 文件的位置，请参阅安装布局。
由于 Elastic Agent 是作为自动启动服务安装的，因此如果系统重新启动，它将自动重新启动。

要确认 Elastic Agent 是否已安装并正在运行，请在 Fleet 中打开 Agent 选项卡。

如果状态停留在注册中，请确保 elastic-agent 进程正在运行。

如果您遇到问题

检查 Elastic Agent 日志。如果您使用默认策略，则会自动收集 Agent 日志和指标，除非您更改默认设置。有关更多信息，请参阅在 Fleet 中监控 Elastic Agent。
请参阅故障排除指南。

有关在 Fleet 中管理 Elastic Agent 的信息，请参阅在 Fleet 中集中管理 Elastic Agent。