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

安装独立 Elastic 代理

编辑

安装独立 Elastic 代理编辑

要在独立模式下运行 Elastic 代理，请在安装代理的系统上本地安装代理并手动配置代理。您需要负责管理和升级代理。仅建议高级用户使用此方法。

我们建议尽可能使用 Fleet 管理的 Elastic 代理，因为它可以使代理的管理和升级变得更加容易。

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

您每个主机只能安装一个 Elastic 代理。

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

安装和运行独立 Elastic 代理

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

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

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

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

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

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

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

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

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

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

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

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

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

    sudo ./elastic-agent install

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

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

如果遇到问题，请参阅 解决常见问题。

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