安裝、運行、升級、卸載Logtail

概述

Log ServiceLogtail的使用情境根據目標伺服器類型可分為以下兩類：

• 主機情境：適用於物理伺服器、Elastic Compute Service等傳統計算環境。

• 容器情境：基於Kubernetes容器化平台部署的業務情境。

請根據您的伺服器運行環境選擇對應的方案，不同情境的使用流程及配置要求存在差異。若混合實境世界部署，需分別完成對應環境的安裝配置。

主機情境

安裝Logtail

安裝Logtail有自動安裝與手動安裝兩種方式，若且唯若您使用的是ECS機器，且ECS與Project屬於同帳號同地區時，Log Service才支援自動安裝Logtail。否則請使用手動方式安裝Logtail。

#公網方式安裝
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
#伺服器分布在海外各地的自建機房或者來自海外雲廠商，使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題，推薦選擇傳輸加速傳輸資料。此方式不支援金融雲地區
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
#內網方式安裝，適用於自建IDC已經打通內網的情況
chmod +x logtail.sh; ./logtail.sh install auto

#公網方式安裝
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
#伺服器分布在海外各地的自建機房或者來自海外雲廠商，使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題，推薦選擇傳輸加速傳輸資料。此方式不支援金融雲地區
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

#公網方式安裝
.\logtail_installer.exe install ${region_id}-internet
#伺服器分布在海外各地的自建機房或者來自海外雲廠商，使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題，推薦選擇傳輸加速傳輸資料。此方式不支援金融雲地區
.\logtail_installer.exe install ${region_id}-acceleration

大量安裝Logtail

大量安裝Logtail有如下兩種方式：

• OOS編排：適合有許可權要求情境，並發度較高，適合大規模大量操作。具體請參考使用OOS大量安裝或升級Logtail。

• ECS雲助手功能：簡單易用，直接通過命令的方式執行臨時任務。具體操作步驟如下所示：

1. 登入ECS管理主控台。

2. 在左側導覽列，選擇營運與監控 > 雲助手。

3. 在頁面左側頂部，選擇目標資源所在的資源群組和地區。

4. 選擇您要安裝Logtail的ECS伺服器，並單擊發送命令。

5. 確認雲助手是線上狀態（如果不是線上狀態，請參見安裝雲助手Agent，完成雲助手安裝。），並單擊下一步。

6. 在指令碼編輯框中輸入安裝命令（此處以公網安裝方式為例，更多安裝命令，請參見安裝Logtail），並單擊執行。等待命令執行完成，然後在輸出欄查看結果，確認安裝成功。

   此處用到的安裝命令如下所示：

   #!/bin/bash
   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

   重要

   安裝Logtail後，如果ECS的網路由傳統網路切換至VPC，則需要更新Logtail配置。更多資訊，請參見ECS傳統網路切換為VPC後，如何更新Logtail配置。

查看Logtail狀態及版本

cat /usr/local/ilogtail/app_info.json

{
   "logtail_version" : "0.16.30",
}

{
    "logtail_version" : "1.0.0.0"
}

升級Logtail

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

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

.\logtail_installer.exe uninstall

容器情境

安裝Logtail組件

當您使用的是ACK叢集且叢集與Log Service屬於同一個阿里雲帳號時，參考ACK叢集安裝方式。若使用自建叢集或ACK叢集與Log Service屬於不同的阿里雲帳號，請參考自建叢集安裝方式。

查看Logtail狀態、版本及IP地址

• 運行如下命令，查看Logtail狀態。

  kubectl get po -n kube-system | grep logtail

  返回結果如下：

  NAME            READY     STATUS    RESTARTS   AGE
  logtail-ds-gb92k   1/1       Running   0          2h
  logtail-ds-wm7lw   1/1       Running   0          4d

• 運行如下命令，查看Logtail的版本號碼、IP地址等資訊。

  kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json

  返回結果如下：

  {
     "hostname" : "logtail-ds-gb92k",
     "instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
     "ip" : "192.0.2.0",
     "logtail_version" : "0.16.2",
     "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" : "2021-02-05 06:09:01"
  }

升級與復原Logtail

1. 在升級前，您需要對Logtail組件相關描述檔案進行備份。

   重要

   升級期間（數秒內），因Logtail容器重啟，可能出現少量資料被重複或丟失採集的情況。

   kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml
   kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml
   kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml
   kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml
   kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml

