« 安装 Fleet 管理的 Elastic Agent 升级独立 Elastic Agent »
Elastic 文档 ›Fleet 和 Elastic Agent 指南 [8.16] ›安装 Elastic Agent

安装独立 Elastic Agent

编辑

安装独立 Elastic Agent

编辑

要以独立模式运行 Elastic Agent，请安装 Agent 并手动在安装它的系统上本地配置 Agent。您负责管理和升级 Agent。此方法仅推荐给高级用户。

我们建议尽可能使用 Fleet 管理的 Elastic Agent，因为它可以大大简化 Agent 的管理和升级。

独立 Agent 无法自动升级到新的集成包版本。当您在 Kibana 中升级集成时，您需要手动更新独立策略。

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

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

安装和运行独立 Elastic Agent

  1. 在您的主机上，下载并解压安装包。

    curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.16.0-darwin-x86_64.tar.gz
tar xzvf elastic-agent-8.16.0-darwin-x86_64.tar.gz

    显示的命令适用于 AMD 平台，但 ARM 软件包也可用。有关可用软件包的完整列表，请参阅 Elastic Agent 下载页面。

  2. 根据需要修改 elastic-agent.yml 中的设置。

    为了快速入门并避免错误，请使用 Kibana 创建和下载独立配置文件，而不是尝试手动构建它。有关更多信息，请参阅 创建独立 Elastic Agent 策略。

    有关其他配置选项，请参阅 配置独立 Elastic Agent。

  3. 在 elastic-agent.yml 策略文件中，在 outputs 下，为 Elastic Agent 指定 API 密钥或用户凭据以访问 Elasticsearch。例如：

    [...]
outputs:
  default:
    type: elasticsearch
    hosts:
      - 'https://da4e3a6298c14a6683e6064ebfve9ace.us-central1.gcp.cloud.es.io:443'
    api_key: _Nj4oH0aWZVGqM7MGop8:349p_U1ERHyIc4Nm8_AYkw 
[...]

    有关所需权限和创建 API 密钥的更多信息，请参阅 授予独立 Elastic Agent 访问 Elasticsearch 的权限。

  4. 确保您需要的资源（例如仪表板和摄取管道）已在 Kibana 和 Elasticsearch 中设置。如果您使用 Kibana 生成独立配置，则会自动设置资源。否则，您需要安装它们。有关更多信息，请参阅 查看集成资源 和 安装集成资源。

  5. 从 Agent 目录中，运行以下命令以安装 Elastic Agent 并将其作为服务启动。

    在 macOS、Linux（tar 包）和 Windows 上，运行 install 命令将 Elastic Agent 安装为托管服务并启动该服务。DEB 和 RPM 包包含一个适用于具有 systemd 的 Linux 系统的服务单元，因此只需启用然后启动服务即可。

    您必须以 root 用户身份运行此命令，因为某些集成需要 root 权限才能收集敏感数据。

    sudo ./elastic-agent install

有关已安装 Elastic Agent 文件的位置，请参阅 安装布局。

由于 Elastic Agent 安装为自动启动服务，因此如果系统重新启动，它将自动重新启动。

如果您遇到问题，请参阅 排查常见问题。

« 安装 Fleet 管理的 Elastic Agent 升级独立 Elastic Agent »