容器与云原生 / 系统课时

收集与管理容器日志

收集与管理容器日志

本课属于配置与排障类内容,目标是建立可持续管理的容器日志方案。你将了解标准输出采集方式、Docker 日志驱动配置以及日志轮转策略,避免生产环境因日志失控影响服务。

学习目标

  • 理解容器日志的主要来源和采集方式。
  • 配置 Docker 日志驱动和文件轮转。
  • 为日志增加服务版本和请求上下文信息。

理解容器日志来源

容器最佳实践是让应用把日志输出到标准输出和标准错误,而不是写入容器内部文件。Docker 守护进程负责接收这些输出,再交给配置的日志驱动保存或转发。

日志中应包含能够定位问题的信息,例如服务名称、版本号、请求 ID 和时间戳。只有包含上下文的日志,才能在多个容器同时运行时快速关联一次请求。

容器日志采集链路示意图

配置 Docker 日志驱动

Docker 默认使用 json-file 日志驱动。生产环境中需要限制单个容器日志文件大小和数量,否则长期运行可能导致磁盘空间耗尽。可以在启动容器时指定日志轮转参数:

bash
docker run -d \
  --name web \
  --log-driver=json-file \
  --log-opt max-size=10m \
  --log-opt max-file=5 \
  nginx:latest

预期结果

text
<CONTAINER_ID>

该配置表示单个日志文件最大为 10MB,最多保留 5 个文件。超过限制后 Docker 会自动轮转旧日志。

查看和排查日志

日常排障时需要结合时间范围、实时跟踪和容器状态一起分析。只查看最新几行通常无法发现启动失败或异常重启原因。

bash
docker logs --tail 100 --since <TIME> -f web

预期输出

text
2026-08-10T05:00:00Z INFO request_id=<ID> server started
2026-08-10T05:00:05Z INFO request completed status=200

如果日志量较大,应优先进入集中日志系统检索,而不是直接读取所有容器输出。

管理生产日志策略

生产环境通常需要统一日志格式,并通过采集组件发送到集中存储。应用日志格式建议固定字段,例如时间、级别、服务名、版本、请求 ID 和消息内容。

常见管理策略包括:限制本地日志大小、设置保留周期、避免打印敏感信息、区分业务日志和调试日志。日志系统本身也需要监控容量和采集状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

收集与管理容器日志

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

登录哪都通