Docker 容器監控:資源、健康檢查與日誌

看懂 docker stats 的數值,分清健康檢查與重啟行為,設定日誌驅動與輪替,並掌握以 cAdvisor、Prometheus 或觀測雲持續收集資料的條件。

最佳實務
港口中排列的容器模組主題插畫

容器還在執行,不代表應用程式仍能回應請求。CPU 數值看起來偏高,得搭配工作內容解讀;網路累計值不斷增加,也無法直接說明目前的傳輸速率。資源統計、應用程式健康與日誌,各自回答不同的問題。

臨場查看可以用 docker stats 和 docker inspect,特定的應用程式檢查可用 HEALTHCHECK。要查歷史或設定告警,則需持續收集與儲存。指標可以走 cAdvisor、Prometheus 這條路,日誌還要另外設定收集管道與保留策略。

docker stats:臨場查看

以下以 Linux Docker Engine 為例,執行命令需要有權存取對應的 daemon:

docker stats                    # 預設顯示執行中容器的資源統計串流
docker stats web db             # 指定容器
docker stats --no-stream        # 取得一次快照

輸出包含 CPU%、記憶體用量與上限、網路 I/O、區塊 I/O,以及 PIDS。比較前要先確認各欄的口徑:

  • Linux 的 CPU% 可以超過 100%。 大約 100% 代表用滿一個邏輯 CPU,多個 CPU 平行處理時,數值可以更高。這並不是相對於容器 CPU 配額的使用率。
  • Linux CLI 的記憶體數值會扣除部分檔案快取。 因此不等於 API 回傳的總用量。現行文件使用 cgroup v1 的 total_inactive_file、v2 的 inactive_file;Docker 19.03 及更早版本使用的快取欄位不同。
  • NET I/O 與 BLOCK I/O 是累計位元組數。 它們不是每秒速率。計算速率時,需對同一計數器的相鄰樣本求差,再除以經過時間,並處理計數器重設。PIDS 也包含核心執行緒。

預設清單只顯示執行中的容器;--all 可以納入已停止容器,但停止中的容器不會提供即時資源資料。docker stats 官方說明

健康檢查

HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
  CMD curl -f http://localhost:8080/healthz || exit 1

檢查在容器內執行。這個範例需要映像檔內有 shell 和 curl,應用程式也必須在容器內的 8080 連接埠提供 /healthz,位址要依實際應用調整。docker ps 除了一般執行狀態,還會顯示 starting、healthy 或 unhealthy。單一端點通過檢查,不代表效能與業務處理正確性都已確認。HEALTHCHECK 指令

Compose 可透過 depends_on 的 condition: service_healthy,等相依服務健康後才啟動服務。只宣告相依順序不會等待就緒;相依服務在啟動後變成 unhealthy,也不會只因此自動重啟。健康狀態與主行程退出是不同條件。Compose 啟動順序

Kubernetes 不使用映像檔中的 Docker HEALTHCHECK,應在 Pod 規格中設定探針。liveness 或 startup 探針達到失敗門檻後,kubelet 會終止對應容器,再依重啟策略處理。readiness 失敗則讓 Pod 不再作為已就緒的服務端點,不會因此重啟容器。三種探針不是同一種自動替換 Pod 的開關。Kubernetes 探針行為

日誌分析

docker logs --tail 100 -f web
docker logs --since 10m web

這些命令讀取容器標準輸出與標準錯誤中,仍可取得的日誌,不會自動讀取應用程式寫在容器任意路徑的檔案。能否本機查詢也取決於驅動:json-file、local、journald 支援讀取;不支援讀取的遠端驅動,通常依靠 Docker 的 dual logging 本機快取。停用這份快取後,docker logs 可能回報不支援讀取。已被輪替刪除的紀錄,也無法用 --since 找回。docker logs · dual logging

