Docker2 min read

docker inspect로 컨테이너 로그 경로만 출력하기: --format과 LogPath

2026년 11월 4일2 min read작성자 Flature

docker inspect에 --format='{{.LogPath}}'를 지정하면 전체 JSON 대신 로그 경로 필드의 값만 출력합니다. 컨테이너 이름을 사용한 명령 예제와 출력 해석, 조회 전제와 주의점을 설명합니다.

docker inspect로 컨테이너 로그 경로만 출력하기: --format과 LogPath

컨테이너의 로그 파일 경로만 확인하려면 docker inspect --format='{{.LogPath}}' 컨테이너이름을 사용합니다. 조회 결과에서 LogPath 값만 출력하므로 전체 JSON에서 경로를 따로 찾을 필요가 없습니다.

전체 정보 대신 로그 경로만 필요할 때

docker inspect는 기본적으로 Docker 객체의 상세 정보를 JSON 배열로 반환합니다. 로그 경로 하나만 확인하려는 경우에는 --format으로 필요한 필드를 선택하면 결과를 간단하게 읽을 수 있습니다.

이 옵션은 Go 템플릿을 사용합니다. {{.LogPath}}에서 점은 현재 조회한 객체를 가리키며, LogPath는 출력할 필드입니다. --format의 짧은 옵션은 -f입니다.

컨테이너를 지정해 LogPath 조회하기

Docker CLI를 사용할 수 있고, 대상 Docker에 연결하여 컨테이너 정보를 조회할 권한이 있어야 합니다. 조회할 컨테이너의 이름이나 ID도 준비합니다. 다음 명령의 web-app을 실제 대상의 이름 또는 ID로 바꾸세요.

docker inspect --type=container --format='{{.LogPath}}' web-app

--type=container는 조회 대상을 컨테이너로 제한합니다. 이름이 같은 다른 종류의 Docker 객체가 있을 때 대상을 명확하게 지정하는 데 도움이 됩니다. 로그 경로를 선택하는 부분은 --format='{{.LogPath}}'입니다.

출력된 경로를 해석하는 예시

예를 들어 대상의 LogPath에 /example/docker-logs/web-app.log가 저장되어 있다고 가정하면, 위 명령의 출력은 다음과 같습니다. 이 경로는 설명을 위한 가상 값입니다.

/example/docker-logs/web-app.log

이 한 줄이 해당 컨테이너의 조회 정보에 기록된 로그 경로입니다. JSON의 필드 이름이나 다른 설정은 출력하지 않습니다. 실제 환경에서는 예시 경로를 사용하지 말고 명령이 반환한 값을 확인해야 합니다.

경로 조회 결과의 한계와 흔한 실수

  • LogPath의 대소문자와 앞의 점을 그대로 사용합니다. 템플릿 전체는 예시처럼 따옴표로 묶습니다.
  • 이 명령은 로그 경로 필드의 값을 조회합니다. 로그 내용이나 파일을 읽을 수 있는지까지 확인하는 명령은 아닙니다.
  • 빈 줄이 출력된다면 사용할 경로 문자열을 얻지 못한 것입니다. 이 결과만으로 로그 자체가 없다고 단정하지 마세요.
  • 컨테이너를 여러 개 지정하면 각 조회 결과에 템플릿이 적용됩니다. 경로만 출력할 때는 대상과 결과를 혼동하지 않도록 하나씩 조회하면 확인하기 쉽습니다.

대상 컨테이너를 이름이나 ID로 지정하고, {{.LogPath}}로 반환된 한 줄을 확인하면 로그 경로 조회를 마칠 수 있습니다.

참고한 공식 문서

이어서 확인할 내용