安裝Logtail(Linux系統(tǒng))
如果您要使用日志服務(wù)Project采集服務(wù)器日志,首先需要安裝Logtail客戶端。本文介紹如何在Linux系統(tǒng)中安裝、升級(jí)和卸載Logtail。
使用限制
如果您使用的機(jī)器配置較低或者操作系統(tǒng)較為陳舊,安裝Logtail2.0可能會(huì)出現(xiàn)兼容性問(wèn)題,導(dǎo)致軟件無(wú)法正常運(yùn)行,建議下載版本1.8.7,執(zhí)行命令./logtail.sh install ${region_id} -v 1.8.7
安裝。
支持如下版本的Linux x86-64(64位)服務(wù)器。
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操作系統(tǒng)(2.0以上版本的Logtail需要glibc2.6及以上版本)
CPU支持sse4_2和avx指令集(2.0以上版本的Logtail)
支持如下版本的Linux ARM(64位)服務(wù)器。
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架構(gòu)要求最低為ARMv8.2-A(2.0以上版本的iLogtail)
安裝Logtail
請(qǐng)根據(jù)適用場(chǎng)景,選擇不同網(wǎng)絡(luò)類型對(duì)應(yīng)的安裝命令進(jìn)行安裝,網(wǎng)絡(luò)類型指日志服務(wù)Project從服務(wù)器采集日志數(shù)據(jù)的網(wǎng)絡(luò)連接方式。更多信息,請(qǐng)參見(jiàn)選擇網(wǎng)絡(luò)。
安裝Logtail后,如果ECS的網(wǎng)絡(luò)由經(jīng)典網(wǎng)絡(luò)切換至VPC,則需要更新Logtail配置。更多信息,請(qǐng)參見(jiàn)ECS經(jīng)典網(wǎng)絡(luò)切換為VPC后,如何更新Logtail配置。
在線安裝
網(wǎng)絡(luò)類型
適用場(chǎng)景
阿里云內(nèi)網(wǎng)
云服務(wù)器ECS實(shí)例和日志服務(wù)Project屬于同一地域。
公網(wǎng)
云服務(wù)器ECS實(shí)例和日志服務(wù)Project屬于不同地域。
服務(wù)器為其他云廠商服務(wù)器或自建IDC。
傳輸加速
服務(wù)器分布在海外各地的自建機(jī)房或者來(lái)自海外云廠商,使用公網(wǎng)傳輸數(shù)據(jù)可能會(huì)出現(xiàn)網(wǎng)絡(luò)延遲高、傳輸不穩(wěn)定等問(wèn)題,推薦選擇傳輸加速傳輸數(shù)據(jù)。
說(shuō)明在線安裝時(shí),將根據(jù)服務(wù)器系統(tǒng)自動(dòng)匹配安裝對(duì)應(yīng)的Logtail,無(wú)需進(jìn)行手動(dòng)選擇。
阿里云內(nèi)網(wǎng)(經(jīng)典網(wǎng)絡(luò)、VPC)
未確定ECS實(shí)例所在地域
通過(guò)公網(wǎng)下載Logtail安裝腳本,然后使用auto參數(shù)進(jìn)行安裝。在安裝命令中指定auto參數(shù)后,Logtail安裝腳本自動(dòng)獲取ECS實(shí)例元數(shù)據(jù),確定ECS實(shí)例所在地域,實(shí)例元數(shù)據(jù)介紹請(qǐng)參見(jiàn)實(shí)例元數(shù)據(jù)。
通過(guò)公網(wǎng)下載Logtail安裝腳本到ECS實(shí)例的當(dāng)前工作目錄。此下載消耗公網(wǎng)流量,約10 KB。
wget http://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh
使用auto參數(shù)安裝Logtail。 此步驟自動(dòng)通過(guò)阿里云內(nèi)網(wǎng)下載對(duì)應(yīng)地域的安裝程序,不消耗公網(wǎng)流量。
./logtail.sh install auto
已確定ECS實(shí)例所在地域
根據(jù)ECS實(shí)例所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行安裝命令。重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${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}
通過(guò)阿里云內(nèi)網(wǎng)下載Logtail安裝腳本,不消耗公網(wǎng)流量。
公網(wǎng)
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行安裝命令。重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${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
傳輸加速
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行安裝命令。重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${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
ECS金融云
請(qǐng)根據(jù)日志服務(wù)Project所在的地域執(zhí)行對(duì)應(yīng)的安裝命令。
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 金融云(公網(wǎng))
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 金融云(公網(wǎng))
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 金融云(邀測(cè))
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 金融云(邀測(cè))(公網(wǎng))
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 金融云(公網(wǎng))
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
政務(wù)云
請(qǐng)根據(jù)日志服務(wù)Project所在的地域執(zhí)行對(duì)應(yīng)的安裝命令。
Project所在的地域
安裝命令
華北2 阿里政務(wù)云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
離線安裝
在可以訪問(wèn)公網(wǎng)的服務(wù)器上下載安裝腳本和安裝包。
重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${region_id}
為cn-hangzhou
。根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行以下命令下載安裝腳本。wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行以下命令下載安裝包。安裝包(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
將安裝腳本和安裝包拷貝至需要安裝Logtail的服務(wù)器上。
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,選擇以下安裝命令。重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${region_id}
為cn-hangzhou
。公網(wǎng)
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
內(nèi)網(wǎng)
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}
傳輸加速
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration
啟動(dòng)和停止Logtail
啟動(dòng)Logtail
sudo /etc/init.d/ilogtaild start
停止Logtail
sudo /etc/init.d/ilogtaild stop
查看Logtail狀態(tài)及版本
查看Logtail狀態(tài)
使用以下命令查看Logtail狀態(tài)。
sudo /etc/init.d/ilogtaild status
如果系統(tǒng)返回如下信息,表示已安裝Logtail。
ilogtail is running
如果Logtail狀態(tài)顯示未運(yùn)行,請(qǐng)卸載后重新安裝。
查看Logtail版本
Logtail會(huì)將版本信息記錄在
/usr/local/ilogtail/app_info.json
文件中的logtail_version
字段。使用以下命令查看Logtail版本信息。cat /usr/local/ilogtail/app_info.json
返回結(jié)果
{ "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" }
升級(jí)Logtail
升級(jí)Logtail時(shí),請(qǐng)使用
upgrade
命令。如果使用install
命令,則會(huì)進(jìn)行覆蓋安裝,會(huì)卸載、刪除/usr/local/ilogtail
等目錄,清空原有配置。安裝后默認(rèn)啟動(dòng)Logtail并注冊(cè)開(kāi)機(jī)啟動(dòng)。升級(jí)過(guò)程中會(huì)短暫停止Logtail。升級(jí)只覆蓋必要的文件,配置文件以及Checkpoint文件將會(huì)被保留,升級(jí)期間日志不會(huì)丟失。
在線升級(jí)Logtail
您可以通過(guò)Logtail安裝腳本(logtail.sh)升級(jí)Logtail,Logtail安裝腳本會(huì)根據(jù)已經(jīng)安裝的Logtail配置信息自動(dòng)選擇合適的方式進(jìn)行升級(jí)。
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行以下命令升級(jí)Logtail。重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${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
確認(rèn)升級(jí)結(jié)果。
顯示類似信息表示升級(jí)成功。
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" }
離線升級(jí)Logtail
在可以訪問(wèn)公網(wǎng)的服務(wù)器上下載安裝腳本和安裝包。
重要各地域?qū)?yīng)的
${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${region_id}
為cn-hangzhou
。根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行以下命令下載安裝腳本。wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的
${region_id}
。替換${region_id}
后,執(zhí)行以下命令下載安裝包。安裝包(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
將安裝腳本和安裝包拷貝至需要安裝Logtail的服務(wù)器上。
在目標(biāo)服務(wù)器上執(zhí)行升級(jí)命令。
chmod +x logtail.sh; ./logtail.sh upgrade-local
卸載Logtail
各地域?qū)?yīng)的${region_id}
請(qǐng)參見(jiàn)開(kāi)服地域,例如華東 1(杭州)對(duì)應(yīng)的${region_id}
為cn-hangzhou
。
根據(jù)日志服務(wù)Project所在地域,獲取對(duì)應(yīng)的${region_id}
。替換${region_id}
后,執(zhí)行卸載命令。
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall
適用場(chǎng)景
服務(wù)器與日志服務(wù)Project同賬號(hào)同地域
(推薦使用)日志服務(wù)借助運(yùn)維編排服務(wù)OOS,可實(shí)現(xiàn)在同地域ECS實(shí)例中自動(dòng)安裝Logtail。更多信息,請(qǐng)參見(jiàn)安裝Logtail(ECS實(shí)例)。
如自動(dòng)安裝不滿足需求,您也可根據(jù)本文手動(dòng)安裝Logtail。
服務(wù)器與日志服務(wù)Project同賬號(hào)不同地域
配置流程如下圖:
您需選擇公網(wǎng)安裝Logtail。然后在日志服務(wù)Project中創(chuàng)建機(jī)器組,并配置Logtail采集日志。更多信息,請(qǐng)參見(jiàn)采集主機(jī)文本日志。
若您通過(guò)阿里云內(nèi)網(wǎng)(經(jīng)典網(wǎng)絡(luò)、VPC)安裝Logtail,可通過(guò)修改ilogtail_config.json文件中的網(wǎng)絡(luò)參數(shù)進(jìn)行跨地域采集。
編輯
/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
服務(wù)器與日志服務(wù)Project不同賬號(hào)
此方法適用于服務(wù)器部署在其他阿里云賬號(hào)、其他云廠商環(huán)境或自建IDC中。配置流程如下圖:
您需選擇公網(wǎng)安裝Logtail,然后使用A賬號(hào)ID配置用戶標(biāo)識(shí),并配置用戶自定義標(biāo)識(shí)。然后在賬號(hào)A的日志服務(wù)Project中創(chuàng)建用戶自定義標(biāo)識(shí)機(jī)器組,并配置Logtail采集日志。更多信息,請(qǐng)參見(jiàn)采集主機(jī)文本日志、通過(guò)Logtail跨阿里云賬號(hào)采集日志。
常見(jiàn)問(wèn)題
如何判斷是否安裝Logtail成功?
您可以通過(guò)查看Logtail狀態(tài)確定是否已在目標(biāo)服務(wù)器上安裝Logtail。具體操作,請(qǐng)參見(jiàn)查看Logtail狀態(tài)。
安裝Logtail后,配置采集任務(wù)心跳失敗如何解決?
完成Logtail采集配置后,若出現(xiàn)心跳失敗的情況,可執(zhí)行如下命令查看Logtail版本,并進(jìn)行升級(jí)重試。
cat /usr/local/ilogtail/app_info.json
安裝Logtail后,采集數(shù)據(jù)發(fā)送失敗錯(cuò)誤碼及處理方法有哪些?
Logtail將采集到的日志聚合并發(fā)送到日志服務(wù)。如果數(shù)據(jù)發(fā)送失敗,Logtail自動(dòng)根據(jù)錯(cuò)誤信息決定重試或放棄發(fā)送,具體信息,請(qǐng)參見(jiàn)發(fā)送日志。