AI 助理
备案控制台
文档
输入文档关键字查找
首页 日志服务 操作指南 数据采集 Logtail采集 管理Logtail 安装Logtail 安装Logtail（Linux系统）

安装Logtail（Linux系统）

更新时间：
产品详情
相关技术圈
我的收藏

本文介绍如何在Linux服务器上安装、升级及卸载Logtail等操作。

使用限制

重要

如果您使用的机器配置较低或者操作系统较为陈旧，安装Logtail2.0可能会出现兼容性问题，导致软件无法正常运行，建议下载版本1.8.7，执行命令./logtail.sh install ${region_name} -v 1.8.7安装。

  • 支持如下版本的Linux x86-64（64位）服务器。

    • Alibaba Cloud Linux 2、3

    • RedHat Enterprise 6、7、8

    • CentOS Linux 6、7、8

    • Debian GNU/Linux 8、9、10、11、12

    • Ubuntu 14.04、16.04、18.04、20.04、22.04、24.04

    • SUSE Linux Enterprise Server 11、12、15

    • OpenSUSE 15.1、15.2、42.3

    • 其他基于glibc 2.5及以上版本的Linux操作系统

    • CPU支持sse4_2指令集（2.0以上版本的iLogtail）

  • 支持如下版本的Linux ARM（64位）服务器。

    • Alibaba Cloud Linux 3.2 ARM版

    • Anolis OS 8.2 ARM版及以上版本

    • CentOS 8.4 ARM版

    • Ubuntu 20.04、24.04 ARM版

    • Debian 11.2 ARM版

    • CPU架构要求最低为ARMv8.2-A（2.0以上版本的iLogtail）

1. 安装Logtail

