安装 Fleet 管理的 Elastic Agent

要快速启动并运行，请阅读我们的端到端指南之一

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

只想学习如何安装 Elastic Agent？请继续阅读此页面。

您始终需要

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

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

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

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

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

Elastic Agent 可以监视部署它的主机，并且可以从无法直接部署的远程服务和硬件收集和转发数据。

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

在 Fleet 中，打开 Agents 选项卡，然后单击 添加 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 中打开 Agents 选项卡。

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

如果您遇到问题

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

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