本文介绍如何在Linux服务器上安装、升级及卸载Logtail等操作。
使用限制
若在老机器上安装版本2.0遇到兼容性问题,建议下载版本1.8.7,执行命令./logtail.sh install ${your_region_name} -v 1.8.7
安装。
支持如下版本的Linux x86-64(64位)服务器。
Alibaba Cloud 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操作系统
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 ARM版
Debian 11.2 ARM版
CPU架构要求最低为ARMv8.2-A(2.0以上版本的iLogtail)
安装Logtail
请根据适用场景,选择不同网络类型对应的安装命令进行安装,网络类型指日志服务从服务器采集日志数据的网络连接方式。更多信息,请参见选择网络。
安装Logtail后,如果ECS的网络由经典网络切换至VPC,则需要更新Logtail配置。更多信息,请参见ECS经典网络切换为VPC后,如何更新Logtail配置
在线安装
网络类型 | 适用场景 |
阿里云内网 | 云服务器ECS实例和日志服务Project属于同一地域。 |
公网 |
|
传输加速 | 服务器分布在海外各地的自建机房或者来自海外云厂商,使用公网传输数据可能会出现网络延迟高、传输不稳定等问题,推荐选择传输加速传输数据。 |
在线安装时,将根据服务器系统自动匹配安装对应的Logtail,无需进行手动选择。
阿里云内网(经典网络、VPC)
如果您无法确定ECS实例所在地域,可下载Logtail安装脚本,然后使用auto参数进行安装。
在安装命令中指定auto参数后,Logtail安装脚本自动获取ECS实例元数据,确定ECS实例所在地域,实例元数据介绍请参见ECS实例元数据概述。
通过公网下载Logtail安装脚本到ECS实例的当前工作目录。此下载消耗公网流量,约10 KB。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh
使用auto参数安装Logtail。
此步骤自动下载对应地域的安装程序,不消耗公网流量。
./logtail.sh install auto
如果您已确定ECS所在地域,请根据地域选择安装命令。
通过内网下载Logtail安装脚本,手动安装Logtail,不消耗公网流量。
根据日志服务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}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod 755 logtail.sh; ./logtail.sh install ${your_region_name}
公网
根据日志服务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
离线安装
登录能通过公网访问的服务器。
替换
${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-internet
。华东 1(杭州)内网对应的
${your_region_name}
为cn-hangzhou
。华东 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。升级只覆盖必要的文件,配置文件以及Checkpoint文件将会被保留,升级期间日志不会丢失。
在线升级Logtail
您可以通过Logtail安装脚本(logtail.sh)升级Logtail,Logtail安装脚本会根据已经安装的Logtail配置信息自动选择合适的方式进行升级。
执行以下命令升级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
。执行命令,下载安装脚本。
wget http://logtail-release-${your_region_name}.oss-${your_region_name}.aliyuncs.com/linux64/logtail.sh
执行命令,下载安装包。
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
后续步骤
日志服务Project与服务器同地域同账号
配置流程如下图:
完成Logtail安装后,您需创建机器组,并选择数据源配置Logtail采集日志。具体操作,请参见创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。
日志服务Project与服务器同地域不同账号
配置流程如下图:
完成Logtail安装后,您需配置用户标识,配置用户自定义标识,创建机器组,并选择数据源配置Logtail采集日志。具体操作,请参见配置用户标识、创建用户自定义标识机器组及采集文本日志,通过Logtail跨阿里云账号采集日志。
日志服务Project与服务器不同地域
配置流程如下图:
您需选择公网完成Logtail安装,并配置用户标识,创建机器组并选择数据源创建Logtail采集日志。具体操作,请参见配置用户标识、创建IP地址机器组、创建用户自定义标识机器组及采集文本日志。
若下载Logtail时选择网络为阿里云内网(经典网络、VPC)时,可通过修改ilogtail_config.json文件中的网络参数进行跨地域采集。
编辑
/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" } ], ... }
输入以下命令,重启Logtail。
sudo /etc/init.d/ilogtaild restart
常见问题
如何判断是否安装Logtail成功?
您可以通过查看Logtail状态确定是否已在目标服务器上安装Logtail。具体操作,请参见查看Logtail状态。
安装Logtail后,配置采集任务心跳失败如何解决?
完成Logtail采集配置后,若出现心跳失败的情况,可执行如下命令查看Logtail版本,并进行升级重试。
cat /usr/local/ilogtail/app_info.json
安装Logtail后,采集数据发送失败错误码及处理方法有哪些?
Logtail将采集到的日志聚合并发送到日志服务。如果数据发送失败,Logtail自动根据错误信息决定重试或放弃发送,具体信息,请参见发送日志。
附录:地域与安装参数对照表
各地域对应的${your_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 |
华南1 | 深圳 | cn-shenzhen |
华南2 | 河源 | cn-heyuan |
华南3 | 广州 | cn-guangzhou |
西南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 |