Docker를 운영하다 보면 현재 Docker Engine의 버전은 무엇인지, 실행 중인 컨테이너는 몇 개인지, 이미지는 얼마나 저장되어 있는지, 사용하는 스토리지 드라이버(Storage Driver)는 무엇인지 확인해야 하는 상황이 자주 발생합니다.
특히 운영 서버에서 Docker가 정상적으로 실행되고 있는지 확인하거나 장애를 분석할 때는 Docker 환경 전체의 상태를 한 번에 확인하는 것이 매우 중요합니다.
이럴 때 사용하는 명령어가 바로 docker system info입니다.
Docker System Info는 Docker Engine의 전체 시스템 정보를 확인하는 명령어입니다. Docker 버전, 컨테이너 개수, 이미지 개수, 스토리지 드라이버, 네트워크 정보, CPU와 메모리 정보 등 Docker 환경 전반을 한 번에 확인할 수 있어 운영자가 가장 자주 사용하는 진단 명령어 중 하나입니다.
이번 글에서는 Docker System Info의 개념부터 기본 사용법, 주요 출력 항목, 실무 활용 방법까지 자세히 알아보겠습니다.
Docker System Info란 무엇인가?
Docker System Info는 Docker Engine의 시스템 정보를 출력하는 명령어입니다.
현재 Docker가 어떤 환경에서 동작하고 있는지 한 번에 확인할 수 있으며 운영 서버의 상태를 점검할 때 매우 유용합니다.
Docker 데몬이 정상적으로 실행 중인지 확인하는 용도로도 많이 사용됩니다.
Docker System Info는 언제 사용하는가?
다음과 같은 상황에서 자주 사용합니다.
- Docker 설치 확인
- Docker 버전 확인
- 운영 서버 상태 점검
- 장애 분석
- Docker 환경 확인
- 시스템 진단
Docker를 관리하는 운영자라면 반드시 알아야 하는 기본 명령어입니다.
Docker System Info 기본 사용법
가장 기본적인 사용 방법입니다.
docker system info또는 다음 명령도 동일하게 사용할 수 있습니다.
docker info두 명령 모두 동일한 Docker 시스템 정보를 출력합니다.
출력 결과 예시
명령을 실행하면 다음과 같은 정보가 출력됩니다.
Client:
Context: default
Server:
Containers: 12
Running: 5
Paused: 0
Stopped: 7
Images: 26
Server Version: 28.0.0
Storage Driver: overlay2
Logging Driver: json-file
Cgroup Driver: systemd
Kernel Version: 6.8.0
Operating System: Ubuntu 24.04
CPUs: 8
Total Memory: 15.6GiB
Docker Root Dir: /var/lib/docker현재 Docker 환경의 핵심 정보를 한 번에 확인할 수 있습니다.
주요 출력 항목 이해하기
Docker System Info에서 자주 확인하는 항목은 다음과 같습니다.
Containers
현재 Docker 컨테이너 개수를 의미합니다.
실행 중인 컨테이너와 중지된 컨테이너를 모두 확인할 수 있습니다.
Images
현재 저장되어 있는 Docker 이미지 개수입니다.
Server Version
현재 설치된 Docker Engine 버전입니다.
버전 호환성을 확인할 때 가장 많이 사용하는 항목입니다.
Storage Driver
Docker가 사용하는 스토리지 드라이버입니다.
대부분 Linux에서는 overlay2를 사용합니다.
Logging Driver
Docker 로그 저장 방식입니다.
기본적으로 json-file을 사용하는 경우가 많습니다.
Docker Root Dir
Docker 데이터가 저장되는 디렉터리입니다.
기본 경로는 다음과 같습니다.
/var/lib/docker디스크 사용량을 확인할 때 자주 확인하는 경로입니다.
Docker 데몬 정상 동작 확인하기
Docker 데몬이 정상적으로 실행 중이라면 시스템 정보가 정상적으로 출력됩니다.
만약 Docker 서비스에 문제가 있다면 오류 메시지가 출력됩니다.
운영 서버에서는 Docker 서비스 상태를 확인하는 가장 빠른 방법 중 하나입니다.
Docker System Info 실무 활용 예제
Docker System Info는 Docker 서버의 현재 상태를 한 번에 확인할 수 있어 운영 환경에서 가장 많이 사용하는 진단 명령어 중 하나입니다.
Docker 전체 시스템 정보 확인하기
가장 기본적인 사용 방법입니다.
docker system infoDocker Engine의 전체 시스템 정보를 확인할 수 있습니다.
Docker 버전 확인하기
출력 결과에서 다음 항목을 확인합니다.
Server Version: 28.0.0현재 설치된 Docker Engine 버전을 확인할 수 있습니다.
프로젝트 요구사항이나 버그 여부를 확인할 때 자주 사용하는 정보입니다.
실행 중인 컨테이너 확인하기
출력 결과의 Containers 항목을 확인합니다.
Containers: 15
Running: 6
Paused: 0
Stopped: 9현재 실행 중인 컨테이너와 중지된 컨테이너 수를 확인할 수 있습니다.
Storage Driver 확인하기
현재 사용하는 스토리지 드라이버를 확인합니다.
Storage Driver: overlay2Linux 환경에서는 대부분 overlay2를 사용합니다.
스토리지 관련 문제를 분석할 때 중요한 정보입니다.
Docker Root Directory 확인하기
Docker 데이터가 저장되는 위치를 확인합니다.
Docker Root Dir: /var/lib/docker디스크 사용량을 점검하거나 저장 위치를 변경할 때 참고하는 항목입니다.
시스템 리소스 확인하기
CPU와 메모리 정보도 함께 확인할 수 있습니다.
CPUs: 8
Total Memory: 15.6GiBDocker가 실행 중인 서버의 하드웨어 정보를 확인할 수 있습니다.
Linux 서버 문제 해결
운영 서버에서 Docker 컨테이너가 정상적으로 실행되지 않는 문제가 발생했습니다.
관리자는 먼저 Docker 환경 전체를 확인했습니다.
docker system info출력 결과를 확인한 결과 Docker 데몬은 정상적으로 실행되고 있었지만 저장 공간이 부족한 상태였습니다.
또한 현재 실행 중인 컨테이너 수도 함께 확인했습니다.
Containers: 32
Running: 30
Stopped: 2스토리지 드라이버와 Docker Root Directory도 확인했습니다.
Storage Driver: overlay2
Docker Root Dir: /var/lib/docker이후 docker system df를 실행하여 디스크 사용량을 확인했고, 사용하지 않는 이미지와 Build Cache를 정리하여 문제를 해결했습니다.
Docker System Info는 장애가 발생했을 때 가장 먼저 실행하는 기본 진단 명령어 중 하나입니다.
Docker System Info 사용 시 주의사항
Docker System Info를 사용할 때는 다음 사항을 알아두면 좋습니다.
첫 번째는 이 명령어는 조회만 수행하며 시스템을 변경하지 않습니다.
운영 서버에서도 안전하게 실행할 수 있습니다.
두 번째는 출력되는 정보는 Docker Engine 버전에 따라 일부 항목이 달라질 수 있습니다.
버전이 변경되면 새로운 정보가 추가되거나 일부 항목이 변경될 수 있습니다.
세 번째는 Docker 데몬이 실행 중이지 않으면 시스템 정보를 확인할 수 없습니다.
먼저 Docker 서비스 상태를 확인해야 합니다.
네 번째는 장애 분석 시에는 Docker System Info만 확인하지 말고 docker system df, docker logs, docker system events와 함께 사용하는 것이 좋습니다.
Best Practice
Docker System Info를 사용할 때는 다음과 같은 방법을 추천합니다.
- 장애 발생 시 가장 먼저 실행합니다.
- Docker 버전을 확인합니다.
- Storage Driver를 점검합니다.
- Docker Root Directory를 확인합니다.
- CPU와 메모리 정보를 함께 확인합니다.
- 다른 Docker 진단 명령과 함께 활용합니다.
이러한 방법을 적용하면 Docker 환경을 더욱 안정적으로 운영할 수 있습니다.
자주 묻는 질문
Docker System Info와 Docker Info는 다른 명령인가요?
아닙니다.
docker system info와 docker info는 동일한 정보를 출력하는 명령어입니다.
Docker System Info는 시스템을 변경하나요?
아니요.
조회만 수행하는 안전한 명령어입니다.
Docker Root Directory는 왜 중요한가요?
Docker 이미지와 컨테이너, 볼륨 등의 데이터가 저장되는 위치이므로 디스크 관리와 장애 분석에 매우 중요합니다.
운영 서버에서도 실행해도 되나요?
가능합니다.
시스템을 변경하지 않는 조회 명령이므로 운영 서버에서도 안전하게 사용할 수 있습니다.
마무리
Docker System Info는 Docker Engine의 전체 시스템 정보를 확인할 수 있는 핵심 진단 명령어입니다.
컨테이너와 이미지 개수, Docker 버전, Storage Driver, Docker Root Directory, CPU와 메모리 정보까지 한 번에 확인할 수 있어 운영 서버의 상태를 빠르게 파악할 수 있습니다.
특히 장애가 발생했을 때는 docker system info를 시작으로 docker system df, docker system events, docker logs 등을 함께 활용하면 Docker 환경을 더욱 효율적으로 분석하고 관리할 수 있습니다.