Podman Compose 日志配置与级别控制笔记

在 podman-compose 中，日志的管理涉及两个完全不同的层面：容器引擎层（Podman）负责控制日志文件的存储大小和数量；应用程序层（容器内软件）负责控制日志的输出级别（如隐藏 INFO，只记录 ERROR）。

一、 Podman 容器引擎层：日志存储配置

在 podman-compose.yml 中，logging 参数用于控制 Podman 驱动如何抓取并存储容器的 stdout（标准输出）和 stderr（标准错误）。它无法过滤日志内容，只能限制文件大小。

1. 核心语法结构

version: '3'
services:
  web:
    image: nginx:latest
    logging:
      driver: "k8s-file"
      options:
        max-size: "10m"
        max-file: "3"

2. 常用日志驱动（Driver）对比

max-file: 保留的历史文件最大数量（如 "3"） |
| journald | Linux 系统默认驱动。日志直接发送给系统的 systemd-journald 服务。 | 无需在 compose 中配置大小，由系统 /etc/systemd/journald.conf 统一管理。 |
| none | 彻底禁用该容器的日志，不占用任何磁盘空间。 | 无配置选项。 |

3. 注意事项

• 引号要求：在 options 中，max-size 和 max-file 的值必须加双引号（例如 "5m"，"3"），否则 YAML 解析器可能会报错。
• 驱动差异：Docker 默认使用 json-file，而 Podman 推荐使用 k8s-file。在 Podman 环境下明确写 k8s-file 兼容性最好。

二、 应用程序层：日志级别控制（只记录 ERROR）

podman-compose 的 logging 参数无法识别日志的级别。若要实现“不记录 INFO，只记录 ERROR”，必须通过 environment（环境变量）或 command（启动命令）将配置传递给容器内的软件，由软件自身控制输出。

不同的容器镜像，其环境变量和配置方式完全不同。以下为常见场景的配置方法：

1. 常见官方主流软件配置

• Redis
  通过启动命令参数调整：

  services:
  redis:
    image: redis:7
    command: redis-server --loglevel error
  

• MySQL / MariaDB
  通过特定环境变量限制控制台输出：

  services:
  db:
    image: mysql:8
    environment:
      - MYSQL_LOG_CONSOLE=ERROR
  

2. 常见编程语言与开发框架配置

• Java (Spring Boot)

  environment:
  - LOGGING_LEVEL_ROOT=ERROR      # 全局级别设为 ERROR
  - LOGGING_LEVEL_ORG_SPRINTFRAMEWORK=WARN
  

• Node.js (Express / NestJS / Winston)

  environment:
  - NODE_ENV=production          # 生产模式通常会自动关闭低级别日志
  - LOG_LEVEL=error              # 针对通用日志库
  

• Python (Django / Flask)

  environment:
  - PYTHONUNBUFFERED=1           # 确保日志实时输出
  - LOG_LEVEL=ERROR              # 需配合代码中的 os.environ.get('LOG_LEVEL') 生效
  

三、 替代规避方案

如果无法修改容器内应用程序的环境变量，可以使用以下两种替代方案：

1. 强行丢弃标准输出（stdout）

由于大部分软件的 INFO 日志通过 stdout 输出，ERROR 日志通过 stderr 输出，可以在 command 中将 stdout 重定向到 /dev/null。

services:
  nginx:
    image: nginx:latest
    command: nginx -g "daemon off;" 1>/dev/null

注意：此方法较为粗暴，若软件不规范将错误信息也输出到 stdout，会导致错误日志一同丢失。

2. 宿主机端利用 journalctl 过滤查看

若 logging.driver 设置为 journald，虽然所有日志都被记录在系统里，但在查看时可以只筛选错误日志：

journalctl CONTAINER_NAME=容器名 -p err