Docker 환경을 운영하다 보면 컨테이너가 언제 시작되었는지, 누가 이미지를 삭제했는지, 어떤 시점에 컨테이너가 종료되었는지 확인해야 하는 경우가 많습니다. 특히 여러 명이 함께 사용하는 서버에서는 컨테이너 생성, 삭제, 재시작 등의 작업이 빈번하게 발생하기 때문에 이러한 변경 사항을 실시간으로 추적하는 것이 매우 중요합니다.
이럴 때 사용하는 명령어가 바로 docker events입니다.
Docker Events는 Docker 데몬에서 발생하는 모든 이벤트를 실시간으로 출력하는 명령어입니다. 컨테이너 생성과 종료는 물론 이미지 다운로드, 네트워크 생성, 볼륨 연결 등 다양한 이벤트를 실시간으로 모니터링할 수 있습니다.
운영 서버에서는 장애 발생 시점 분석, 보안 감사, 자동화 스크립트 작성 등 다양한 목적으로 활용되며 Docker 관리자가 반드시 알아두어야 할 명령어 중 하나입니다.
이번 글에서는 Docker Events의 개념부터 기본 사용법, 주요 옵션, 실무 활용 사례, 운영 시 주의사항까지 자세히 알아보겠습니다.
Docker Events란 무엇인가?
Docker Events는 Docker에서 발생하는 이벤트를 실시간으로 확인하는 명령어입니다.
Docker 데몬은 컨테이너 실행, 종료, 삭제, 이미지 Pull, Volume 생성 등 다양한 작업이 발생할 때마다 이벤트를 생성합니다.
Docker Events는 이러한 이벤트를 시간순으로 출력하여 현재 Docker 환경에서 어떤 작업이 이루어지고 있는지 확인할 수 있도록 도와줍니다.
Docker Events는 언제 사용하는가?
다음과 같은 상황에서 자주 사용됩니다.
- 컨테이너 생성 및 삭제 확인
- 컨테이너 재시작 여부 확인
- 운영 서버 변경 사항 모니터링
- 장애 발생 시점 분석
- 자동화 스크립트 개발
- 보안 감사 및 작업 이력 확인
실시간으로 Docker 상태를 감시해야 하는 환경에서 매우 유용합니다.
Docker Events 기본 사용법
기본 사용 방법은 다음과 같습니다.
docker events명령을 실행하면 새로운 이벤트가 발생할 때마다 화면에 출력됩니다.
예를 들어 새로운 컨테이너를 실행하면 다음과 같은 로그가 출력됩니다.
2026-07-23T09:35:11 container create nginx
2026-07-23T09:35:12 container start nginx컨테이너를 종료하면 다음과 같은 이벤트가 추가됩니다.
2026-07-23T09:40:15 container stop nginx
2026-07-23T09:40:16 container die nginx이처럼 Docker에서 발생하는 모든 작업을 실시간으로 확인할 수 있습니다.
특정 컨테이너 이벤트만 확인하기
특정 컨테이너만 감시하려면 Filter 옵션을 사용합니다.
docker events --filter container=nginx이제 nginx 컨테이너에서 발생하는 이벤트만 출력됩니다.
운영 서버에서 특정 서비스만 모니터링할 때 매우 유용합니다.
특정 이벤트 종류만 확인하기
이벤트 종류를 지정하여 확인할 수도 있습니다.
예를 들어 Start 이벤트만 확인하려면 다음과 같이 실행합니다.
docker events --filter event=startStop 이벤트만 확인하려면 다음 명령을 사용합니다.
docker events --filter event=stop필요한 이벤트만 확인하면 로그를 더욱 효율적으로 분석할 수 있습니다.
특정 시간 이후 이벤트 조회
최근 발생한 이벤트만 확인하려면 --since 옵션을 사용합니다.
docker events --since 30m최근 30분 동안 발생한 이벤트만 출력됩니다.
최근 2시간 동안의 이벤트는 다음과 같습니다.
docker events --since 2h장애 발생 시간을 기준으로 이벤트를 분석할 때 많이 사용하는 기능입니다.
특정 시간 이전 이벤트 조회
이전 이벤트만 확인하려면 --until 옵션을 사용합니다.
docker events --until 1h최근 1시간 이전의 이벤트만 조회할 수 있습니다.
시간 구간을 지정하여 이벤트를 분석할 때 유용합니다.
Docker Events 실무 활용 예제
Docker Events는 Docker 환경에서 발생하는 모든 작업을 실시간으로 추적할 수 있기 때문에 운영 서버 모니터링과 장애 분석에 매우 유용합니다. 특히 여러 개의 컨테이너를 운영하는 환경에서는 예상치 못한 변경 사항을 빠르게 확인할 수 있습니다.
컨테이너 생성 감시
새로운 컨테이너가 생성되는지 확인하려면 다음 명령을 사용합니다.
docker events --filter event=create새 컨테이너가 생성될 때마다 다음과 같은 이벤트가 출력됩니다.
container create web-server운영 서버에서 무단으로 컨테이너가 생성되는지 감시할 때 활용할 수 있습니다.
컨테이너 종료 감시
서비스가 갑자기 종료되는 원인을 분석하려면 Stop 이벤트를 확인합니다.
docker events --filter event=stop컨테이너가 종료될 때마다 즉시 이벤트가 출력됩니다.
장애 발생 시간을 빠르게 파악할 수 있습니다.
이미지 다운로드 확인
누군가 새로운 이미지를 다운로드했는지도 확인할 수 있습니다.
docker events --filter event=pull출력 예시입니다.
image pull nginx:latest운영 서버 변경 이력을 관리할 때 유용합니다.
여러 조건으로 필터링
컨테이너와 이벤트를 동시에 지정할 수도 있습니다.
docker events --filter container=api-server --filter event=restartapi-server 컨테이너가 재시작될 때만 이벤트를 출력합니다.
Linux 서버 문제 해결
운영 중인 웹 서버가 일정 시간마다 갑자기 재시작되는 문제가 발생했습니다.
원인을 찾기 위해 Docker Events를 실행했습니다.
docker events --filter container=web잠시 후 다음과 같은 이벤트가 출력되었습니다.
container die web
container restart web
container start web재시작 정책(Restart Policy)에 의해 컨테이너가 반복적으로 다시 실행되고 있다는 사실을 확인했습니다.
이후 Docker Logs를 확인했습니다.
docker logs web메모리 부족으로 인해 애플리케이션이 종료되고 있다는 오류를 발견했습니다.
메모리 제한을 조정한 후 더 이상 Restart 이벤트가 발생하지 않았고 서비스도 정상적으로 운영되었습니다.
Docker Events와 Docker Logs를 함께 사용하면 대부분의 컨테이너 장애를 빠르게 분석할 수 있습니다.
Docker Events 사용 시 주의사항
Docker Events를 사용할 때는 몇 가지 사항을 알아두는 것이 좋습니다.
첫 번째는 기본적으로 실시간 감시 모드라는 점입니다.
명령을 실행하면 종료하기 전까지 계속 이벤트를 출력합니다.
두 번째는 과거의 모든 이벤트를 저장하는 기능은 아닙니다.
Docker 데몬이 동작하는 동안 발생한 이벤트를 기준으로 조회합니다.
세 번째는 이벤트 자체는 원인을 알려주지 않습니다.
컨테이너가 종료되었다는 사실만 확인할 수 있으며 실제 원인은 Docker Logs나 Docker Inspect를 함께 확인해야 합니다.
Best Practice
Docker Events를 사용할 때는 다음과 같은 방법을 추천합니다.
- 장애 분석 시 Docker Logs와 함께 사용합니다.
- 운영 서버에서는 필요한 이벤트만 필터링합니다.
- 특정 컨테이너만 감시하여 불필요한 로그를 줄입니다.
- 재시작 이벤트를 지속적으로 모니터링합니다.
- 자동화 스크립트와 연동하여 이벤트 발생 시 알림을 전송합니다.
- Docker Inspect와 함께 사용하여 설정 문제도 함께 확인합니다.
이러한 방법을 활용하면 Docker 환경을 더욱 안정적으로 운영할 수 있습니다.
자주 묻는 질문
Docker Events는 실시간으로만 사용할 수 있나요?
기본적으로 실시간 모니터링을 수행하지만 --since, --until 옵션을 이용하여 특정 시간 범위의 이벤트도 조회할 수 있습니다.
Docker Events는 모든 Docker 객체를 감시할 수 있나요?
네. 컨테이너뿐 아니라 이미지, 네트워크, Volume 등 대부분의 Docker 객체에서 발생하는 이벤트를 확인할 수 있습니다.
이벤트 발생 원인도 확인할 수 있나요?
아닙니다. 이벤트는 어떤 작업이 발생했는지만 알려줍니다.
원인을 확인하려면 Docker Logs나 Docker Inspect를 함께 사용하는 것이 좋습니다.
실시간 감시를 종료하려면 어떻게 하나요?
Ctrl + C를 누르면 Docker Events 모니터링이 종료됩니다.
마무리
Docker Events는 Docker에서 발생하는 다양한 작업을 실시간으로 확인할 수 있는 매우 강력한 모니터링 명령어입니다.
컨테이너 생성, 종료, 재시작, 이미지 다운로드 등 운영 중 발생하는 모든 이벤트를 확인할 수 있어 장애 분석과 보안 감사, 자동화 시스템 구축에 널리 활용됩니다.
특히 Docker Logs와 Docker Inspect를 함께 사용하면 문제 발생 원인부터 설정 정보까지 종합적으로 분석할 수 있어 운영 효율성이 크게 향상됩니다.
Docker를 실무에서 운영한다면 Docker Events는 반드시 익혀두어야 할 필수 명령어입니다.