ProgramChecker 사용 설명서

목차

1. 프로그램 소개
2. 주요 기능
3. 시작하기
4. 사용 방법
5. 설정 옵션
6. 문제 해결
7. FAQ

---

프로그램 소개

ProgramChecker는 Windows에서 실행 중인 프로그램을 모니터링하고, 프로그램이 비정상 종료되거나 응답하지 않을 때 자동으로 감지하여 처리하는 도구입니다.

주요 특징

• 🎯 프로세스 모니터링: 지정한 프로그램이 실행 중인지 주기적으로 확인
• 🔄 자동 재시작: 프로세스가 없을 때 자동으로 재시작
• 📊 CPU 사용량 감지: CPU 사용량이 0%로 유지되면 프로그램이 멈춘 것으로 판단하여 종료
• 📝 로그 기록: 모든 작업 내역을 날짜별 로그 파일로 저장
• ⚙️ 설정 저장: 프로그램 종료 시 설정이 자동 저장되어 다음 실행 시 불러옴
• 🔐 권한 선택: 관리자 권한 버전과 일반 모드 버전 제공

---

주요 기능

1. 프로세스 모니터링

• 지정한 프로그램이 실행 중인지 주기적으로 확인
• 프로세스가 없으면 자동으로 재시작
• 프로세스 찾기 방법:
  • 프로그램 경로: 정확한 실행 파일 경로로 찾기
  • 프로세스 이름: 프로세스 이름으로 찾기 (예: chrome.exe)
  • 파일 설명: 실행 파일의 설명 정보로 찾기

2. CPU 사용량 기반 감지

• CPU 사용량이 0%로 유지되면 프로그램이 멈춘 것으로 판단
• 설정한 시간 동안 CPU가 0% 유지되면 프로세스 종료
• CPU 사용량이 다시 올라오면 정상 작동으로 판단

3. 로그 기록

• 모든 모니터링 활동을 로그로 기록
• 날짜별로 로그 파일 자동 생성 (log/checker/YYYY-MM-DD.log)
• 실시간 로그 확인 가능

4. 설정 관리

• 프로그램 경로, 프로세스 이름, 체크 간격 등 설정 저장
• 프로그램 종료 시 자동 저장
• 다음 실행 시 자동으로 불러오기

---

시작하기

시스템 요구사항

• 운영체제: Windows 10 이상
• 권한: 일부 프로세스 모니터링 시 관리자 권한 필요

실행 방법

1. 제공된 실행 파일 중 하나를 선택:

   • 관리자 권한 필요 시: ProgramCheckerAdmin.exe 또는 ProgramCheckerRunAdmin.exe
   • 일반 모드: ProgramChecker.exe 또는 ProgramCheckerRun.exe

2. 실행 파일을 더블클릭하여 실행

   • 관리자 권한 버전의 경우 UAC 프롬프트가 나타날 수 있습니다

---

사용 방법

1단계: 프로그램 실행

GUI 버전 (ProgramChecker.exe)

• 프로그램을 실행하면 창이 열립니다
• 모든 설정과 모니터링을 GUI에서 관리할 수 있습니다

직접 실행 버전 (ProgramCheckerRun.exe)

• 백그라운드에서 자동으로 실행됩니다
• GUI 없이 자동으로 모니터링을 시작합니다
• config.json 파일의 설정을 사용합니다

⚠️ 주의사항:

• 직접 실행 버전은 GUI가 없어서 일반적인 방법으로 종료할 수 없습니다
• 종료하려면 작업 관리자에서 ProgramCheckerRun.exe 또는 ProgramCheckerRunAdmin.exe 프로세스를 찾아 작업 끝내기로 강제 종료해야 합니다
• 다른 프로그램에 이 모니터링 기능을 통합하고 싶다면, 해당 프로그램 종료 시 ProgramCheckerRun 프로세스를 먼저 종료한 후 프로그램을 종료하는 로직을 추가하는 것을 권장합니다
  • 예: 프로그램 종료 버튼 클릭 → ProgramCheckerRun 프로세스 종료 → 프로그램 종료

2단계: 모니터링할 프로그램 설정

프로그램 경로 설정

1. "찾아보기" 버튼 클릭
2. 모니터링할 프로그램의 실행 파일(.exe) 선택
3. 선택한 경로가 자동으로 입력됩니다

프로세스 이름 설정

• 프로그램 경로 대신 프로세스 이름으로도 찾을 수 있습니다
• 예: chrome.exe, notepad.exe, SAFE VIEW.exe
• 프로세스 이름만 입력해도 됩니다

