Dockerのログ運用設計｜loggingドライバとjson-fileローテーションで肥大化を防ぐ方法

この記事のポイント

・max-size/max-fileでログローテーションを設定できる
・daemon.jsonで全コンテナに一括設定を適用できる
・docker-compose.ymlのloggingセクションで個別設定できる
・本番環境ではjournaldやsyslogへの転送も検討する

# コンテナIDごとのログサイズを確認する
$ sudo du -sh /var/lib/docker/containers/*/
4.0K    /var/lib/docker/containers/2a3b4c5d6e7f8901.../
2.3G    /var/lib/docker/containers/a1b2c3d4e5f60789.../
128M    /var/lib/docker/containers/c7d8e9f0a1b2c3d4.../

# daemon.jsonの存在を確認する（存在しない場合は新規作成する）
$ ls -la /etc/docker/daemon.json
ls: cannot access '/etc/docker/daemon.json': No such file or directory

# /etc/docker/daemon.json を作成してローテーション設定を記述する
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "100m",
    "max-file": "3"
  }
}

# daemon.jsonの設定を反映させる
$ sudo systemctl daemon-reload
$ sudo systemctl restart docker

# 設定が反映されたか確認する
$ docker info | grep -A 4 "Logging Driver"
 Logging Driver: json-file
  log-opts:
   max-file: 3
   max-size: 100m

# ログローテーションを個別設定してコンテナを起動する
$ docker run -d \
    --name webapp \
    --log-driver json-file \
    --log-opt max-size=50m \
    --log-opt max-file=5 \
    nginx:latest

# 設定が反映されているか確認する
$ docker inspect webapp --format='{{json .HostConfig.LogConfig}}'
{"Type":"json-file","Config":{"max-file":"5","max-size":"50m"}}

# docker-compose.yml でのlogging設定例
services:
  web:
    image: nginx:latest
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
        max-file: "3"
  db:
    image: mysql:8.0
    logging:
      driver: "json-file"
      options:
        max-size: "50m"
        max-file: "5"

# journaldドライバでコンテナを起動する
$ docker run -d \
    --name webapp \
    --log-driver journald \
    nginx:latest

# journalctlでコンテナのログを確認する
$ journalctl CONTAINER_NAME=webapp -f
Jul 08 10:23:45 web-server01 a1b2c3d4[1234]: 172.17.0.x - - [08/Jul/2026:10:23:45 +0900] "GET / HTTP/1.1" 200 615

# コンテナのログをリアルタイム表示する（tail -fと同じ感覚）
$ docker logs -f webapp

# 最新100行だけ表示する
$ docker logs --tail 100 webapp

# タイムスタンプ付きで表示する
$ docker logs -t webapp

# 特定の日時以降のログを表示する（ISO 8601形式）
$ docker logs --since "2026-07-01T00:00:00" webapp
2026-07-01T00:00:12.345Z stderr F 172.17.0.x - - [01/Jul/2026:09:00:12 +0900] "GET / HTTP/1.1" 200 615

# docker-compose環境で複数サービスのログを一度に確認する
$ docker compose logs -f --tail 50

# Dockerのディスク使用状況をサマリー表示する
$ docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          12        5         4.2GB     2.1GB (50%)
Containers      8         3         2.4GB     1.9GB (79%)
Local Volumes   3         2         512MB     128MB (25%)
Build Cache     0         0         0B        0B

# コンテナごとのサイズ詳細を確認する（SIZEにログが含まれる）
$ docker ps -s --format "table {{.Names}}\t{{.Size}}"
NAMES      SIZE
webapp     2.3GB (virtual 3.1GB)
db         128MB (virtual 512MB)
cache      4.0MB (virtual 256MB)

# コンテナを停止・削除してログをクリアする
$ docker stop webapp
webapp
$ docker rm webapp
webapp

# ローテーション設定を付けて再起動する
$ docker run -d \
    --name webapp \
    --log-driver json-file \
    --log-opt max-size=100m \
    --log-opt max-file=3 \
    nginx:latest

# 停止済みコンテナ・未使用イメージ・キャッシュを一括削除する（本番実行前に内容を必ず確認すること）
$ docker system prune
WARNING! This will remove:
  - all stopped containers
  - all networks not used by at least one container
  - all dangling images
  - all dangling build cache
Are you sure you want to continue? [y/N] y
Total reclaimed space: 2.15GB

# journalのディスク使用量を確認する
$ journalctl --disk-usage
Archived and active journals take up 1.2G in the file system.

# 500MB以上のジャーナルを削除する
$ sudo journalctl --vacuum-size=500M
Vacuuming done, freed 768.0M of archived journals from /var/log/journal.