Docker 預設使用 json-file,但不會預設輪替。繼續使用時,應設定 max-size、max-file,避免日誌占滿磁碟。例如,把以下內容合併到 daemon 既有的日誌設定:

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

選項值必須是字串。daemon 預設設定變更需重啟 Docker Engine 才會生效,且只套用到之後新建的容器;既有容器不會自動繼承。Docker 官方也建議在適合的情況下使用預設會輪替的 local 驅動。不過,它的儲存格式不同,不能直接套用 JSON 檔案收集規則。日誌驅動設定 · json-file 輪替選項

需要跨容器查詢時,可使用觀測雲 DataKit 容器採集器(簡體中文文件),在支援的 Docker 環境收集容器指標、物件與標準輸出日誌。純 Docker 環境應依官方文件在主機部署 DataKit,設定可存取的執行階段端點,通常是 unix:///var/run/docker.sock,並確認日誌路徑與讀取權限。不要假設每種驅動都產生可讀的 JSON 檔案,也不要自行改寫或輪替 Docker 管理的檔案。

應用程式寫在獨立檔案中的日誌,需透過可存取的磁碟區路徑與 DataKit 日誌收集設定(簡體中文文件)接入。保留實際收集到的容器 ID、服務、環境等識別資訊,再按同一服務與時間範圍查重啟前後的錯誤。容器重建後 ID 會變,舊紀錄能否查到,取決於先前是否收集,以及保留策略是否仍涵蓋那段時間。已刪除且未收集的日誌,不會因接上平台而恢復。

常見問題

docker stats 的資料能保留歷史嗎?

命令本身不會建立可長期查詢的歷史。要看趨勢,應持續收集到時序監控後端;docker stats 主要用於臨場查看。

已有 Prometheus 體系時,cAdvisor 可以收集容器資源統計,透過 /metrics 提供 Prometheus 擷取。部署時要依環境設定主機目錄掛載、執行階段存取與所需權限。container_cpu_usage_seconds_total 是累計 CPU 時間,計算 CPU 使用速率時需取 rate;container_memory_working_set_bytes 是當前 working set,不能直接當成應用程式堆積記憶體用量,或認為它與 Docker CLI 記憶體欄完全相同。

使用 id、可取得的 name、image,以及實際公開的容器標籤區分對象。限制不必要的標籤,避免重建後混淆身分,或讓序列數持續膨脹。cAdvisor 提供收集與指標端點,長期保留、查詢與告警還需在 Prometheus 等後端設定;它不會替你彙整應用程式日誌。cAdvisor 指標 · 執行與標籤選項

健康檢查失敗會自動重啟嗎?

獨立 Docker 容器只會被標記為 unhealthy。--restart 處理主行程退出等重啟條件,不會只因 unhealthy 就重啟。Swarm 服務可在工作健康檢查失敗後建立替代工作,但仍受服務設定與排程條件限制;Kubernetes 則依自己的 liveness/startup 探針與容器重啟策略處理,readiness 失敗不會觸發重啟。告警和受控復原流程要配合實際部署方式。Docker 重啟策略 · Swarm 工作生命週期

為什麼容器內與主機看到的 CPU 數值不同?

可能是範圍與分母不同。主機總 CPU、容器配額、CPU 親和性與邏輯 CPU 數,是不同的口徑。cgroup 設定會影響容器看到的資源;較舊的 JDK 或執行環境可能未正確認出配額,進而影響執行緒池大小。是否支援 cgroup v1/v2 與配額,應確認實際執行環境、版本和設定,不能只憑「在容器裡執行」判斷。Docker 資源限制 · JDK 容器支援選項

官方參考

本文依官方文件整理,未實際執行文中的範例。正式部署前,需依使用版本、權限與實際負載確認。

延伸閱讀

取得專屬方案

聯絡我們

加入社群

微信扫码
加入官方交流群

立即體驗

在线开通,按量计费,真正的云服务!

立即開始

选择观测云版本

代码托管平台