Simple Log Service：安裝、運行、升級、卸載Logtail

安裝Logtail

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

#內網下載方式
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
#公網下載方式
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
#伺服器分布在海外各地的自建機房或者來自海外雲廠商，使用公網傳輸資料可能會出現網路延遲高、傳輸不穩定等問題，推薦選擇傳輸加速傳輸資料。
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
#內網方式安裝，適用於自建IDC已經打通內網的情況
chmod +x logtail.sh; ./logtail.sh install ${region_id}

#公網方式安裝
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. 在ECS 雲助手頁面右上方，單擊建立/執行命令。

4. 在建立執行命令面板中，命令內容輸入安裝命令（此處以公網安裝方式為例，更多安裝命令，請參見安裝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後，如何更新機器組配置？。

5. 在選擇執行個體地區，確認目標執行個體的Agent狀態是正常狀態（如果不是正常狀態，請參見安裝雲助手Agent，完成雲助手安裝。），選擇目標執行個體，單擊執行。然後執行狀態為成功執行。如果執行失敗，請參見查看執行結果及修複常見問題。

啟動和停止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-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組件進行更新，如果只更新部分組件（如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屬於不同的阿里雲帳號，請參考自建叢集卸載方式。

多個Kubernetes叢集如何共用一個Log ServiceProject？

如果您希望將多個叢集中的容器日誌採集到同一個Log ServiceProject中，安裝其他叢集Log Service組件時，將安裝參數中的設定與您第一次安裝叢集Log Service組件時保持一致。

如何查看Logtail日誌？

Logtail日誌儲存在Logtail容器中的/usr/local/ilogtail/目錄中，檔案名稱為ilogtail.LOG和logtail_plugin.LOG。

Logtail容器中的標準輸出並不具備參考意義，請忽略以下標準輸出內容。

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

如何查看Kubernetes叢集中Log Service相關組件的狀態？

執行如下命令進行查看。

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

alibaba-log-controller啟動失敗，該怎麼處理？

請確認您是否按照以下方式進行安裝。

• 在Kubernetes叢集的Master節點中執行安裝命令。

• 安裝命令參數中輸入的是您的叢集ID。

如果由於以上問題安裝失敗，請使用kubectl delete -f deploy命令刪除已產生的安裝模板並重新執行安裝命令。

如何查看Kubernetes叢集中Logtail-ds DaemonSet狀態？

執行kubectl get ds -n kube-system命令查看Logtail-ds DaemonSet狀態。

如何查看Logtail的作業記錄？

Logtail作業記錄儲存在/usr/local/ilogtail/目錄下，檔案名稱為ilogtail.LOG，輪轉檔案會壓縮儲存為ilogtail.LOG.x.gz。例如執行如下命令查看日誌。

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

如何重啟某個Pod中的Logtail？

1. 停止Logtail。

   其中logtail-ds-gb92k表示容器名，kube-system表示命名空間，請根據實際情況替換。

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop

2. 返回如下結果表示停止成功。

   kill process Name: ilogtail pid: 7
   kill process Name: ilogtail pid: 9
   stop success

3. 啟動Logtail。

   其中logtail-ds-gb92k表示容器名，kube-system表示命名空間，請根據實際情況替換。

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start

返回如下結果表示啟動成功。

ilogtail is running