日期：2025年 08月 30日

標籤： Docker Docker-Compose Container Ubuntu Linux cAdvisor

摘要：Docker

第一部分：cAdvisor 介紹 & 目的

Step 1：介紹 cAdvisor

cAdvisor 全名意為 Container Advisor (容器顧問)，屬於 Google 的Github開源，以下是來源於官方 Github 上的介紹：

cAdvisor (Container Advisor) provides container users an understanding of the resource usage and performance characteristics of their running containers. It is a running daemon that collects, aggregates, processes, and exports information about running containers. Specifically, for each container it keeps resource isolation parameters, historical resource usage, histograms of complete historical resource usage and network statistics. This data is exported by container and machine-wide.

簡要的說：專門用來收集容器的資訊，也記錄了每個容器的參數，100% 支援原生的 Docker 的 Container
標誌性的 Log 為貓頭鷹，並且當前版本雖然為 0.53 (通常認知 1.0 才為正式版)，但實際上已屬於穩定版本，版本號屬於開源者自定義。

Step 2：緒論：cAdvisor - 適合場景

如果需要監控 Docker 容器，並且 收集、處理和輸出運行中容器的性能指標，加上快速搭建、占用最小資源、Web UI 可控介面，那麼使用 cAdvisor 就很合適了

簡言之： cAdvisor 是針對單一機器，多機器架構下，無法全部監控。

Step 3：cAdvisor - 優點、缺點

依照適合場景可以延伸出 cAdvisor 的優點：

相對的，因為輕量化的關係，直接使用會有以下的缺點：

純粹用 cAdvisor 已具備監控容器的資源狀況，但如果需要長期資料、告警、趨勢分析等，仍需要搭配其他工具組合來呈現，例如： Prometheus + Grafana 的方式

Step 4：cAdvisor 完全開源、免費

cAdvisor 屬於開源軟體，並且可以用於商業用途，可以放心使用

第二部分：部署方式

Step 1：準備 docker-compose.yml

以下是 docker-compose.yml 檔案，從官方的 gcr.io/cadvisor/cadvisor:latest 下載最新的 image
並且我們的 WebUI 使用的是 6060 Port號

version: '3.8'

services:
  cadvisor:
    image: gcr.io/cadvisor/cadvisor:latest
    container_name: cadvisor
    ports:
      - "6060:8080"
    volumes:
      - /:/rootfs:ro
      - /var/run:/var/run:ro
      - /sys:/sys:ro
      - /var/lib/docker/:/var/lib/docker:ro
      - /dev/disk/:/dev/disk:ro
    privileged: true
    devices:
      - /dev/kmsg
    command:
      - '--housekeeping_interval=10s'
      - '--storage_duration=60m'
      - '--docker_only=true'

其中 command 是屬於指定的參數，更多的參數可以參考 cAdvisor Github

Step 2：複製檔案到 Ubuntu 主機

將 Step1. 的 docker-compose.yml 複製到遠端的機器上

Step 3：進行安裝

到對應目錄，並且輸入以下 Shell 指令

docker-compose up -d

Step 4：安裝完成 - 確認是否運行

可以輸入以下指令檢查容器是否運行

docker ps -a

或者是有安裝 Portainer 之類的容器管理工具，可以檢查

第三部分：DEMO 驗證成果

Step 1：登入 Web UI

接著可以依照安裝位置進行訪問，其中 192.168.51.93 是我的內部域名主機

http://192.168.51.93:6060

Step 2：檢視 CPU - 總覽

往下檢視 Web，可以觀察到 CPU 的總覽資訊與所有相關的 Process

Step 3：檢視 CPU - 圖表

並且也提供視覺化的檢視

Step 4：檢視 Container - 進入

cAdvisor 最重要的是檢視 Container (容器) 的 CPU / Memory 的使用狀況，因此：
回到最上方 -> 選擇 Containers ->

Step 5：檢視 Container - 選擇某一項

進入後會有 Container Name 與 Container Hash ID ，選擇其中一項

Step 6：檢視 Container - 圖片呈現

選擇某個容器後 -> 瀏覽頁面 -> 可以看動圖片會動態更新，會依照 –housekeeping_interval 的配置(當前範例為10秒)，進行 Duration 的變化。
至此，有了可靠可監控容器的輕量化工具

第四部分：遺留問題 - 未來解決方案

Step 1：遺留問題 - 無歷史保留 & 趨勢分析

單純用 cAdvisor 有個致命的缺點，在生產的維運環境中，不可能單靠 cAdvisor 做監控，因為缺少了歷史紀錄，以下說明：
進入 Ubuntu -> 輸入以下 Shell 指令 -> 重啟 cAdvisor

docker-compose down -v
docker-compose up -d

再回到容器檢視 CPU、Memory 會發現全被清除，這是因為 cAdvisor 只有將資料保存於記憶體中，並且保存時間有限制。
備註：cAdvisor 工具定位原因，基於輕量化的取捨，因此不保留長久資料

Step 2：未來解決方案 - 更完整的監控模式

若要完整收集歷史資料與趨勢分析，還需要 Prometheus + Grafana + cAdvisor 三者的結合
以下是結合時負責的功能：

Step 3：補充 - Prometheus + Grafana + cAdvisor 資料流說明

並且以下是各組件更詳細的處理內容：