：Logtail安裝採集快速入門

DaemonSet模式

• 在DaemonSet模式中，Kubernetes叢集確保每個節點（Node）只運行一個Logtail容器，用於採集當前節點內所有容器（Containers）的日誌。

• 當新節點加入叢集時，Kubernetes叢集會自動在新節點上建立Logtail容器；當節點退出叢集時，Kubernetes叢集會自動銷毀當前節點上的Logtail容器。通過DaemonSet的自動擴縮容機制以及標識型機器組，無需您手動管理Logtail執行個體。

Sidecar模式

• 在Sidecar模式中，每個容器組（Pod）運行一個Logtail容器，用於採集當前容器組（Pod）所有容器（Containers）的日誌。不同Pod的日誌採集相互隔離。

• 為了採集同一Pod中其他容器的記錄檔，需要通過共用儲存卷的方式來完成，即將同一份儲存卷分別掛載到業務容器和Logtail容器。關於Sidecar方式採集容器日誌的更多資訊，請參見Sidecar日誌採集介紹和Sidecar模式樣本。儲存卷的更多資訊，請參見儲存基礎知識。

容器發現

• Logtail容器採集其他容器的日誌，必鬚髮現和確定哪些容器正在運行，這個過程稱為容器發現。在容器發現階段，Logtail容器不與Kubernetes叢集的kube-apiserver進行通訊，而是直接和節點上的容器運行時守護進程（Container Runtime Daemon）進行通訊，從而擷取當前節點上的所有容器資訊，避免容器發現對叢集kube-apiserver產生壓力。

• Logtail支援通過Namespace名稱、Pod名稱、Pod標籤、容器環境變數等條件指定或排除採集相應容器的日誌。

容器檔案路徑映射

在Kubernetes叢集中，因為Pod之間資源隔離，Logtail容器無法直接存取其他Pod中的容器的檔案。但是，容器內的檔案系統都是由宿主機的檔案系統掛載形成，通過將宿主機根目錄所在的檔案系統掛載到Logtail容器，就可以訪問宿主機上的任意檔案，從而間接採集業務容器檔案系統的檔案。容器內檔案路徑與宿主機檔案路徑之間的關係被稱為檔案路徑映射。

記錄檔在當前容器內的路徑是/log/app.log，假設映射後的宿主機路徑是/var/lib/docker/containers/<container-id>/log/app.log。Logtail預設將宿主機根目錄所在的檔案系統掛載到自身的/logtail_host目錄下，因此Logtail實際採集的檔案路徑為/logtail_host/var/lib/docker/containers/<container-id>/log/app.log。

容器運行時支援

• 支援引擎：

  • Docker

  • Containerd

• 儲存驅動限制（僅Docker）：

  • 只支援Overlay、Overlay2。

  • 其他驅動：若使用非Overlay驅動，需將日誌目錄通過資料卷掛載為臨時目錄。

儲存卷掛載方式

如果NAS以PVC的方式掛載到資料目錄。

• 禁止使用：DaemonSet部署Logtail。

• 推薦使用：

  • 採集叢集文本日誌(Sidecar)：每個Pod部署獨立Logtail容器

    適用情境：高隔離性需求、多租戶環境。

記錄檔路徑規範

• 禁止使用軟連結：

  • 錯誤配置：/var/log/app -> /mnt/nas/logs。

  • 正確配置：直接使用實體路徑 /mnt/nas/logs。

• 掛載路徑匹配規則：

  如果業務容器的資料目錄通過資料卷（Volume）掛載， 採集路徑必須≥掛載點路徑。

  樣本：

  1掛載點：/var/log/service
  2✅ 有效採集路徑：/var/log/service 或 /var/log/service/subdir
  3❌ 無效採集路徑：/var/log （路徑過短）

容器停止時的Tlog