› ›

安装 Fleet 托管的 Elastic Agent

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

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

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

您始终需要

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

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

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

如果您正在运行 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: certificate signed by unknown authority”。

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

备注

如果您遇到“x509: certificate signed by unknown authority”错误，您可能正在尝试注册到使用自签名证书的 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。