怎么通过 logging 指令在 Docker Compose 中统一定制日志输出格式指南-Docker-PHP中文网

docker compose 不处理日志格式化，仅透传 logging 配置给 docker 引擎；真正控制格式的是 logging driver（如 json-file、syslog、fluentd）及其选项，默认 json-file 输出固定 json 结构，无法通过 compose 直接定制显示格式。

怎么通过 logging 指令在 docker compose 中统一定制日志输出格式指南

理解 Docker Compose 的 logging 配置机制

Docker Compose 本身不处理日志格式化，它只是将日志配置透传给底层 Docker 引擎。真正控制日志输出格式的是 Docker 的 logging driver（如 json-file、syslog、fluentd 等）及其选项。默认使用 json-file，它把每条日志存为 JSON 对象，含 time、stream（stdout/stderr）、log 字段——但这个结构是固定的，无法通过 Compose 直接“定制显示格式”（比如加服务名、颜色或自定义字段）。

在 docker-compose.yml 中配置 logging driver 和选项

你可以在服务级别用 logging 键指定 driver 及其参数。常用且实用的组合是 json-file + max-size/max-file 控制轮转，或切换为 syslog / fluentd 做集中格式化：

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

限制本地日志体积（推荐）：避免磁盘被撑爆

logging:
  driver: "json-file"
  options:
    max-size: "10m"
    max-file: "3"

转发到 syslog（便于统一格式化）：

logging:
  driver: "syslog"
  options:
    syslog-address: "tcp://localhost:514"
    syslog-format: "rfc5424"

对接 Fluentd（支持自定义 tag 和 format）：

logging:
  driver: "fluentd"
  options:
    fluentd-address: "localhost:24224"
    fluentd-async-connect: "true"
    tag: "myapp.${SERVICE_NAME}.${HOSTNAME}"

真正实现“统一定制格式”的可行路径

想让日志终端输出带服务名、时间戳、颜色或结构化字段，需分层处理：

应用层打日志时主动添加上下文：在代码中用结构化日志库（如 Python 的 structlog、Go 的 logrus），注入 service_name、env 等字段，输出 JSON 日志。Docker 会原样保存，再由日志收集器解析渲染。
用 docker compose logs -f 配合外部工具美化：例如用 ccat 或 jq 实时解析 JSON 并高亮：
```
docker compose logs -f | jq -r 'select(.log) | "(.time | sub("\.\d+Z"; "Z")) [(.service)] (.log)"'
```
部署轻量日志代理（如 loki + promtail）：Promtail 可在采集时重写标签、提取字段、添加静态 label（如 job="myapp"），Loki 查询时按 service/time/group 展示，前端 Grafana 可自由排版。

避坑提醒：哪些“格式定制”在 Compose 中行不通

以下操作不会生效，别白费力气：

试图在 logging.options 里写 format: "text" 或 template —— json-file driver 不支持日志内容格式化。
期望 docker compose logs 默认显示服务名前缀 —— 它只显示容器名（如 web-1），不是服务名（web）。可用 --prefix（v2.20+）临时开启：docker compose logs --prefix，但仅限 CLI 输出，不改变日志文件内容。
在 environment 或 command 中改 stdout 格式 —— 容器内进程输出什么，Docker 就收什么；格式化必须发生在写入前（应用层）或读取后（展示层）。