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

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

前提条件

支持安装Logtail的Linux系统如下：

支持如下版本的Linux x86-64（64位）服务器。
- Aliyun Linux 2
- RedHat Enterprise 6、7、8
- CentOS Linux 6、7、8
- Debian GNU/Linux 8、9、10、11
- Ubuntu 14.04、16.04、18.04、20.04
- SUSE Linux Enterprise Server 11、12、15
- OpenSUSE 15.1、15.2、42.3
- 其他基于glibc 2.5及以上版本的Linux操作系统
支持如下版本的Linux ARM（64位）服务器。
- Alibaba Linux 3.2 ARM版
- Anolis OS 8.2 ARM版及以上版本
- CentOS 8.4 ARM版
- Ubuntu 20.04 ARM版
- Debian 11.2 ARM版

安装Logtail

在线安装

请根据实际情况选择网络类型对应的安装命令进行安装。

重要

网络类型指日志服务从服务器采集日志数据的网络连接方式。

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

更多信息，请参见选择网络。

说明

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

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

如果您无法确定ECS所在地域，可使用Logtail安装脚本中的auto参数进行安装。
在安装命令中指定auto参数后，Logtail安装脚本会通过ECS获取您的实例元数据，自动确定ECS所在地域，实例元数据介绍请参见 ECS实例元数据概述。
1. 通过公网下载Logtail安装脚本。
  此下载消耗公网流量，约10 KB。
```
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh;chmod 755 logtail.sh
```
2. 使用auto参数安装logtail。
  此步骤自动下载对应地域的安装程序，不消耗公网流量。
```
./logtail.sh install auto
```
如果您已确定ECS所在地域，请根据地域选择安装命令。
通过内网下载Logtail安装脚本，手动安装Logtail，不消耗公网流量。
1. 根据日志服务Project所在地域，获取对应的${your_region_name}。
  各个地域对应的${your_region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${your_region_name}为cn-hangzhou。
2. 替换${your_region_name}后，执行安装命令。
```
wget http://logtail-release-${your_region_name}.oss-${your_region_name}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}
```

说明

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

公网

根据日志服务Project所在地域，获取对应的${your_region_name}。
各个地域对应的${your_region_name}请参见附录：地域与安装参数对照表，例如华东 1（杭州）对应的${your_region_name}为cn-hangzhou。

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

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

全球加速

根据日志服务Project所在地域，获取对应的${your_region_name}。
各个地域对应的${your_region_name}请参见附录：地域与安装参数对照表。例如华东 1（杭州）对应的${your_region_name}为cn-hangzhou。

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

wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_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 755 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 755 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 755 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 755 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 755 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 755 logtail.sh; ./logtail.sh install cn-north-2-gov-1`

离线安装

登录能通过公网访问的服务器。

替换${your_region_name}后，执行下载命令，下载安装脚本和安装包。

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

下载安装脚本

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

下载安装包（x86-64）

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

下载安装包（ARM）

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

将安装脚本和安装包拷贝至待安装Logtail的目标服务器上。
替换${your_region_name}后，在目标服务器上执行安装命令。
各个地域对应的${your_region_name}请参见附录：地域与安装参数对照表。例如：
- 华东 1（杭州）内网对应的${your_region_name}为cn-hangzhou。
- 华东 1（杭州）公网对应的${your_region_name}为cn-hangzhou-internet。
- 华东 1（杭州）全球加速对应的${your_region_name}为cn-hangzhou-acceleration。
```
chmod +x logtail.sh; ./logtail.sh install-local ${your_region_name}
```

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

升级Logtail

重要

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

在线升级Logtail

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

说明

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

执行以下命令升级Logtail。

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

确认升级结果。

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

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

登录能通过公网访问的服务器。
替换${your_region_name}后，执行下载命令。
各个地域公网对应的${your_region_name}请参见附录：地域与安装参数对照表。例如华东 1（杭州）公网对应的${your_region_name}为cn-hangzhou-internet。
1. 执行命令，下载安装脚本。
```
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
```
2. 执行命令，下载安装包。
```
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail-linux64.tar.gz
```
将安装脚本和安装包拷贝至待升级Logtail的目标服务器上。

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

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

手动启动和停止Logtail

执行如下命令启动Logtail。
```
sudo /etc/init.d/ilogtaild start
```
执行如下命令停止Logtail。
```
sudo /etc/init.d/ilogtaild stop
```

卸载Logtail

根据日志服务Project所在地域，获取对应的${your_region_name}。
各个地域对应的请参见附录：地域与安装参数对照表。例如华东 1（杭州）对应的${your_region_name}为cn-hangzhou。

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

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

后续步骤

Logtail安装完成后，您可根据实际应用场景，进行后续操作。

采集同一账号下同地域服务器的日志：
配置流程如下图：
完成Logtail安装后，您需创建机器组，并选择数据源配置Logtail采集日志。具体操作，请参见创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。
采集不同账号下同地域服务器的日志：
配置流程如下图：
完成Logtail安装后，您需配置用户标识，配置用户自定义标识，创建机器组，并选择数据源配置Logtail采集日志。具体操作，请参见配置用户标识、创建用户自定义标识机器组及采集文本日志，通过Logtail跨阿里云账号采集日志。
跨地域采集同账号下服务器的日志：
配置流程如下图：
您需选择公网完成Logtail安装，并配置用户标识，创建机器组并选择数据源创建Logtail采集日志。具体操作，请参见配置用户标识、创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。
重要
若下载Logtail时选择网络为阿里云内网（经典网络、VPC）时，可通过修改ilogtail_config.json文件中的网络参数进行跨地域采集。

常见问题

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

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

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

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

cat /usr/local/ilogtail/app_info.json

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

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

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

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

地域	${your_region_name}
华北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-chengdu
中国（香港）	cn-hongkong
美国（硅谷）	us-west-1
美国（弗吉尼亚）	us-east-1
新加坡	ap-southeast-1
澳大利亚（悉尼）	ap-southeast-2
马来西亚（吉隆坡）	ap-southeast-3
印度尼西亚（雅加达）	ap-southeast-5
菲律宾（马尼拉）	ap-southeast-6
泰国（曼谷）	ap-southeast-7
印度（孟买）	ap-south-1
日本（东京）	ap-northeast-1
韩国（首尔）	ap-northeast-2
德国（法兰克福）	eu-central-1
阿联酋（迪拜）	me-east-1
英国（伦敦）	eu-west-1