compose本身不支持分布式日志集中管理，需集成外部系统：通过日志驱动（如fluentd、syslog）采集stdout/stderr，或sidecar模式用fluent bit等采集文件日志，同时注入元数据、限制日志大小并脱敏。
Compose 本身不直接支持分布式日志的集中收集与管理，它只是一个容器编排工具，用于定义和运行多容器应用。要实现日志集中收集，需在 Compose 编排基础上，**集成外部日志系统**，通过标准输出（stdout/stderr）采集、日志驱动配置、或容器内日志代理等方式，将各服务日志统一输送到中心化平台（如 ELK、Loki、Fluentd + Kafka + ES 等）。
利用 Docker 日志驱动对接中心日志系统
Docker 支持多种日志驱动（fluentd、syslog、gelf、awslogs 等），可在 docker-compose.yml 中为服务指定，让容器日志自动转发到对应后端：
- 使用
fluentd驱动时，确保 Fluentd 服务已部署并监听指定地址，然后在服务中添加：
logging:
driver: "fluentd"
options:
fluentd-address: "fluentd:24224"
fluentd-async-connect: "true"- 搭配
syslog驱动可对接 Logstash 或 Rsyslog；gelf适合发送到 Graylog。 - 注意：日志驱动作用于容器启动阶段，仅捕获 stdout/stderr，不处理应用写入文件的日志。
在容器内嵌入日志采集代理（Sidecar 模式）
当应用将日志写入本地文件（如 /var/log/app.log），或需要更灵活的日志过滤、解析、脱敏时，推荐采用 Sidecar 方式：为每个服务附加一个日志采集容器（如 Fluent Bit、Filebeat），共享日志卷：
- 在
docker-compose.yml中定义 volume 并挂载给主服务和采集器：
volumes:
- ./logs:/app/logs
services:
web:
image: my-web-app
volumes:
- ./logs:/app/logs
fluent-bit:
image: fluent/fluent-bit:2.2
volumes:
- ./logs:/app/logs
- ./fluent-bit.conf:/fluent-bit/etc/fluent-bit.conf
depends_on: [web]- Fluent Bit 读取共享目录中的日志文件，按配置解析后发往 Loki 或 Elasticsearch。
- 该方式对应用无侵入，支持多格式、多路径、标签注入（如 service_name、env）。
统一日志元数据与上下文增强
分布式环境下，仅靠日志内容难以定位问题。需在采集环节注入关键上下文，提升可追溯性：
- 通过 Compose 的
labels或环境变量传递服务名、版本、集群信息：
web:
image: nginx:alpine
labels:
- "com.example.service=api-gateway"
- "com.example.env=prod"
environment:
- SERVICE_NAME=api-gateway
- VERSION=1.2.0- Fluentd/Fluent Bit 可读取这些 label 或 env，并作为字段写入日志条目（如
service,version,host,container_id）。 - 结合 OpenTelemetry 日志导出器，还能关联 trace_id 和 span_id，实现日志-链路一体化排查。
日志生命周期管理与落盘策略
避免日志无限堆积影响磁盘和性能，需在 Compose 层面配合 Docker 引擎做基础治理：
- 设置容器日志大小限制和轮转策略（适用于 stdout 场景）：
logging:
driver: "json-file"
options:
max-size: "10m"
max-file: "3"- 对文件日志，由采集器控制读取偏移（Fluent Bit 的
db文件记录位置），并配合宿主机 logrotate 或云平台日志 TTL 策略清理旧文件。 - 敏感日志建议在采集器层做字段过滤或正则脱敏（如屏蔽 token、手机号），而非依赖应用层处理。
