容器与云原生 / 系统课时

查看 Docker 守护进程日志

查看 Docker 守护进程日志

容器异常不一定来自容器内部。创建容器失败、存储驱动报错、网络初始化失败或运行时异常时,应同时查看 Docker 守护进程日志、容器事件和服务信息,把“发生了什么”与“哪个底层组件出错”对应起来。

学习目标

  • 能在使用 systemd 的 Linux 主机上读取 Docker 服务日志
  • 能用 docker events 还原容器和镜像对象的近期事件
  • 能结合 docker info 与 containerd 日志区分 Docker Engine、存储驱动和运行时问题

先区分三类观测信息

journalctl 读取的是 dockerd 服务日志,适合看启动失败、存储驱动、网络和守护进程级错误;docker events 是 Engine 暴露的对象事件流,适合回答“哪个容器在什么时候 start、die、destroy”;docker info 则给出当前守护进程配置与存储驱动信息。

Docker 守护进程日志与事件的观测关系

本文命令以使用 systemd 的 Linux 主机为主。Docker Desktop 也可继续使用 docker events 和 docker info,但 Engine 服务日志由 Desktop 自身管理,不能把 Linux 的 journalctl -u docker.service 原样套用。

查看 dockerd 最近日志

先读取最近 30 分钟的 Docker 服务日志,避免被长期历史信息淹没。--no-pager 便于复制和搜索结果。

bash
sudo journalctl -u docker.service --since "30 min ago" --no-pager

预期输出:

text
<TIME> <VALUE> dockerd[<PID>]: <VALUE>
<TIME> <VALUE> dockerd[<PID>]: <VALUE>

实际日志文本取决于主机状态。重点搜索 error、failed、storage、overlay、network、containerd 等关键词,并优先关注故障发生时间附近的记录。

需要在复现问题时实时观察,可使用跟随模式;它会持续输出,按 Ctrl+C 结束。

bash
sudo journalctl -fu docker.service

预期输出:

text
<TIME> <VALUE> dockerd[<PID>]: <NEW_MESSAGE>

用事件流还原对象发生了什么

服务日志告诉你底层错误,事件流更适合确认某个容器是否经历了 create、start、die、kill 或 destroy。下面查看最近 10 分钟到当前时刻的容器事件。

bash
docker events --since 10m --until 0s --filter type=container

预期输出:

text
<TIME> container <ACTION> <ID> (<VALUE>)

如果应用报告“容器突然退出”,而事件中同时出现 die,就能先确认退出确实发生在 Engine 层;接下来再结合容器日志、退出码和同一时刻的 dockerd 日志判断原因。若完全没有对应事件,则要检查是否连到了错误的 Docker context 或错误主机。

确认存储驱动和 Docker 根目录

存储相关异常需要知道当前 Engine 使用的驱动和数据根目录。下面只输出排障最常用的三个字段。

bash
docker info --format 'ServerVersion={{.ServerVersion}}'
docker info --format 'StorageDriver={{.Driver}}'
docker info --format 'DockerRootDir={{.DockerRootDir}}'

预期输出:

text
ServerVersion=<VALUE>
StorageDriver=<VALUE>
DockerRootDir=<PATH>

如果 dockerd 日志出现 overlay、snapshot、mount 或磁盘错误,就应把这些日志与 StorageDriver、DockerRootDir 所在文件系统的容量和内核错误一起检查。不要仅凭一条 no space 就清理镜像,先确认真正耗尽的是 Docker 根目录、容器挂载卷还是其他分区。

怀疑运行时时继续看 containerd

Docker Engine 通常通过 containerd 管理容器生命周期。若 dockerd 日志明确指向 containerd、shim 或 runtime,继续查看同一时间窗口的 containerd 服务日志。

bash
sudo journalctl -u containerd.service --since "30 min ago" --no-pager

预期输出:

text
<TIME> <VALUE> containerd[<PID>]: <VALUE>

排查时把三个时间线对齐:docker events 确认对象何时发生状态变化,dockerd 日志解释 Engine 层发生了什么,containerd 日志补充运行时细节。只要先锁定同一个故障时间点,再逐层下钻,就能避免在容器日志、守护进程日志和宿主机日志之间无目的地来回搜索。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查看 Docker 守护进程日志

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通