安装Logtail(Linux系统)
本文介绍如何在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属于同一地域。 |
公网 |
|
全球加速 | 服务器分布在海外各地的自建机房或者来自海外云厂商,使用公网传输数据可能会出现网络延迟高、传输不稳定等问题,推荐选择全球加速传输数据。 |
更多信息,请参见选择网络。
在线安装时,将根据服务器系统自动匹配安装对应的Logtail,无需进行手动选择。
阿里云内网(经典网络、VPC)
如果您无法确定ECS所在地域,可使用Logtail安装脚本中的auto参数进行安装。
在安装命令中指定auto参数后,Logtail安装脚本会通过ECS获取您的实例元数据,自动确定ECS所在地域,实例元数据介绍请参见 ECS实例元数据概述。
通过公网下载Logtail安装脚本。
此下载消耗公网流量,约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}
安装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 金融云 |
|
华东1 金融云(公网) |
|
华东2 金融云 |
|
华东2 金融云(公网) |
|
华北2 金融云(邀测) |
|
华北2 金融云(邀测)(公网) |
|
华南1 金融云 |
|
华南1 金融云(公网) |
|
政务云
请根据Project所在的地域执行对应的安装命令。
Project所在的地域 | 安装命令 |
华北2 阿里政务云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。执行命令,下载安装脚本。
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
后续步骤
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 |