如何在Linux伺服器上安裝、升級和卸載Logtail - Simple Log Service

如果您要使用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作業系統
- 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、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執行個體所在地區，執行個體中繼資料介紹請參見執行個體中繼資料。
1. 通過公網下載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
```
2. 使用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

離線安裝
1. 在可以訪問公網的伺服器上下載安裝指令碼和安裝包。
  重要
  各地區對應的${region_id}請參見開服地區，例如華東 1（杭州）對應的${region_id}為cn-hangzhou。
  1. 根據Simple Log ServiceProject所在地區，擷取對應的${region_id}。替換${region_id}後，執行以下命令下載安裝指令碼。
    wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
  2. 根據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
2. 將安裝指令碼和安裝包拷貝至需要安裝Logtail的伺服器上。
3. 根據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
1. 在可以訪問公網的伺服器上下載安裝指令碼和安裝包。
  重要
  各地區對應的${region_id}請參見開服地區，例如華東 1（杭州）對應的${region_id}為cn-hangzhou。
  1. 根據Simple Log ServiceProject所在地區，擷取對應的${region_id}。替換${region_id}後，執行以下命令下載安裝指令碼。
```
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh
```
  2. 根據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
2. 將安裝指令碼和安裝包拷貝至需要安裝Logtail的伺服器上。
3. 在目標伺服器上執行升級命令。
```
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檔案中的網路參數進行跨地區採集。
1. 編輯/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"
    }
  ],
  ...
}
```
2. 設定檔修改後需重啟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自動根據錯誤資訊決定重試或放棄發送，具體資訊，請參見發送日誌。

Simple Log Service：安裝Logtail（Linux系統）

使用限制

安裝Logtail

線上安裝

阿里雲內網（傳統網路、VPC）

公網

傳輸加速

離線安裝

啟動和停止Logtail

查看Logtail狀態及版本

查看Logtail狀態

查看Logtail版本

升級Logtail

線上升級Logtail

離線升級Logtail

卸載Logtail

適用情境

伺服器與Log ServiceProject同帳號同地區

伺服器與Log ServiceProject同帳號不同地區

伺服器與Log ServiceProject不同帳號

常見問題