kyopark2014 System Monitor
로컬 머신(현재 코드 실행 환경)의 CPU, 메모리, 디스크, 네트워크 상태와 상위 프로세스를 확인하는 skill입니다.
psutil로 실제 OS 지표를 읽고, 임계치 초과 항목은 자동으로 경고합니다.
수집 항목
- 시스템 기본 정보: OS, 호스트명, 아키텍처, 부팅 시각, 업타임
- CPU: 코어 수, 사용률(%), 주파수, Load Average
- 메모리(RAM): 전체/사용/여유, 사용률(%), SWAP
- 디스크: 마운트별 전체/사용/여유, 사용률(%)
- 네트워크: 전체 전송률 + 인터페이스별 누적/전송률
- 상위 프로세스: CPU·메모리 기준 Top N
Script Location
application working directory 기준 전체 경로를 사용하세요.
| 스크립트 | 용도 |
|---|---|
skills/system-monitor/scripts/monitor.py |
시스템 스냅샷 수집·경고·리포트/그래프 생성 |
IMPORTANT: scripts/...로 줄이지 말고 위 전체 경로를 사용하세요.
빠른 사용법
execute_code 도구로 실행하세요.
python skills/system-monitor/scripts/monitor.py
기본 실행만으로 CPU/메모리/디스크/네트워크 요약, CPU·메모리 상위 프로세스 Top 5, 임계치 초과 경고가 텍스트로 출력됩니다.
| 옵션 | 설명 | 기본값 |
|---|---|---|
--top N |
상위 프로세스 개수 | 5 |
--cpu-threshold N |
CPU 경고 임계치(%) | 90 |
--mem-threshold N |
메모리 경고 임계치(%) | 90 |
--disk-threshold N |
디스크 경고 임계치(%) | 90 |
--cpu-interval N |
CPU 측정 샘플링 시간(초) | 1.0 |
--net-interval N |
네트워크 전송률 샘플링 시간(초) | 1.0 |
--json |
텍스트 대신 JSON 출력 | off |
--report <dir> |
Markdown 리포트(.md) + 사용률 막대그래프(.png) 생성 | off |
사용 시나리오
"지금 시스템 상태 어때?" / 단순 확인 옵션 없이 기본 실행 후 텍스트 요약을 보여주세요. 리포트 파일은 필요 없습니다.
"뭐가 이렇게 느려?" / "어떤 프로세스가 리소스를 많이 써?"
--top 10으로 늘려 CPU/메모리 상위 프로세스와 ⚠️ 경고를 근거로 원인을 설명하세요.
"리포트/파일로 만들어줘" / "그래프로 보여줘"
--report <ARTIFACTS_DIR>/system-report 처럼 ARTIFACTS_DIR 하위 경로를 지정해 Markdown + PNG를 만든 뒤,
upload_file_to_s3로 업로드해 링크를 제공하세요.
python skills/system-monitor/scripts/monitor.py --report "$ARTIFACTS_DIR/system-report"
"디스크 얼마나 남았어?" / 특정 지표만 전체 스냅샷을 실행한 뒤 필요한 섹션만 추려 답변하면 됩니다.
주기적/반복 모니터링 1회성 스냅샷 도구입니다. "5분마다 감시" 요청에는 여러 번 찍어 비교하거나 OS 스케줄러(cron/launchd) 안내가 안전합니다.
출력 형식
- 스크립트 결과를 코드 블록으로 보여주세요.
- 결과 아래에 요약 코멘트를 한국어로 추가하세요:
- 주의가 필요한 항목(임계치 초과 또는 사용률 높음)은 ⚠️ 경고
- 정상 범위면 ✅ 정상
- 필요 시 간단한 조치 방법 제안
결과 해석 시 주의점
- CPU 사용률은
--cpu-interval동안의 평균입니다. 신뢰도 있는 값이 필요하면 최소 1초 이상을 권장합니다. - 디스크에
/System/Volumes/...같은 macOS 시스템 볼륨이 포함될 수 있습니다. 사용자 저장 공간은 보통/또는/System/Volumes/Data를 우선 설명하세요. - 메모리 사용률이 높아도 OS가 캐시로 여유 메모리를 쓰는 특성이 있으니, 스왑 사용률을 함께 보세요.
- 프로세스
cpu_percent는 논리 코어 기준이라 멀티코어에서 100%를 넘을 수 있습니다.
문제 해결
psutil이 없으면 스크립트가 자동 설치를 시도합니다. 실패 시pip install psutil을 실행하세요.- 특정 디스크 파티션이 누락되면 권한 문제로 건너뛴 것이며 정상 동작입니다.
--report그래프에서 한글이 깨지면 한글 폰트가 없는 환경일 수 있습니다. 텍스트/JSON만 사용하세요.- 컨테이너/가상 환경에서는 일부 하드웨어 정보가 제한될 수 있습니다.