重要

  • 请根据适用场景，选择不同网络类型对应的安装命令进行安装，网络类型指日志服务从服务器采集日志数据的网络连接方式。更多信息，请参见选择网络。

  • 安装Logtail后，如果ECS的网络由经典网络切换至VPC，则需要更新Logtail配置。更多信息，请参见ECS经典网络切换为VPC后，如何更新Logtail配置

  • 在线安装

    网络类型

    适用场景

    阿里云内网

    云服务器ECS实例和日志服务Project属于同一地域。

    公网

    • 云服务器ECS实例和日志服务Project属于不同地域。

    • 服务器为其他云厂商服务器或自建IDC。

    传输加速

    服务器分布在海外各地的自建机房或者来自海外云厂商，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，推荐选择传输加速传输数据。

    说明

    在线安装时，将根据服务器系统自动匹配安装对应的Logtail，无需进行手动选择。

    阿里云内网（经典网络、VPC）

    • 如果您无法确定ECS实例所在地域，可下载Logtail安装脚本，然后使用auto参数进行安装。

      在安装命令中指定auto参数后，Logtail安装脚本自动获取ECS实例元数据，确定ECS实例所在地域，实例元数据介绍请参见ECS实例元数据概述。

      1. 通过公网下载Logtail安装脚本到ECS实例的当前工作目录。此下载消耗公网流量，约10 KB。

        wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh

      2. 使用auto参数安装Logtail。

        此步骤自动下载对应地域的安装程序，不消耗公网流量。

        ./logtail.sh install auto

    • 如果您已确定ECS所在地域，请根据地域选择安装命令。

      通过内网下载Logtail安装脚本，手动安装Logtail，不消耗公网流量。

      重要

      根据您的日志服务Project所在地域，获取对应的${region_name}。

      各个地域对应的${region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

      替换${region_name}后，执行安装命令。 

      wget http://logtail-release-${region_name}.oss-${region_name}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_name}

    公网

    重要

    根据您的日志服务Project所在地域，获取对应的${region_name}。

    各个地域对应的${region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

    替换${region_name}后，执行安装命令。

    wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_name}-internet

    传输加速

    1. 根据日志服务Project所在地域，获取对应的${region_name}。

      各个地域对应的${region_name}请参见附录：地域与安装参数对照表。例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

    2. 替换${region_name}后，执行安装命令。

      wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_name}-acceleration

    ECS金融云

    请根据Project所在的地域执行对应的安装命令。

    Project所在的地域

    安装命令

    华东1 金融云

    wget http://logtail-release-cn-hangzhou-finance-1.oss-cn-hzfinance-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install cn-hangzhou-finance

    华东1 金融云（公网）

    wget http://logtail-release-cn-hangzhou-finance-1.oss-cn-hzfinance.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install cn-hangzhou-finance-internet

    华东2 金融云

    wget http://logtail-release-cn-shanghai-finance-1.oss-cn-shanghai-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install cn-shanghai-finance-1

    华东2 金融云（公网）

    wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz; chmod +x logtail.sh; ./logtail.sh install-local cn-shanghai-finance-1-internet

    华北2 金融云（邀测）

    wget http://logtail-release-cn-beijing-finance-1.oss-cn-beijing-finance-1-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install cn-beijing-finance-1

    华北2 金融云（邀测）（公网）

    wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz; chmod +x logtail.sh; ./logtail.sh install-local cn-beijing-finance-1-internet

    华南1 金融云

    wget http://logtail-release-cn-shenzhen-finance-1.oss-cn-szfinance-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install cn-shenzhen-finance-1

    华南1 金融云（公网）

    wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail-linux64.tar.gz -O logtail-linux64.tar.gz; chmod +x logtail.sh; ./logtail.sh install-local cn-shenzhen-finance-1-internet

    政务云

    请根据Project所在的地域执行对应的安装命令。

    Project所在的地域

    安装命令

    华北2 阿里政务云1

    wget http://logtail-release-cn-north-2-gov-1.oss-cn-north-2-gov-1.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod +x logtail.sh; ./logtail.sh install cn-north-2-gov-1

  • 离线安装

    1. 在可以访问公网的服务器上下载安装脚本和安装包。

      重要

      根据您的日志服务Project所在地域，获取对应的${region_name}。

      各个地域对应的${region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

      1. 替换${region_name}后，执行以下命令下载安装脚本。

        wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail.sh

      2. 替换${region_name}后，执行以下命令下载安装包。

        • 安装包（x86-64）

          wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz

        • 安装包（ARM）

          wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz

    2. 将安装脚本和安装包拷贝至需要安装Logtail的目标服务器上。

    3. 替换${region_name}后，在目标服务器上执行安装命令。

      重要

      各个地域对应的${region_name}请参见附录：地域与安装参数对照表。例如：

      • 华东 1（杭州）公网对应的${region_name}为cn-hangzhou-internet。

      • 华东 1（杭州）内网对应的${region_name}为cn-hangzhou。

      • 华东 1（杭州）传输加速对应的${region_name}为cn-hangzhou-acceleration。

      chmod +x logtail.sh; ./logtail.sh install-local ${region_name}

2. 启动和停止Logtail

  • 执行如下命令启动Logtail。 

    sudo /etc/init.d/ilogtaild start

  • 执行如下命令停止Logtail。

    sudo /etc/init.d/ilogtaild stop

3. 查看Logtail状态及版本

Logtail安装完成后，您可以查看Logtail状态及版本。

  • 查看Logtail状态

    您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。

    • 命令

      sudo /etc/init.d/ilogtaild status

    • 返回结果

      如果系统返回如下信息，表示已安装Logtail。

      ilogtail is running

      如果Logtail状态显示未运行，请卸载后重新安装。

  • 查看Logtail版本

    Logtail会将版本信息记录在/usr/local/ilogtail/app_info.json文件中的logtail_version字段。

    • 命令

      cat /usr/local/ilogtail/app_info.json

    • 返回结果

      {
   "UUID" : "0DF18E97-0F2D-486F-B77F-*********",
   "hostname" : "david*******",
   "instance_id" : "F4FAFADA-F1D7-11E7-846C-00163E30349E_*********_1515129548",
   "ip" : "**********",
   "logtail_version" : "0.16.30",
   "os" : "Linux; 2.6.32-220.23.2.ali1113.el5.x86_64; #1 SMP Thu Jul 4 20:09:15 CST 2013; x86_64",
   "update_time" : "2020-01-05 13:19:08"
}

3. 升级Logtail

重要

  • 升级Logtail时，请使用upgrade命令。如果使用install命令，则会进行覆盖安装，会卸载、删除/usr/local/ilogtail等目录，清空原有配置。安装后默认启动Logtail并注册开机启动。

  • 升级过程中会短暂停止Logtail。升级只覆盖必要的文件，配置文件以及Checkpoint文件将会被保留，升级期间日志不会丢失。

  • 在线升级Logtail

    您可以通过Logtail安装脚本（logtail.sh）升级Logtail，Logtail安装脚本会根据已经安装的Logtail配置信息自动选择合适的方式进行升级。

    1. 执行以下命令升级Logtail。

      wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh
sudo ./logtail.sh upgrade

    2. 确认升级结果。

      显示类似信息表示升级成功。 

      Stop logtail successfully.
ilogtail is running
Upgrade logtail success
{
   "UUID" : "***",
   "hostname" : "***",
   "instance_id" : "***",
   "ip" : "***",
   "logtail_version" : "0.16.30",
   "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
   "update_time" : "2020-08-29 15:01:36"
}

  • 离线升级Logtail

    1. 在可以访问公网的服务器上下载安装脚本和安装包。

      重要

      根据您的日志服务Project所在地域，获取对应的${region_name}。

      各个地域对应的${region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

      1. 替换${region_name}后，执行以下命令下载安装脚本。

        wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail.sh

      2. 替换${region_name}后，执行以下命令下载安装包。

        • 安装包（x86-64）

          wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz

        • 安装包（ARM）

          wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz

    2. 将安装脚本和安装包拷贝至需要安装Logtail的目标服务器上。

    3. 在目标服务器上执行升级命令。

      chmod +x logtail.sh; ./logtail.sh upgrade-local

4. 卸载Logtail

重要

根据您的日志服务Project所在地域，获取对应的${region_name}。

各个地域对应的${region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${region_name}为cn-hangzhou。

替换${region_name}后，执行卸载命令。

wget http://logtail-release-${region_name}.oss-${region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

后续步骤

  • 日志服务Project与服务器同地域同账号

    配置流程如下图：

    image

    完成Logtail安装后，您需创建机器组，并选择数据源配置Logtail采集日志。具体操作，请参见创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。

  • 日志服务Project与服务器同地域不同账号

    配置流程如下图：

    image

    完成Logtail安装后，您需配置用户标识，配置用户自定义标识，创建机器组，并选择数据源配置Logtail采集日志。具体操作，请参见配置用户标识、创建用户自定义标识机器组及采集文本日志，通过Logtail跨阿里云账号采集日志。

  • 日志服务Project与服务器不同地域

    配置流程如下图：

    image

    您需选择公网完成Logtail安装，并配置用户标识，创建机器组并选择数据源创建Logtail采集日志。具体操作，请参见配置用户标识、创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。

    若下载Logtail时选择网络为阿里云内网（经典网络、VPC）时，可通过修改ilogtail_config.json文件中的网络参数进行跨地域采集。

    1. 编辑/usr/local/ilogtail/ilogtail_config.json文件，修改配置文件参数。

      例如Project在西南1（成都），ECS在华东1（杭州），修改配置参数为

      {
  "config_server_address" : "http://logtail.cn-chengdu.log.aliyuncs.com",
  "data_server_list" :
  [
    {
      "cluster" : "cn-chengdu",
      "endpoint" : "cn-chengdu.log.aliyuncs.com"
    }
  ],
  ...
}

    2. 输入以下命令，重启Logtail。

      sudo /etc/init.d/ilogtaild restart

常见问题

  1. 如何判断是否安装Logtail成功？

    您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。具体操作，请参见查看Logtail状态。

  2. 安装Logtail后，配置采集任务心跳失败如何解决？

    完成Logtail采集配置后，若出现心跳失败的情况，可执行如下命令查看Logtail版本，并进行升级重试。

    cat /usr/local/ilogtail/app_info.json

  3. 安装Logtail后，采集数据发送失败错误码及处理方法有哪些？

    Logtail将采集到的日志聚合并发送到日志服务。如果数据发送失败，Logtail自动根据错误信息决定重试或放弃发送，具体信息，请参见发送日志。

附录：地域与安装参数对照表

各地域对应的${region_name}参数如下所示。

地域

城市

Region ID

华北1

青岛

cn-qingdao

华北2

北京

cn-beijing

华北3

张家口

cn-zhangjiakou

华北5

呼和浩特

cn-huhehaote

华北6

乌兰察布

cn-wulanchabu

华东1

杭州

cn-hangzhou

华东2

上海

cn-shanghai

华东5

南京（本地地域）

cn-nanjing

华东6

福州（本地地域）

cn-fuzhou

华南1

深圳

cn-shenzhen

华南2

河源

cn-heyuan

华南3

广州

cn-guangzhou

华中1

武汉（本地地域）

cn-wuhan

西南1

成都

cn-chengdu

中国香港

香港

cn-hongkong

亚太东南1

新加坡

ap-southeast-1

亚太东南2（关停中）

悉尼

ap-southeast-2

亚太东南3

吉隆坡

ap-southeast-3

亚太东南5

雅加达

ap-southeast-5

亚太东南6

马尼拉

ap-southeast-6

亚太东南7

曼谷

ap-southeast-7

亚太南部1

孟买

ap-south-1

亚太东北1

东京

ap-northeast-1

亚太东北2

首尔

ap-northeast-2

美国西部1

硅谷

us-west-1

美国东部1

弗吉尼亚

us-east-1

欧洲中部1

法兰克福

eu-central-1

欧洲西部1

伦敦

eu-west-1

中东东部1

迪拜

me-east-1

上一篇：安装Logtail（ECS实例）下一篇：安装Logtail（Windows系统）
文档推荐