docker events の使い方

できごとの記録を見る

書き方

docker events
docker events --since 30m
docker events --filter event=die
docker events --filter container=web --format '{{.Action}}'

コンテナの作成・起動・停止(die)・削除、イメージの pull などのできごとを時刻つきで表示します。本物は待ち続けるので Ctrl+C で止めます。

よく使うオプション

オプション意味
--since 時間その時間より後のできごとを出す(30m・1h・日時)
--until 時間その時間までで止める(付けないと待ち続ける)
-f event=dieできごとの種類で絞る(start・die・oom・kill・destroy・pull など)
-f container=名前コンテナで絞る
--format テンプレート出す形を決める({{.Action}}・{{.Actor.Attributes.name}} など)

例

$ docker events --since 1h --filter event=die2026-11-07T10:02:15.123456789Z container die 8b1e4d7c2a9f (exitCode=137, image=myapp, name=api)

この 1 時間に止まったコンテナを出します。exitCode で止まり方が分かります。

$ docker events --filter event=oom

メモリの上限を超えて止められたできごとを待ちます。起きたらすぐ表示されます。

$ docker events --since 30m --until 0s --filter container=web --format '{{.Time}} {{.Action}}'1794034650 kill
1794034650 die
1794034651 start

この 30 分の web のできごとを、時刻と種類だけで出して終わります。--until 0s で待ち続けずに終わります。

よくある間違い・注意

  • --until を付けないと新しいできごとを待ち続けます。Ctrl+C で止めます。
  • デーモンが覚えているできごとには限りがあります(最近の 256 件ほど)。古いことは journalctl -u docker で探します。

実際に打って練習する

Docker コースの Lv62「港の出来事帳 docker events」で覚えます(第8章 港の守り(本番運用))。ブラウザの中のシミュレーターで、本物と同じように打って確かめられます。

Lv1〜7 はログインすると無料で試せます(それより先はゴールド以上のプランで遊べます)。

Docker コマンド一覧(使い方と例)へ戻る