참고: 프로그램 경로와 프로세스 이름 중 하나만 입력해도 됩니다. 둘 다 입력하면 더 정확하게 찾을 수 있습니다.

3단계: 모니터링 옵션 설정

프로세스 체크 간격

• 프로그램 상태를 확인하는 주기
• 옵션: 5초, 10초, 15초, 30초, 1분, 5분, 10분, 15분, 30분, 60분
• 기본값: 5초

CPU 0% 유지 시간

• CPU 사용량이 0%로 유지될 때 프로세스를 종료하기까지의 시간
• 옵션: 5초, 10초, 15초, 30초, 1분, 2분, 5분
• 기본값: 5초
• 동작 방식:
  • CPU 사용량이 0%가 되면 타이머 시작
  • 설정한 시간 동안 계속 0% 유지되면 프로세스 종료
  • 중간에 CPU 사용량이 올라오면 타이머 리셋

4단계: 모니터링 시작

1. "모니터링 시작" 버튼 클릭
2. 상태 표시가 "모니터링 중..."으로 변경됩니다
3. 로그 영역에서 실시간으로 모니터링 상태를 확인할 수 있습니다

5단계: 모니터링 확인

로그 확인

• 로그 영역에서 다음 정보를 확인할 수 있습니다:
  • 프로세스 찾기 성공/실패
  • CPU 사용량 변화
  • 프로세스 종료 및 재시작
  • 오류 메시지

로그 파일 확인

• 로그는 log/checker/ 폴더에 날짜별로 저장됩니다
• 파일명 형식: YYYY-MM-DD.log
• 예: 2025-12-19.log

6단계: 모니터링 중지

• "모니터링 중지" 버튼을 클릭하면 모니터링이 중지됩니다
• 설정은 자동으로 저장됩니다

---

설정 옵션

설정 파일 (config.json)

프로그램 종료 시 자동으로 저장되는 설정 파일입니다.

{
  "program_path": "C:/Program Files/MyApp/MyApp.exe",
  "program_name": "MyApp.exe",
  "check_interval": "5초",
  "cpu_zero_duration": "5초"
}

설정 항목 설명

항목	설명	예시
program_path	모니터링할 프로그램의 전체 경로	C:/Program Files/MyApp/MyApp.exe
program_name	프로세스 이름	MyApp.exe
check_interval	프로세스 체크 간격	5초, 1분 등
cpu_zero_duration	CPU 0% 유지 시간	5초, 30초 등

버전 선택 가이드

관리자 권한 버전 사용 시기

• 시스템 프로세스나 보호된 프로세스를 모니터링할 때
• 다른 사용자의 프로세스에 접근해야 할 때
• UAC 프롬프트가 나타나도 괜찮을 때

일반 모드 버전 사용 시기

• 일반 사용자 프로그램만 모니터링할 때
• UAC 프롬프트 없이 실행하고 싶을 때
• 보안 정책상 관리자 권한을 사용할 수 없을 때

---

문제 해결

문제 1: 프로세스를 찾을 수 없습니다

원인:

• 프로그램 경로가 잘못되었거나
• 프로세스 이름이 정확하지 않거나
• 프로그램이 실행되지 않았거나
• 관리자 권한이 필요한 프로세스인데 일반 모드로 실행했을 때

해결 방법:

1. 프로그램 경로가 정확한지 확인
2. 프로세스 이름이 정확한지 확인 (대소문자 구분 없음)
3. 프로그램이 실제로 실행 중인지 확인
4. 관리자 권한 버전으로 실행해보기

문제 2: 프로세스 접근 불가

원인:

• 관리자 권한이 필요한 프로세스인데 일반 모드로 실행했을 때
• 보안 정책에 의해 접근이 차단되었을 때

해결 방법:

1. 관리자 권한 버전(ProgramCheckerAdmin.exe)으로 실행
2. 프로그램을 관리자 권한으로 실행

문제 3: CPU 0% 감지가 너무 빨리 작동합니다

원인:

• "CPU 0% 유지 시간" 설정이 너무 짧을 때

해결 방법:

1. "CPU 0% 유지 시간"을 더 길게 설정 (예: 30초, 1분)
2. 프로그램이 실제로 멈춘 상태인지 확인

문제 4: 프로그램이 재시작되지 않습니다

원인:

• 프로그램 경로가 잘못되었거나
• 프로그램 실행에 필요한 권한이 없을 때

해결 방법:

1. 프로그램 경로가 정확한지 확인
2. 프로그램을 수동으로 실행해보기
3. 관리자 권한 버전으로 실행해보기