2. 請根據叢集情況選擇組件升級方式，當您使用的是ACK叢集且叢集與Log Service屬於同一個阿里雲帳號時，參考ACK叢集升級方式。若使用自建叢集或ACK叢集與Log Service屬於不同的阿里雲帳號，請參考自建叢集升級方式。

   ACK叢集升級方式

   自建叢集升級方式

   一般情況下，推薦您使用自動升級方式。如果您在logtail-ds的DaemonSet中或者在alibaba-log-controller的Deployment中修改過參數（例如環境變數），那麼為了使您的修改不被重設，請使用手動升級方式。

   自動升級

   手動升級

   升級Logtail latest版本

   重要

   自動升級會重設您在logtail-ds和alibaba-log-controller中手動修改的配置。

   1. 登入Container Service管理主控台。

   2. 在叢集列表頁面中，單擊目的地組群最右側的更多 > 營運管理 > 組件管理

   3. 在日誌與監控頁簽中，找到logtail-ds，然後單擊升級。

   4. 在升級組件對話方塊中，單擊確定。

      重要

      如果無法升級到最新版本的Logtail，說明您的Kubernetes叢集版本太舊。請先升級Kubernetes叢集或者使用手動升級方式。

      執行升級操作後，您可以在Container Service管理主控台上查看logtail-ds pod狀態。如果logtail-ds pod狀態都為running，表示升級成功。

   重要

   手動升級不會根據最新版本的Logtail組件更新您的配置，部分特性最佳化可能不可用。

   手動升級包括升級logtail-ds和alibaba-log-controller。一般情況下，您只需要升級logtail-ds即可擷取新版本Logtail提供的採集能力。當您需要擷取新版Logtail CRD方式的採集能力時，需要升級alibaba-log-controller。以下步驟以logtail-ds為例。

   1. 登入Container Service管理主控台。

   2. 在叢集列表頁面中，單擊目的地組群最右側的更多 > 營運管理 > 組件管理

   3. 選擇工作負載 > 守護進程集。

      說明

      當您要升級alibaba-log-controller時，請選擇工作負載 > 無狀態，然後在kube-system命名空間下，找到alibaba-log-controller，完成升級。

   4. 選擇命名空間為kube-system，然後單擊logtail-ds對應的編輯。

   5. 檢查如下環境變數是否存在。

      如果不存在ALIYUN_LOGTAIL_CONFIG、ALIYUN_LOGTAIL_USER_ID、ALIYUN_LOGTAIL_USER_DEFINED_ID這三個環境變數，可能是因為您的Logtail版本太舊，您可以提交工單諮詢升級方法。

   6. 單擊鏡像Tag對應的選擇鏡像Tag。

   7. 在鏡像Tag對話方塊中，單擊最新版本，然後單擊確定。

   8. 在頁面右側，單擊更新。

      執行升級操作後，您可以在Container Service管理主控台上查看logtail-ds pod狀態。如果logtail-ds pod狀態都為running，表示升級成功。

   由於Logtail latest版本對應的YAML檔案太舊，當您使用該版本時，升級和體驗新功能都可能遇到問題，推薦您升級到最新版本。操作步驟如下：

   1. 儲存已有的AliyunLogConfig CRD。

      請根據實際情況替換log-crds.yaml。

      kubectl get AliyunLogConfig -A -o yaml > log-crds.yaml

   2. 卸載logtail-ds組件。

      在阿里雲Container Service管理主控台的日誌與監控頁簽中，找到logtail-ds，然後單擊卸載。具體操作入口，請參見卸載Logtail。

   3. 安裝logtail-ds組件。

      在阿里雲Container Service管理主控台的日誌與監控頁簽中，找到logtail-ds，然後單擊安裝。具體操作入口，請參見安裝Logtail組件。

   4. 部署您已儲存的AliyunLogConfig CRD。

      請根據實際情況替換log-crds.yaml。

      kubectl apply -f  log-crds.yaml

   說明

   建議通過安裝最新Logtail組件進行更新，如果只更新部分組件（如logtail-ds、alibaba-log-controller）的鏡像版本號碼可能導致升級失敗。

   重新安裝Logtail組件，即可完成自動升級。具體操作，請參見安裝Logtail組件。

3. 如果您要復原到某個版本，可參考如下步驟。

   說明

   升級前備份的YAML檔案中包含不少冗餘資訊，需要您手動刪除後，才能用於恢複Logtail配置。您可以使用kubectl-neat工具完成此操作。需要刪除的欄位為metadata.creationTimestamp、metadata.generation、metadata.resourceVersion、metadata.uid和status。

   1. 根據業務需求判斷升級之後的新Logtail配置是否需要保留。

      如果不需要保留，則可以刪除升級之後的新Logtail配置。

   2. 刪除備份檔案中的冗餘資訊。

      cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml
      cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml
      cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml
      cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml
      cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml

   3. 應用精簡後的備份檔案，恢複Logtail配置。

      kubectl apply -f neat-logtail-ds.yaml
      kubectl apply -f neat-alibaba-log-controller.yaml
      kubectl apply -f neat-aliyunlogconfigs-crd.yaml
      kubectl apply -f neat-alibaba-log-configuration.yaml
      kubectl apply -f neat-aliyunlogconfigs-cr.yaml

卸載Logtail

請根據叢集情況選擇組件卸載方式，當您使用的是ACK叢集且叢集與Log Service屬於同一個阿里雲帳號時，參考ACK叢集卸載方式。若使用自建叢集或ACK叢集與Log Service屬於不同的阿里雲帳號，請參考自建叢集卸載方式。

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system

kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG

[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0