如何在Linux服务器上安装、升级和卸载Logtail - 日志服务

如果您要使用日志服务Project采集服务器日志，首先需要安装Logtail客户端。本文介绍如何在Linux系统中安装、升级和卸载Logtail。

使用限制

重要

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

安装Logtail

重要

请根据适用场景，选择不同网络类型对应的安装命令进行安装，网络类型指日志服务Project从服务器采集日志数据的网络连接方式。更多信息，请参见选择网络。
安装Logtail后，如果ECS的网络由经典网络切换至VPC，则需要更新Logtail配置。更多信息，请参见ECS经典网络切换为VPC后，如何更新Logtail配置。

在线安装

网络类型	适用场景
阿里云内网	云服务器ECS实例和日志服务Project属于同一地域。
公网	云服务器ECS实例和日志服务Project属于不同地域。服务器为其他云厂商服务器或自建IDC。
传输加速	服务器分布在海外各地的自建机房或者来自海外云厂商，使用公网传输数据可能会出现网络延迟高、传输不稳定等问题，推荐选择传输加速传输数据。

说明

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

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

未确定ECS实例所在地域
通过公网下载Logtail安装脚本，然后使用auto参数进行安装。在安装命令中指定auto参数后，Logtail安装脚本自动获取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实例所在地域
根据ECS实例所在地域，获取对应的${region_id}。替换${region_id}后，执行安装命令。
重要
各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。
```
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh install ${region_id}
```
通过阿里云内网下载Logtail安装脚本，不消耗公网流量。

公网

根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行安装命令。

重要

各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

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

传输加速

根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行安装命令。

重要

各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

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

离线安装
1. 在可以访问公网的服务器上下载安装脚本和安装包。
  重要
  各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。
  1. 根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令下载安装脚本。
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
  2. 根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令下载安装包。
    安装包（x86-64）
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz
    安装包（ARM）
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz
2. 将安装脚本和安装包拷贝至需要安装Logtail的服务器上。
3. 根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，选择以下安装命令。
  重要
  各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。
  - 公网
```
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
```
  - 内网
```
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}
```
  - 传输加速
```
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration
```

启动和停止Logtail

启动Logtail
```
sudo /etc/init.d/ilogtaild start
```
停止Logtail
```
sudo /etc/init.d/ilogtaild stop
```

查看Logtail状态及版本

查看Logtail状态
使用以下命令查看Logtail状态。
```
sudo /etc/init.d/ilogtaild status 
```
如果系统返回如下信息，表示已安装Logtail。
```
ilogtail is running
```
如果Logtail状态显示未运行，请卸载后重新安装。

查看Logtail版本

Logtail会将版本信息记录在/usr/local/ilogtail/app_info.json文件中的logtail_version字段。使用以下命令查看Logtail版本信息。

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"
}

升级Logtail

重要

升级Logtail时，请使用upgrade命令。如果使用install命令，则会进行覆盖安装，会卸载、删除/usr/local/ilogtail等目录，清空原有配置。安装后默认启动Logtail并注册开机启动。
升级过程中会短暂停止Logtail。升级只覆盖必要的文件，配置文件以及Checkpoint文件将会被保留，升级期间日志不会丢失。

在线升级Logtail

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

根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令升级Logtail。
重要
各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。
```
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh
sudo ./logtail.sh upgrade
```

确认升级结果。

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

stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

离线升级Logtail
1. 在可以访问公网的服务器上下载安装脚本和安装包。
  重要
  各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。
  1. 根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令下载安装脚本。
```
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
```
  2. 根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行以下命令下载安装包。
    - 安装包（x86-64）
      wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz
    - 安装包（ARM）
      wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz
2. 将安装脚本和安装包拷贝至需要安装Logtail的服务器上。
3. 在目标服务器上执行升级命令。
```
chmod +x logtail.sh; ./logtail.sh upgrade-local
```

卸载Logtail

重要

各地域对应的${region_id}请参见开服地域，例如华东 1（杭州）对应的${region_id}为cn-hangzhou。

根据日志服务Project所在地域，获取对应的${region_id}。替换${region_id}后，执行卸载命令。

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

适用场景

服务器与日志服务Project同账号同地域
（推荐使用）日志服务借助运维编排服务OOS，可实现在同地域ECS实例中自动安装Logtail。更多信息，请参见安装Logtail（ECS实例）。
如自动安装不满足需求，您也可根据本文手动安装Logtail。
服务器与日志服务Project同账号不同地域
配置流程如下图：
您需选择公网安装Logtail。然后在日志服务Project中创建机器组，并配置Logtail采集日志。更多信息，请参见采集主机文本日志。
若您通过阿里云内网（经典网络、VPC）安装Logtail，可通过修改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
```
服务器与日志服务Project不同账号
此方法适用于服务器部署在其他阿里云账号、其他云厂商环境或自建IDC中。配置流程如下图：
您需选择公网安装Logtail，然后使用A账号ID配置用户标识，并配置用户自定义标识。然后在账号A的日志服务Project中创建用户自定义标识机器组，并配置Logtail采集日志。更多信息，请参见采集主机文本日志、通过Logtail跨阿里云账号采集日志。

常见问题

如何判断是否安装Logtail成功？
您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。具体操作，请参见查看Logtail状态。
安装Logtail后，配置采集任务心跳失败如何解决？
完成Logtail采集配置后，若出现心跳失败的情况，可执行如下命令查看Logtail版本，并进行升级重试。
```
cat /usr/local/ilogtail/app_info.json
```
安装Logtail后，采集数据发送失败错误码及处理方法有哪些？
Logtail将采集到的日志聚合并发送到日志服务。如果数据发送失败，Logtail自动根据错误信息决定重试或放弃发送，具体信息，请参见发送日志。

日志服务：安装Logtail（Linux系统）

使用限制

安装Logtail

在线安装

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

公网

传输加速

离线安装

启动和停止Logtail

查看Logtail状态及版本

查看Logtail状态

查看Logtail版本

升级Logtail

在线升级Logtail

离线升级Logtail

卸载Logtail

适用场景

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

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

服务器与日志服务Project不同账号

常见问题