Docker 컨테이너(Container) 로그 조회

컨테이너를 실행시키고 나면,
그 컨테이너가 정상적으로 실행 중인지, 에러가 발생하진 않았는지 확인해야 합니다.
이때 필요한 것이 바로 로그(log) 입니다.

 

Docker에서는 각 컨테이너의 실행 결과를 로그 형태로 남기며,
이 로그를 통해 디버깅이나 모니터링을 할 수 있습니다.
지금부터 Docker 컨테이너 로그를 확인하는 방법을 알아보겠습니다.

 

 

컨테이너 로그 조회 기본 명령어

docker logs [컨테이너ID 또는 컨테이너이름]

예시 👇

docker run -d nginx
docker logs nginx

위 명령은 nginx 컨테이너의 전체 로그를 한 번에 출력합니다.

 

 

최근 로그만 조회하기

모든 로그가 아니라, 최근 일부 로그만 보고 싶다면
--tail 옵션을 사용할 수 있습니다.

docker logs --tail [표시할 줄 수] [컨테이너ID 또는 이름]

예시 👇

docker logs --tail 10 nginx

최근 10줄만 출력됩니다.
로그가 너무 많을 때 빠르게 확인할 때 유용합니다.

 

실시간 로그 확인하기

실행 중인 컨테이너의 로그를 실시간으로 모니터링하고 싶다면
-f 옵션을 사용합니다.

docker logs -f [컨테이너ID 또는 이름]

예시 👇

docker run -d -p 80:80 nginx
docker logs -f nginx​

 

 

기존 로그는 생략하고, 새로 생성되는 로그만 보고 싶을 때

기존 로그를 모두 출력하지 않고,
새로운 로그부터 실시간으로 확인하고 싶을 때는
--tail 0과 -f를 함께 사용합니다 👇

docker logs --tail 0 -f [컨테이너ID 또는 이름]

이 명령은 “지금 이후로 발생하는 로그만 실시간 출력”하도록 설정합니다.
장시간 실행되는 서비스의 실시간 로그 모니터링에 자주 사용됩니다.

 

 

정리하면

목적	명령어	설명
전체 로그 보기	docker logs [컨테이너 이름]	모든 로그 출력
최근 로그만 보기	docker logs --tail 10 [컨테이너 이름]	최근 10줄만 표시
실시간 로그 보기	docker logs -f [컨테이너 이름]	새 로그가 생길 때마다 실시간 출력
새로운 로그만 실시간 보기	docker logs --tail 0 -f [컨테이너 이름]	기존 로그 제외 후 새 로그만 표

컨테이너 로그를 보려면 docker logs,
실시간으로 보려면 docker logs -f
새 로그만 보려면 docker logs --tail 0 -f