全部產品
Search
文件中心

Container Service for Kubernetes:通過Log Service採集ACK Edge叢集的容器日誌

更新時間:Sep 19, 2025

阿里雲Container Service Edge 版整合了Log Service,可以在建立ACK Edge叢集時啟用Log Service,快速採集ACK Edge叢集的容器日誌,包括容器的標準輸出以及容器內的文字檔。本文介紹如何使用Log Service採集邊緣容器的日誌資訊。

步驟一:啟用Log Service組件Logtail

可以在建立ACK Edge叢集時選中使用Log Service,啟用Logtail組件;也可以為已有ACK Edge叢集啟用Logtail組件。

建立叢集時啟用Logtail

  1. 登入Container Service管理主控台,在左側導覽列選擇叢集列表

  2. 叢集列表頁面單擊建立叢集

    以下僅介紹開啟Log Service的關鍵步驟。關於建立叢集的具體操作,請參見建立ACK Edge叢集

  3. 組件配置設定精靈中,選中使用Log Service

    當選中使用Log Service後,會出現建立專案(Project)的提示。關於Log Service管理日誌的組織圖,請參見專案(Project)。有以下兩種建立Project方式。

    • 單擊使用已有Project,選擇一個現有的Project來管理採集的日誌。 使用已有Project

    • 單擊建立新Project,自動建立一個新的Project來管理採集的日誌,Project會自動命名為k8s-log-{ClusterID},ClusterID是建立的ACK Edge叢集的唯一標識。 建立新Project

  4. 配置完成後,單擊右下角建立叢集,在彈出的視窗中單擊確認,完成建立。

    完成建立後,可在叢集列表頁面看到開啟了Logtail的ACK Edge叢集

為已有叢集啟用Logtail

  1. 登入Container Service管理主控台,在左側導覽列選擇叢集列表

  2. 叢集列表頁面,單擊目的地組群名稱,然後在左側導覽列,單擊組件管理

  3. 組件管理頁面單擊日誌與監控頁簽,定位logtail-ds組件。

    說明
    • 在ACK Edge >1.18.8-aliyunedge.1的版本中,日誌組件統一合并為logtail-ds。

    • 在ACK Edge ≤ 1.18.8-aliyunedge.1的版本中,日誌組件包含alibaba-log-controller和logtail-ds-docker兩部分。

  4. logtail-ds組件右側,單擊安裝,並在安裝組件對話方塊中單擊確認

    如果已安裝舊版本的Log Service組件,可以在組件右側,單擊升級

步驟二:建立應用時配置Log Service

可以在建立應用的同時配置Log Service,從而對ACK Edge叢集的日誌進行採集。

  1. 登入Container Service管理主控台,在左側導覽列選擇叢集列表

  2. 叢集列表頁面,單擊目的地組群名稱,然後在左側導覽列,選擇工作負載 > 無狀態

  3. 無狀態頁面上方的命名空間下拉框中設定命名空間,然後單擊頁面右上方的使用鏡像建立

  4. 應用基本資料頁簽,設定應用程式名稱副本數量類型,單擊下一步,進入容器配置頁面。

    以下僅介紹Log Service相關的配置。關於其他的應用配置,請參見建立無狀態工作負載Deployment

  5. 日誌配置地區,配置日誌相關資訊。

    1. 設定採集配置

      重要

      日誌採集配置完成後,不支援修改。如需修改,請通過DaemonSet-CRD方式採集容器日誌

      單擊採集配置,每個採集配置由日誌庫容器內日誌路徑兩項構成。

      • 日誌庫:配置Logstore名稱,用於指定所採集的日誌儲存於該Logstore。如果該Logstore不存在,ACK將會自動在叢集關聯的Log ServiceProject下建立相應的Logstore。

        說明

        新建立的Logstore中的日誌預設儲存時間為180天。

      • 容器內日誌路徑:指定希望採集的日誌所在的路徑,例如使用/usr/local/tomcat/logs/catalina.*.log來採集Tomcat的文本日誌。

        說明

        指定為stdout時,表示採集容器的標準輸出和標準錯誤輸出。

        每一項採集配置都會被自動建立為對應Logstore的一個採集配置,預設採用極簡模式(按行)進行採集。如果需要使用多行模式及更豐富的採集方式,請參見通過DaemonSet-控制台方式採集容器文本日誌通過DaemonSet-控制台方式採集容器標準輸出

      採集配置

    2. 設定自訂Tag

      單擊自訂Tag,每一個自訂Tag都是一個索引值對,會拼接到所採集到的日誌中,可以使用它來為容器的日誌資料進行標記,例如版本號碼。

      自訂tag

  6. 當完成所有配置後,可單擊右上方下一步進入後續流程。

    後續操作,可參見建立無狀態工作負載Deployment

步驟三:查看日誌

本例中查看通過控制台嚮導建立的tomcat應用的日誌。完成配置後,tomcat應用的日誌已被採集並儲存到Log Service中,可以在Log Service控制台查看容器日誌。操作步驟如下:

  1. 安裝成功後,進入Log Service控制台

  2. 在進入控制台後,在Project列表地區選取項目Kubernetes叢集對應的Project(預設為k8s-log-{Kubernetes叢集ID}),進入日誌庫列表頁簽。

  3. 在列表中找到相應的Logstore(採集配置中指定),將滑鼠懸浮在相應的Logstore名稱的右側,單擊button表徵圖,並單擊查詢分析

    本例中,在日誌查詢頁面,可以查看Tomcat應用的標準輸出日誌和容器內文本日誌,並可以發現自訂tag附加到日誌欄位中。

相關文檔