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 はログインすると無料で試せます(それより先はゴールド以上のプランで遊べます)。