Docker logs 标准输出/错误日志查看和管理

docker logs 是 Docker 提供的一个命令行工具，用于查看容器的 stdout/stderr 输出日志。

以下是一些常用的 docker logs 命令和日志管理的最佳实践

基本用法

# 查看指定容器的日志
docker logs <container_id_or_name>

# 实时查看日志（类似 tail -f）
docker logs -f <container_id_or_name>

# 显示最近的n条日志
docker logs --tail n <container_id_or_name>

# 显示指定时间之后的日志
docker logs --since "2023-01-01T12:00:00" <container_id_or_name>

# 显示指定时间范围内的日志
docker logs --since "2023-01-01T12:00:00" --until "2023-01-01T13:00:00" <container_id_or_name>

# 显示带时间戳的日志
docker logs -t <container_id_or_name>

Docker 容器的日志默认存储位置

/var/lib/docker/containers/<container-id>/<container-id>-json.log

这是一个 JSON 格式的文件，记录了容器 stdout/stderr 的所有输出。

🔍 你可以用 docker inspect <container> 查看日志路径，搜索 "LogPath" 字段。

docker ps 显示的是容器ID前12位

⏳ 日志保留时间：默认无限期，但可能被大小限制

Docker 不会自动按时间删除日志，但可以通过配置限制日志大小和文件数量，否则日志可能无限增长，占满磁盘。

日志驱动（Log Drivers）

Docker 支持多种日志驱动，可以在启动容器时通过 --log-driver 指定：

# 使用 json-file 驱动（默认）
docker run --log-driver=json-file --log-opt max-size=10m --log-opt max-file=3 your_image

# 使用 syslog 驱动
docker run --log-driver=syslog --log-opt syslog-address=tcp://192.168.0.42:514 your_image

# 使用 fluentd 驱动
docker run --log-driver=fluentd --log-opt fluentd-address=127.0.0.1:24224 your_image

# 使用 awslogs 驱动（发送到 AWS CloudWatch）
docker run --log-driver=awslogs --log-opt awslogs-region=us-west-2 --log-opt awslogs-group=my-log-group your_image

日志轮转和限制

为了防止日志文件占用过多磁盘空间，建议配置日志轮转：

# 在 docker run 时设置

docker run \
  --log-driver=json-file \
  --log-opt max-size=10m \
  --log-opt max-file=5 \
  your_image

# 或在 daemon.json 中全局设置

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

使用 Docker Compose 配置

version: '3'
services:
  app:
    image: your_app
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

当您在 Docker 中配置日志驱动时，docker run 命令行选项优先于 /etc/docker/daemon.json 文件中的设置。这意味着如果您在运行容器时通过 docker run 使用了 --log-driver 参数来指定日志驱动（例如 json-file），那么这个设置将会覆盖在 daemon.json 中为 Docker 守护进程全局设定的日志驱动配置。

Docker Compose 配置详解

基本语法

version: '3'
services:
  your_service_name:
    image: your_image
    logging:
      driver: "json-file"  # 指定日志驱动
      options:
        max-size: "10m"    # 日志文件最大大小
        max-file: "3"      # 保留的日志文件数量
        # 其他选项...

示例：使用 json-file 驱动

version: '3.8'
services:
  web:
    image: nginx:latest
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "5"
        # 可选：添加时间戳
        # labels: "env,service"
        # env: "os,platform"

示例：使用 syslog 驱动

version: '3.8'
services:
  app:
    image: your_app_image
    logging:
      driver: "syslog"
      options:
        syslog-address: "tcp://192.168.0.10:514"
        syslog-facility: "local7"
        tag: "myapp"

示例：使用 fluentd 驱动

version: '3.8'
services:
  backend:
    image: your_backend_image
    logging:
      driver: "fluentd"
      options:
        fluentd-address: "127.0.0.1:24224"
        fluentd-async-connect: "true"
        tag: "service.backend"

示例：使用 AWS CloudWatch Logs

version: '3.8'
services:
  api:
    image: your_api_image
    logging:
      driver: "awslogs"
      options:
        awslogs-region: "us-west-2"
        awslogs-group: "my-log-group"
        awslogs-stream: "api-service"

version: '3.8'
services:
  app:
    image: your_application_image
    logging:
      driver: "gelf"
      options:
        gelf-address: "udp://your_graylog_server_ip:12201"  # Graylog 服务器的地址和端口
        tag: "your_service_name"                            # 可选：为日志消息添加标签
        env: "prod,web"                                     # 可选：将环境变量包含在日志中
        # 添加其他选项...

# docker-compose.yml
version: '3.8'
services:
  app:
    image: nginx:alpine
    logging:
      driver: "gelf"
      options:
        gelf-address: "udp://<graylog-server-ip>:12201"
        tag: "web-app"
        env: "production"

示例：禁用日志记录

version: '3.8'
services:
  worker:
    image: your_worker_image
    logging:
      driver: "none"  # 完全禁用日志记录

支持的常用日志驱动

• json-file    默认驱动，将日志写入 JSON 格式文件
• syslog    将日志发送到 syslog 服务器
• journald    使用 systemd journal 记录日志
• gelf    Graylog Extended Log Format
• fluentd    将日志发送到 Fluentd
• awslogs    发送到 Amazon CloudWatch Logs
• splunk    发送到 Splunk
• none    禁用日志记录

重要提示

1. 优先级：Compose 文件中的日志配置会覆盖 daemon.json 的全局设置，但不会被 docker run 命令行参数覆盖（因为 Compose 本身生成运行命令）。
2. 版本要求：确保您的 docker-compose.yml 文件版本至少为 3 或更高。
3. 选项差异：不同日志驱动支持的 options 不同，请参考官方文档。
4. 查看日志：即使配置了日志驱动，您仍然可以使用 docker-compose logs [service] 命令查看日志输出。

通过在 Compose 文件中配置日志，您可以实现环境间的一致性，并将日志策略作为代码进行版本控制和管理。

Docker 日志 Docker 日志管理 Docker日志查看

https://blog.xqlee.com/article/2508221628407236.html