docker execコマンドでコンテナ内を調査・デバッグする方法｜docker logs・docker inspectの実践例も

この記事のポイント

・docker exec -it でコンテナ内のシェルにインタラクティブに接続できる
・docker logs -f でリアルタイムのコンテナログをtail感覚で追える
・docker inspect --format でIPアドレスや設定値を1行で取り出せる
・起動に失敗したコンテナはdocker startしてからexecでデバッグする

# 実行中のコンテナ一覧を確認する
$ docker ps
CONTAINER ID   IMAGE     COMMAND                  CREATED         STATUS         PORTS                  NAMES
a1b2c3d4e5f6   nginx     "/docker-entrypoint."   5 minutes ago   Up 5 minutes   0.0.0.0:8080->80/tcp   web-nginx

# コンテナにbashで入る（CONTAINER IDまたはNAMEを指定）
$ docker exec -it web-nginx bash

# コンテナ内のプロンプトに変わる
root@a1b2c3d4e5f6:/#

# bashがない場合はshを使う（Alpine系イメージで頻出）
$ docker exec -it alpine-container sh
/ #

# bashが入っているか事前に確認したい場合
$ docker exec alpine-container which bash

# コンテナ内のNginxバージョンを確認する
$ docker exec web-nginx nginx -v
nginx version: nginx/1.25.3

# コンテナ内の環境変数を確認する
$ docker exec web-nginx env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
NGINX_VERSION=1.25.3

# コンテナ内の設定ファイルを確認する
$ docker exec web-nginx ls /etc/nginx/conf.d/
default.conf

# コンテナ内のプロセス一覧を確認する
$ docker exec web-nginx ps aux
USER       PID %CPU %MEM    VSZ   RSS TTY      STAT START   TIME COMMAND
root         1  0.0  0.0   8972  3512 ?        Ss   10:05   0:00 nginx: master process nginx -g daemon off;
nginx       31  0.0  0.0   9424  2208 ?        S    10:05   0:00 nginx: worker process

$ docker exec -it stopped-container bash
Error response from daemon: Container stopped-container is not running

# 停止中も含めてコンテナを確認する（-aで停止中も表示）
$ docker ps -a
CONTAINER ID   IMAGE   COMMAND   CREATED      STATUS                    NAMES
b2c3d4e5f6a7   myapp   "..."     1 hour ago   Exited (1) 1 hour ago     myapp-debug

# コンテナを起動する
$ docker start myapp-debug

# 起動を確認してからexecでデバッグ
$ docker exec -it myapp-debug bash

# コンテナのログを全件表示する
$ docker logs web-nginx
10.0.0.1 - - [04/Jul/2026:10:05:23 +0000] "GET / HTTP/1.1" 200 615 "-" "curl/8.4.0" "-"
10.0.0.1 - - [04/Jul/2026:10:05:30 +0000] "GET /api/health HTTP/1.1" 404 153 "-" "Go-http-client/1.1" "-"

# リアルタイムでログを追いかける（-fオプション）
$ docker logs -f web-nginx

# 最後の20行だけ表示する（--tail）
$ docker logs --tail 20 web-nginx

# 特定の時刻以降のログだけ表示する（--since）
$ docker logs --since 2026-07-04T10:00:00 web-nginx

# タイムスタンプ付きで表示する（-t）
$ docker logs -t --tail 10 web-nginx
2026-07-04T10:05:23.341234567Z 10.0.0.1 - - [04/Jul/2026:10:05:23 +0000] "GET / HTTP/1.1" 200 615

# ログファイルに直接書いている場合はexecで確認する
$ docker exec web-nginx cat /var/log/nginx/access.log

# または exec でリアルタイム追跡する
$ docker exec -it web-nginx tail -f /var/log/nginx/access.log

# コンテナの詳細情報をJSON形式で表示する
$ docker inspect web-nginx
[
    {
        "Id": "a1b2c3d4e5f6...",
        "Created": "2026-07-04T10:00:00.000000000Z",
        "State": {
            "Status": "running",
            "Running": true,
            "Pid": 12345
        },
        "NetworkSettings": {
            "IPAddress": "172.17.0.2",
            "Ports": {
                "80/tcp": [{"HostIp": "0.0.0.0", "HostPort": "8080"}]
            }
        }
    }
]

# コンテナのIPアドレスだけ取得する
$ docker inspect --format '{{.NetworkSettings.IPAddress}}' web-nginx
172.17.0.2

# コンテナのステータスだけ確認する
$ docker inspect --format '{{.State.Status}}' web-nginx
running

# 環境変数の一覧を確認する
$ docker inspect --format '{{range .Config.Env}}{{.}}{{"
"}}{{end}}' web-nginx
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
NGINX_VERSION=1.25.3

# マウントポイントを確認する
$ docker inspect --format '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"
"}}{{end}}' web-nginx
/home/user/html -> /usr/share/nginx/html

# 公開ポートの確認
$ docker inspect --format '{{.NetworkSettings.Ports}}' web-nginx
map[80/tcp:[{0.0.0.0 8080}]]

# 全コンテナのリソース使用状況をリアルタイム表示（Ctrl+Cで停止）
$ docker stats
CONTAINER ID   NAME        CPU %   MEM USAGE / LIMIT   MEM %   NET I/O         BLOCK I/O
a1b2c3d4e5f6   web-nginx   0.01%   5.5MiB / 7.767GiB   0.07%   648B / 648B     0B / 0B
b2c3d4e5f6a7   myapp       12.5%   256MiB / 512MiB     50.0%   1.2MB / 834KB   120MB / 0B

# 特定のコンテナだけ確認する
$ docker stats web-nginx

# 一度だけ取得して終了する（スクリプトで使う場合）
$ docker stats --no-stream web-nginx
CONTAINER ID   NAME        CPU %   MEM USAGE / LIMIT    MEM %   NET I/O       BLOCK I/O
a1b2c3d4e5f6   web-nginx   0.01%   5.5MiB / 7.767GiB   0.07%   648B / 648B   0B / 0B

OCI runtime exec failed: exec: "bash": executable file not found in PATH: unknown

# bashがないAlpine系イメージではshを使う
$ docker exec -it alpine-container sh
/ #

# 停止中も含めてコンテナを確認する
$ docker ps -a
CONTAINER ID   IMAGE   COMMAND   CREATED       STATUS                    NAMES
c3d4e5f6a7b8   myapp   "..."     10 secs ago   Exited (127) 9 secs ago   myapp

# ログでエラーの原因を確認する
$ docker logs myapp
/bin/sh: /app/start.sh: not found

# 終了コードも確認できる
$ docker inspect --format '{{.State.ExitCode}}' myapp
127

# アプリのログファイルがある場所を探す
$ docker exec web-nginx find /var/log -name "*.log" -type f
/var/log/nginx/access.log
/var/log/nginx/error.log

# ログファイルの内容を確認する
$ docker exec web-nginx tail -20 /var/log/nginx/error.log