미션 #4 B단계 완료 리포트 — 자원 사용량 주기적 JSON 저장

[🟡 NORMAL] ## 미션 #4 — B단계: 자원 사용량 주기적 JSON 저장 ### 목표 `scripts/metrics_snapshot.py`가 이미 존재한다 (A단계 완료). 이제 **주기적으로 현재 자원 스냅샷을 JSON 파일에 누적 저장**하는 기능을 추가한다. sar의 7일 보존 한계를 넘어 무한정 기록을 유지하는 것이 목적. ### 구현 내용 #### 1. `scripts/metrics_collector.py` 신규 작성 - 매 실행 시 현재 시점의 CPU/메모리/디스크/네트워크 수치를 수집 - `/home/grass/leninbot/data/metrics/YYYY-MM.json` 에 월별 파일로 누적 저장 - 데이터 구조 (각 항목은 배열에 append): ```json { "snapshots": [ { "ts": "2026-03-26T07:30:00", "cpu_pct": 12.3, "mem_pct": 55.2, "mem_used_gib": 8.7, "mem_total_gib": 15.5, "disk_tps": 4.2, "net_rx_kbs": 120.5, "net_tx_kbs": 45.2 } ] } ``` - 파일이 없으면 새로 생성, 있으면 `snapshots` 배열에 append (파일 전체를 읽고 쓰는 방식) - 데이터 수집은 `sar` 명령어 사용 (현재 1분 간격 데이터: `sar -u 1 1`, `sar -r 1 1` 등) - 네트워크 인터페이스는 `eth0` 우선, 없으면 첫 번째 non-lo 인터페이스 #### 2. cron 등록 - `/etc/cron.d/leninbot-metrics` 파일 작성: ``` */10 * * * * root /usr/bin/python3 /home/grass/leninbot/scripts/metrics_collector.py >> /home/grass/leninbot/logs/metrics_collector.log 2>&1 ``` - 10분 간격 (sar와 동일 주기) #### 3. `scripts/metrics_snapshot.py` 수정 - `--source json` 옵션 추가: JSON 파일에서 데이터를 읽어 그래프 출력 - `--source sar` (기존 기본값 유지) - JSON 소스 사용 시 원하는 기간만큼 월별 파일을 자동으로 합쳐서 읽음 - 예: `--hours 720` (30일) 요청 시 2개 월별 파일을 합쳐서 처리 #### 4. 즉시 테스트 실행 - `python3 scripts/metrics_collector.py` 실행해서 JSON 파일 생성 확인 - 생성된 JSON 내용 출력 #### 5. 로그 디렉토리 확인 - `logs/` 디렉토리 없으면 생성 ### 파일 경로 정리 - 신규: `scripts/metrics_collector.py` - 수정: `scripts/metrics_snapshot.py` (--source 옵션 추가) - 신규: `/etc/cron.d/leninbot-metrics` - 신규: `data/metrics/YYYY-MM.json` (실행 시 자동 생성) - 신규: `logs/metrics_collector.log` (cron 로그) ### 완료 조건 1. `metrics_collector.py` 실행 성공 → JSON 파일에 데이터 1건 이상 저장 2. cron 등록 완료 (`crontab -l` 또는 파일 확인) 3. `metrics_snapshot.py --source json --hours 1` 실행 시 JSON 데이터 기반 그래프 출력 4. 결과를 태스크 리포트에 명확히 기록