如果您要使用Simple Log ServiceProject採集伺服器日誌,首先需要安裝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作業系統(2.0以上版本的Logtail需要glibc2.6及以上版本)
CPU支援sse4_2和avx指令集(2.0以上版本的Logtail)
支援如下版本的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
請根據適用情境,選擇不同網路類型對應的安裝命令進行安裝,網路類型指Simple Log ServiceProject從伺服器採集日誌資料的網路連接方式。更多資訊,請參見選擇網路。
安裝Logtail後,如果ECS的網路由傳統網路切換至VPC,則需要更新Logtail配置。更多資訊,請參見ECS傳統網路切換為VPC後,如何更新Logtail配置。
線上安裝
網路類型
適用情境
阿里雲內網
Elastic Compute Service執行個體和Log ServiceProject屬於同一地區。
公網
Elastic Compute Service執行個體和Log ServiceProject屬於不同地區。
伺服器為其他雲廠商伺服器或自建IDC。
傳輸加速
伺服器分布在海外各地的自建機房或者來自海外雲廠商,使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題,推薦選擇傳輸加速傳輸資料。
說明線上安裝時,將根據伺服器系統自動匹配安裝對應的Logtail,無需進行手動選擇。
阿里雲內網(傳統網路、VPC)
未確定ECS執行個體所在地區
通過公網下載Logtail安裝指令碼,然後使用auto參數進行安裝。在安裝命令中指定auto參數後,Logtail安裝指令碼自動擷取ECS執行個體中繼資料,確定ECS執行個體所在地區,執行個體中繼資料介紹請參見執行個體中繼資料。
通過公網下載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
使用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安裝指令碼,不消耗公網流量。
公網
根據Simple Log ServiceProject所在地區,擷取對應的
${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
傳輸加速
根據Simple Log ServiceProject所在地區,擷取對應的
${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
離線安裝
在可以訪問公網的伺服器上下載安裝指令碼和安裝包。
重要各地區對應的
${region_id}
請參見開服地區,例如華東 1(杭州)對應的${region_id}
為cn-hangzhou
。根據Simple Log ServiceProject所在地區,擷取對應的
${region_id}
。替換${region_id}
後,執行以下命令下載安裝指令碼。wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
根據Simple Log ServiceProject所在地區,擷取對應的
${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
將安裝指令碼和安裝包拷貝至需要安裝Logtail的伺服器上。
根據Simple Log ServiceProject所在地區,擷取對應的
${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配置資訊自動選擇合適的方式進行升級。
根據Simple Log ServiceProject所在地區,擷取對應的
${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
在可以訪問公網的伺服器上下載安裝指令碼和安裝包。
重要各地區對應的
${region_id}
請參見開服地區,例如華東 1(杭州)對應的${region_id}
為cn-hangzhou
。根據Simple Log ServiceProject所在地區,擷取對應的
${region_id}
。替換${region_id}
後,執行以下命令下載安裝指令碼。wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
根據Simple Log ServiceProject所在地區,擷取對應的
${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
將安裝指令碼和安裝包拷貝至需要安裝Logtail的伺服器上。
在目標伺服器上執行升級命令。
chmod +x logtail.sh; ./logtail.sh upgrade-local
卸載Logtail
各地區對應的${region_id}
請參見開服地區,例如華東 1(杭州)對應的${region_id}
為cn-hangzhou
。
根據Simple Log ServiceProject所在地區,擷取對應的${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
適用情境
伺服器與Log ServiceProject同帳號同地區
(推薦使用)Log Service藉助營運編排服務OOS,可實現在同地區ECS執行個體中自動安裝Logtail。更多資訊,請參見安裝Logtail(ECS執行個體)。
如自動安裝不滿足需求,您也可根據本文手動安裝Logtail。
伺服器與Log ServiceProject同帳號不同地區
配置流程如下圖:
您需選擇公網安裝Logtail。然後在Simple Log ServiceProject中建立機器組,並配置Logtail採集日誌。更多資訊,請參見採集主機文本日誌。
若您通過阿里雲內網(傳統網路、VPC)安裝Logtail,可通過修改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
伺服器與Log ServiceProject不同帳號
此方法適用於伺服器部署在其他阿里雲帳號、其他雲廠商環境或自建IDC中。配置流程如下圖:
您需選擇公網安裝Logtail,然後使用A帳號ID配置使用者標識,並配置使用者自訂標識。然後在帳號A的Simple Log ServiceProject中建立使用者自訂標識機器組,並配置Logtail採集日誌。更多資訊,請參見採集主機文本日誌、通過Logtail跨阿里雲帳號採集日誌。
常見問題
如何判斷是否安裝Logtail成功?
您可以通過查看Logtail狀態確定是否已在目標伺服器上安裝Logtail。具體操作,請參見查看Logtail狀態。
安裝Logtail後,配置採集任務心跳失敗如何解決?
完成Logtail採集配置後,若出現心跳失敗的情況,可執行如下命令查看Logtail版本,並進行升級重試。
cat /usr/local/ilogtail/app_info.json
安裝Logtail後,採集資料發送失敗錯誤碼及處理方法有哪些?
Logtail將採集到的日誌彙總並發送到Log Service。如果資料發送失敗,Logtail自動根據錯誤資訊決定重試或放棄發送,具體資訊,請參見發送日誌。