如何查看由Docker容器启动的子Docker容器的Python日志输出？

我有一个通过Docker Compose启动3个容器的应用，这3个容器的日志可正常输出至stdout。其中一个容器负责按需启动次级临时容器（任务完成后即终止），启动逻辑基于docker-py实现，但我无法查看这些次级容器的日志输出。

最初Docker Compose启动的容器也无法输出日志到stdout，我通过以下配置解决了该问题，现在已将相同配置应用到次级容器，但无效：

• 代码层面的日志配置：

self.logger = logging.getLogger(__name__)
level = logging.INFO
stream_handler = logging.StreamHandler(sys.stdout)
self.logger.setLevel(level)
formatter = logging.Formatter("%(asctime)s - %(name)s [%(levelname)s]: %(message)s")
stream_handler.setFormatter(formatter)
self.logger.addHandler(stream_handler)

• Dockerfile配置：

ENV PYTHONUNBUFFERED=1 

当前使用docker-py启动次级容器的代码：

network = self.docker_client.networks.get("service-daemon_default")
_ = self.docker_client.containers.run(
    image="default_image",
    detach=True,
    environment={
        "VENDOR_NAME": vendor,
        **self.settings.get("environment"),  # Redis相关配置，如主机、端口等
    },
    name=vendor.lower(),
    network=network.name,
    auto_remove=self.settings.get("auto_destroy_containers", True),
)

1. 先排查容器是否留存日志 #

你设置了auto_remove=True，容器终止后会被立即删除，导致无法通过docker logs命令查看日志。建议先将该参数改为False，待容器终止后执行docker logs <次级容器名>，确认日志是否实际生成。

2. 显式指定日志驱动 #

在启动容器时显式配置日志驱动为json-file（Docker默认驱动），确保日志被持久化：

network = self.docker_client.networks.get("service-daemon_default")
_ = self.docker_client.containers.run(
    image="default_image",
    detach=True,
    environment={
        "VENDOR_NAME": vendor,
        **self.settings.get("environment"),
    },
    name=vendor.lower(),
    network=network.name,
    auto_remove=self.settings.get("auto_destroy_containers", True),
    # 添加日志配置
    log_config={
        "type": "json-file",
        "config": {}
    }
)

3. 实时捕获或事后获取日志 #

如果需要实时查看次级容器的日志，可以调整启动参数并捕获输出：

• 前台运行并实时打印：

container = self.docker_client.containers.run(
    image="default_image",
    detach=False,  # 改为前台运行
    environment={
        "VENDOR_NAME": vendor,
        **self.settings.get("environment"),
    },
    name=vendor.lower(),
    network=network.name,
    auto_remove=False,
)
# 实时输出日志
for line in container.logs(stream=True):
    print(line.decode('utf-8').strip())

• 后台运行后获取日志：

container = self.docker_client.containers.run(
    image="default_image",
    detach=True,
    environment={
        "VENDOR_NAME": vendor,
        **self.settings.get("environment"),
    },
    name=vendor.lower(),
    network=network.name,
    auto_remove=False,
)
# 获取全部日志
print(container.logs().decode('utf-8'))

4. 确认环境变量生效 #

检查次级容器中PYTHONUNBUFFERED环境变量是否正确设置，可以在容器启动时添加打印逻辑，或者通过docker exec <容器名> echo $PYTHONUNBUFFERED验证。

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