stamper

Docker 컨테이너 로그 확인하고 에러 원인 찾는 명령어

stamper2026. 8. 3.조회 41추천 0
변수 입력4

1. 컨테이너 상태와 종료 코드 확인

docker ps -a --filter "name={{CONTAINER_NAME}}"
docker inspect {{CONTAINER_NAME}} --format '{{json .State}}'

Status, ExitCode, OOMKilled, Error를 먼저 확인합니다. 실행 중인 컨테이너를 바로 삭제하거나 재시작하면 최초 오류 로그를 놓칠 수 있습니다.

2. 최근 로그부터 확인

docker logs --tail=200 --timestamps {{CONTAINER_NAME}}
docker logs --since=10m --follow {{CONTAINER_NAME}}

Docker Compose 서비스라면 서비스 이름으로 조회합니다.

docker compose ps
docker compose logs --tail=200 --timestamps {{SERVICE_NAME}}

3. 이벤트와 설정 비교

docker events --since=10m --filter container={{CONTAINER_NAME}}
docker inspect {{CONTAINER_NAME}}

이미지, 환경변수, mount, health check, restart policy, 메모리 제한이 최근 배포에서 바뀌었는지 확인하세요. docker inspect 출력에는 secret이 포함될 수 있으므로 그대로 공유하지 않습니다.

4. AI 분석용 프롬프트

아래 Docker 상태와 로그를 보고 원인을 분석해줘.

확인할 것:
1. 최초 오류와 연쇄 오류 구분
2. 설정·애플리케이션·리소스 문제 중 가장 가능성 높은 원인
3. 가설마다 추가로 확인할 비파괴적 명령
4. 임시 조치와 근본 해결 방법
5. 재발 방지용 health check와 모니터링 항목

상태:
{{STATE}}

로그:
{{LOGS}}

5. 수정 후 검증

원인을 수정한 뒤 docker compose up -d 또는 해당 서비스의 정상 배포 절차를 사용하고, docker compose ps, 최근 로그, 실제 health endpoint 순으로 확인합니다. 데이터가 있는 volume은 장애 원인이 확인되기 전에 삭제하지 마세요.

댓글 0

아직 댓글이 없습니다.