Docker Compose로 로그 실시간 확인하기

안녕하세요! 오늘은 Docker Compose를 사용할 때 컨테이너 로그를 실시간으로 확인하는 방법에 대해 알아보겠습니다.

![](/images/Pasted image 20250403180032.png)

문제 상황

Docker Compose로 컨테이너를 실행한 후 로그를 바로 확인하지 못한다면 어떻게 해야 할까요? 컨테이너가 정상적으로 시작되었는지, 오류는 없는지 실시간으로 확인해야 할 때가 많습니다.

bash

docker compose up

이 명령어로 컨테이너를 실행했다면, 로그는 어떻게 확인할 수 있을까요?

Docker Compose에서는 -f 또는 --follow 옵션을 사용하여 로그를 실시간으로 확인할 수 있습니다.

bash

docker compose logs -f

이 명령어는 모든 컨테이너의 로그를 실시간으로 스트리밍해 보여줍니다. 새로운 로그가 생성될 때마다 터미널에 바로 출력됩니다.

여러 서비스가 함께 실행 중이라면 특정 서비스의 로그만 확인하고 싶을 수 있습니다. 이럴 때는 서비스 이름을 명시하면 됩니다.

bash

docker compose logs -f [서비스_이름]

예를 들어, 'web' 서비스의 로그만 보고 싶다면:

bash

docker compose logs -f web

'database' 서비스의 로그만 보고 싶다면:

bash

docker compose logs -f database

로그 확인을 종료하려면 Ctrl+C를 누르면 됩니다. 이렇게 하면 로그 스트리밍은 중단되지만 컨테이너는 계속 실행됩니다.

로그 확인 시 유용한 추가 옵션들도 있습니다:

--tail=[숫자]: 각 컨테이너의 마지막 n줄만 표시합니다.

bash
1docker compose logs --tail=100 -f
--timestamps 또는 -t: 각 로그 메시지에 타임스탬프를 표시합니다.

bash
1docker compose logs -f -t

처음부터 컨테이너를 백그라운드에서 실행하고 싶다면 -d 옵션을 사용할 수 있습니다:

bash

docker compose up -d

그런 다음 로그를 확인하려면:

bash

docker compose logs -f

Docker Compose로 개발할 때 로그 확인은 필수적인 작업입니다. 실시간 로그를 확인하면 애플리케이션의 동작 상태를 쉽게 모니터링할 수 있습니다. 특히 여러 서비스가 연동되는 환경에서는 더욱 유용합니다.

이 간단한 팁이 Docker Compose 작업에 도움이 되길 바랍니다!