Docker的Google Cloud日志驱动未收集日志问题排查

这种只看到"ping"日志却收不到应用日志的情况，大多是Python输出缓冲或者日志驱动配置细节的问题，我给你梳理几个排查和解决步骤：

1. 先解决Python日志的缓冲坑 #

Python在非交互式环境（比如Docker容器）里，stdout默认是块缓冲的——也就是说日志不会实时输出到容器的标准输出，gcplogs自然抓不到内容。你可以通过两种方式解决：

• 启动Python时禁用缓冲：在运行命令里加上-u参数，比如Docker启动命令写成：

  docker run your-python-image python -u app.py
  

  或者直接在Dockerfile里修改CMD/ENTRYPOINT：

  CMD ["python", "-u", "app.py"]
  

• 在代码里强制日志刷新：给logging的StreamHandler加上实时刷新的设置，比如：

  import logging
  import sys
  
  # 配置日志输出到stdout
  handler = logging.StreamHandler(sys.stdout)
  handler.setLevel(logging.INFO)
  formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
  handler.setFormatter(formatter)
  
  # 关键：强制每次输出后刷新缓冲区
  handler.flush = sys.stdout.flush
  
  logger = logging.getLogger(__name__)
  logger.addHandler(handler)
  logger.setLevel(logging.INFO)
  

2. 先验证容器本地是否能看到日志 #

解决缓冲问题后，先确认容器自己的stdout有没有日志：

docker logs <你的容器ID/名称>

如果这里能看到应用日志，说明问题出在gcplogs驱动或者GCP同步环节；如果还是看不到，那得回头检查你的Python代码日志配置是否正确。

3. 检查Docker gcplogs驱动的配置细节 #

确保Docker daemon的配置文件（通常是/etc/docker/daemon.json）正确设置了gcplogs驱动，没有遗漏必要参数：

{
  "log-driver": "gcplogs",
  "log-opts": {
    "gcp-project": "你的GCP项目ID",
    "gcp-logging-enabled": "true"
  }
}

修改后记得重启Docker daemon：

sudo systemctl restart docker

另外，用docker inspect <容器ID>查看HostConfig.LogConfig字段，确认容器没有单独指定其他日志驱动，覆盖了全局配置。

4. 排查GCP权限与同步延迟 #

• 如果你的Docker运行在GCE实例上，要确保实例拥有logging.logWriter角色的权限，否则无法将日志推送到Stackdriver。
• Stackdriver日志偶尔会有1-5分钟的同步延迟，做完上述操作后可以稍等一会儿再去日志查看器刷新。

按这个顺序排查下来，基本就能解决只看到ping日志的问题了。

内容的提问来源于stack exchange，提问作者Layo