!pm2-ops-cheatsheet-flow
PM2는 Node 프로세스를 살아 있게 유지하고, 상태와 로그를 빠르게 확인하는 데 특화된 프로세스 매니저다. 공식 Quick Start도 핵심을 start / restart / stop / logs / list 흐름으로 설명한다. 참고: PM2 Quick Start.
이 치트시트를 언제 쓰나
- Quartz 같은 단일 서비스가 멈췄는지 빨리 보고 싶을 때
- 코드 반영 뒤 재기동이 필요한데 절차를 짧게 확인하고 싶을 때
- 장애 원인을 보기 위해 로그와 상태를 바로 보고 싶을 때
자주 쓰는 5개 명령
pm2 list
pm2 restart quartz
pm2 logs quartz --lines 100
pm2 stop quartz
pm2 start quartz어떤 상황에서 어떤 명령을 먼저 쓰나
1) 상태부터 볼 때
pm2 list현재 프로세스가 online인지, 재시작 횟수가 급격히 늘지 않았는지 먼저 본다.
2) 빠르게 다시 올릴 때
pm2 restart quartz코드나 콘텐츠 반영 뒤 가장 먼저 쓰는 기본 재기동 명령이다.
3) 원인을 볼 때
pm2 logs quartz --lines 100에러가 난 직후에는 최근 100줄 정도만 봐도 원인이 잡히는 경우가 많다.
4) 점검 때문에 잠깐 내릴 때
pm2 stop quartz
pm2 start quartz장애 분석이나 점검 중에는 의도적으로 멈춘 뒤 다시 올리는 흐름이 필요할 수 있다.
실전 루틴
# 1) 상태 확인
pm2 list
# 2) 재기동
pm2 restart quartz
# 3) 문제 있으면 로그 확인
pm2 logs quartz --lines 100자주 놓치는 포인트
- 환경변수를 바꿨는데 재기동만 하면 반영이 안 될 수 있다.
- 이럴 때는 다음 옵션을 같이 본다.
pm2 restart quartz --update-env작은 사례로 보면,
- Before: 서비스가 느리면 무조건 다시 시작부터 함
- After:
list → restart → logs순서로 확인 → 불필요한 재기동과 추측이 줄어듦
restart와 stop/start를 어떻게 나눌까
restart: 가장 일반적인 기본값. 반영 속도가 빠르고, 평소 운영에서는 이걸 먼저 쓴다.stop→start: 점검 중 잠깐 완전히 내렸다가 다시 올려야 할 때 쓴다.- 로그를 보기 전에 무조건 여러 번 재시작하면 원인을 놓치기 쉽다.
10초 점검 루틴
pm2 list로 상태를 본다.- online인데 이상하면
pm2 logs quartz --lines 100을 먼저 본다. - 반영 문제면
restart, 점검 목적이면stop/start로 간다.
이 흐름을 고정해 두면 “일단 다시 켜 보자” 식의 습관 때문에 로그 타이밍을 놓치는 일이 줄어든다.
같이 보면 좋은 문서
AI 활용 고지: 이 문서는 PM2 공식 Quick Start를 바탕으로 생성형 AI 초안을 작성한 뒤, Quartz 운영에서 가장 자주 쓰는 명령만 남겨 실전용으로 정리했습니다.