문제 5: 로그 파일이 생성되지 않습니다

원인:

• 로그 폴더 생성 권한이 없을 때
• 디스크 공간이 부족할 때

해결 방법:

1. 프로그램 실행 위치에 쓰기 권한이 있는지 확인
2. 디스크 공간 확인
3. 관리자 권한으로 실행해보기

---

FAQ

Q1: 여러 프로그램을 동시에 모니터링할 수 있나요?

A: 현재 버전은 한 번에 하나의 프로그램만 모니터링할 수 있습니다. 여러 프로그램을 모니터링하려면 프로그램을 여러 개 실행하세요.

Q2: 프로그램이 종료되면 자동으로 재시작되나요?

A: 네, 프로세스가 없으면 자동으로 재시작됩니다. CPU 0%로 인한 종료 후에는 프로세스가 없어지므로 재시작됩니다.

Q3: CPU 0% 유지 시간을 어떻게 설정해야 하나요?

A: 프로그램의 특성에 따라 다릅니다:

• 빠른 응답이 필요한 프로그램: 5초 ~ 15초
• 일반적인 프로그램: 30초 ~ 1분
• 백그라운드 작업이 많은 프로그램: 1분 ~ 5분

Q4: 관리자 권한 버전과 일반 모드 버전의 차이는?

A:

• 관리자 권한 버전: 모든 프로세스에 접근 가능, UAC 프롬프트 표시
• 일반 모드 버전: 현재 사용자의 프로세스만 접근 가능, UAC 프롬프트 없음

Q5: 설정은 어디에 저장되나요?

A: 프로그램 실행 파일과 같은 폴더의 config.json 파일에 저장됩니다.

Q6: 로그 파일은 어디에 저장되나요?

A: 프로그램 실행 파일과 같은 폴더의 log/checker/ 폴더에 날짜별로 저장됩니다.

Q7: 프로그램을 백그라운드에서 실행할 수 있나요?

A: 네, ProgramCheckerRun.exe 또는 ProgramCheckerRunAdmin.exe를 사용하면 GUI 없이 백그라운드에서 실행됩니다.

Q8: 체크 간격을 너무 짧게 설정하면 문제가 되나요?

A: 체크 간격이 너무 짧으면 (예: 5초) 시스템 리소스를 더 많이 사용합니다. 일반적으로 5초 ~ 30초가 적절합니다.

Q9: CPU 사용량이 0%인데도 종료되지 않습니다

A: 다음을 확인하세요:

1. "CPU 0% 유지 시간" 설정이 충분히 지났는지
2. CPU 사용량이 정말 0%인지 (일시적으로 0%였다가 다시 올라오면 리셋됨)
3. 프로세스가 실제로 실행 중인지

Q10: 프로그램을 완전히 종료하고 싶습니다

A:

• GUI 버전: 창을 닫으면 종료됩니다
• 직접 실행 버전: 작업 관리자에서 프로세스를 종료합니다

---

추가 정보

로그 파일 형식

로그 파일은 UTF-8 인코딩으로 저장되며, 각 줄은 다음과 같은 형식입니다:

[YYYY-MM-DD HH:MM:SS] 메시지 내용

예시:

[2025-12-19 14:30:15] 모니터링을 시작합니다.
[2025-12-19 14:30:20] CPU 사용량 0% 감지 (PID: 1234). 모니터링 시작...
[2025-12-19 14:30:25] CPU 사용량이 5초간 0% 유지됨 (PID: 1234). 중지로 판단하여 종료합니다...

프로세스 찾기 우선순위

1. 프로그램 경로 (가장 정확)
2. 파일 설명 (경로가 다를 수 있지만 같은 프로그램)
3. 프로세스 이름 (가장 넓은 범위)

권장 설정 예시

빠른 응답이 필요한 프로그램 (게임, 실시간 앱)

• 프로세스 체크 간격: 5초
• CPU 0% 유지 시간: 10초

일반적인 프로그램 (문서 편집기, 브라우저)

• 프로세스 체크 간격: 10초 ~ 30초
• CPU 0% 유지 시간: 30초 ~ 1분

백그라운드 서비스

• 프로세스 체크 간격: 1분 ~ 5분
• CPU 0% 유지 시간: 2분 ~ 5분

---

라이선스 및 지원

이 프로그램은 자유롭게 사용, 수정, 배포할 수 있습니다.

문제가 발생하거나 개선 사항이 있으면 이슈를 등록해주세요.

---

마지막 업데이트: 2025-12-19