# ChocoMae 모니터링 - 빠른 시작 가이드 ## 📌 개요 **목적**: EC2 인스턴스(t3a.medium)에서 1주일간 24시간 성능 지표를 수집하여 Serverless 마이그레이션 준비 **모니터링 대상**: - WEB: Apache - WAS: PHP-FPM - DB: MariaDB - System: CPU, Memory, Disk **수집 주기**: 1분 간격 (1주일 = ~10,000개 레코드) --- ## 🚀 설치 (5분) ### 1. 서버 접속 및 필수 패키지 설치 ```bash ssh ubuntu@ # 필수 패키지 설치 sudo apt-get update sudo apt-get install -y sysstat curl python3 python3-pandas # iostat 확인 (DISK IO 수집용) which iostat ``` ### 2. Sudo 설정 (MariaDB 비밀번호 없이 접근) ```bash sudo visudo # 다음 라인을 파일 끝에 추가: ubuntu ALL=(ALL) NOPASSWD: /usr/bin/mariadb ``` ### 3. 스크립트 배포 ```bash # 로컬에서 실행 scp chocomae-24h-monitoring.sh ubuntu@:/home/ubuntu/ scp analyze_monitoring.py ubuntu@:/home/ubuntu/ # 또는 서버에서 직접 생성 # (파일 내용을 복사하여 /home/ubuntu/chocomae-24h-monitoring.sh 생성) ``` ### 4. 권한 설정 ```bash ssh ubuntu@ chmod +x /home/ubuntu/chocomae-24h-monitoring.sh mkdir -p /home/ubuntu/chocomae-monitoring ``` --- ## ⚙️ 실행 방법 (3가지) ### 방법 1: 간단하게 백그라운드 실행 (즉시 시작) ```bash /home/ubuntu/chocomae-24h-monitoring.sh & ``` ### 방법 2: Systemd 서비스로 자동 관리 (권장) ```bash # 서비스 파일 생성 sudo tee /etc/systemd/system/chocomae-monitoring.service > /dev/null <<'EOF' [Unit] Description=ChocoMae 24/7 Monitoring After=network.target [Service] Type=simple User=ubuntu WorkingDirectory=/home/ubuntu ExecStart=/home/ubuntu/chocomae-24h-monitoring.sh Restart=always RestartSec=10 [Install] WantedBy=multi-user.target EOF # 서비스 등록 및 시작 sudo systemctl daemon-reload sudo systemctl enable chocomae-monitoring.service sudo systemctl start chocomae-monitoring.service # 상태 확인 sudo systemctl status chocomae-monitoring.service ``` ### 방법 3: Cron으로 부팅 시 자동 실행 ```bash crontab -e # 다음 라인 추가: @reboot /home/ubuntu/chocomae-24h-monitoring.sh > /home/ubuntu/chocomae-monitoring/monitor.log 2>&1 & ``` --- ## 📊 모니터링 확인 ### 실행 확인 ```bash # 프로세스 확인 ps aux | grep chocomae-24h-monitoring # 로그 파일 확인 ls -lh /home/ubuntu/chocomae-monitoring/ # 실시간 로그 보기 tail -f /home/ubuntu/chocomae-monitoring/chocomae-$(date +%Y%m%d).log ``` ### 로그 형식 ``` timestamp,apache_cpu,apache_mem,... 2026-09-21 14:30:00,5.2,180,50,... 2026-09-21 14:31:00,6.1,185,52,... ``` --- ## 📈 데이터 분석 (1주일 후) ### 1. 자동 분석 (권장) ```bash # Python 분석 스크립트 실행 python3 /home/ubuntu/analyze_monitoring.py /home/ubuntu/chocomae-monitoring # 결과를 파일로 저장 python3 /home/ubuntu/analyze_monitoring.py /home/ubuntu/chocomae-monitoring > report.txt ``` ### 2. 생성되는 분석 항목 ✅ 시스템 전체 통계 (CPU, 메모리 평균/최대/최소) ✅ **시간대별 분석 (피크 타임 파악)** ✅ 요일별 분석 ✅ Apache 성능 (Workers, Keep-Alive, 처리량) ✅ MariaDB 성능 (연결, 스레드, Slow Queries) ✅ PHP-FPM 성능 ✅ 디스크 성능 (용량, IO) ✅ **이상 탐지** (CPU/메모리 스파이크) ✅ **🎯 Serverless 마이그레이션 권고사항** ### 3. 수동 분석 ```bash # CSV 데이터 병합 cat /home/ubuntu/chocomae-monitoring/chocomae-*.log > all_data.csv # Excel/Sheets에서 분석 또는 Python으로 커스텀 분석 python3 << 'EOF' import pandas as pd df = pd.read_csv('all_data.csv') # 피크 타임 확인 df['hour'] = pd.to_datetime(df['timestamp']).dt.hour print(df.groupby('hour')['system_cpu_usage_percent'].mean()) # 최대 메모리 사용 print(f"Max memory: {df['system_mem_usage_percent'].max()}%") EOF ``` --- ## 🎯 Serverless 마이그레이션 준비 체크리스트 분석 결과로 다음을 검토하세요: ### 데이터베이스 - [ ] 동시 연결 수 확인 → RDS Aurora 메모리 크기 결정 - [ ] Slow Query 확인 → 쿼리 최적화 목록 작성 - [ ] Connection Pool 설정 → RDS Proxy 도입 검토 ### 애플리케이션 - [ ] Peak CPU/Memory → Lambda 메모리 할당 (권고: 1024~3008MB) - [ ] Peak RPS → Lambda 동시 실행 제한 설정 - [ ] Session/State 관리 → DynamoDB/ElastiCache 마이그레이션 ### 인프라 - [ ] API Gateway 스로틀링 설정 - [ ] CloudWatch 로그 및 X-Ray 추적 설정 - [ ] S3 + CloudFront (정적 자산) - [ ] Secrets Manager (환경 변수) --- ## 🔍 문제 해결 | 증상 | 해결방법 | |------|---------| | `Permission denied` | `chmod +x chocomae-24h-monitoring.sh` | | MariaDB 접근 실패 | sudo visudo에서 NOPASSWD 설정 | | `iostat: command not found` | `sudo apt-get install -y sysstat` | | Apache `/server-status` 오류 | `sudo a2enmod status && sudo systemctl restart apache2` | | 로그 파일 없음 | `mkdir -p /home/ubuntu/chocomae-monitoring` | --- ## 📋 수집되는 지표 (전체) ### Apache (WEB) - cpu, mem, busy_workers, idle_workers, ka_connections, total_accesses ### PHP-FPM (WAS) - cpu, mem, process_count ### MariaDB (DB) - cpu, mem, connections, max_connections, threads_running, slow_queries ### 시스템 - cpu_usage, mem_usage, mem_free, disk_usage, disk_free, disk_io_read, disk_io_write --- ## 📚 상세 가이드 더 자세한 내용은 다음 문서를 참조하세요: - **README.md** - 전체 개요 및 분석 가이드 - **MONITORING_SETUP.md** - 설치, 설정, 문제 해결 - **chocomae-24h-monitoring.sh** - 스크립트 코드 및 주석 - **analyze_monitoring.py** - 분석 스크립트 코드 및 함수 설명 --- ## 💡 팁 ### 1. 모니터링 주기 조정 ```bash # 스크립트 내 INTERVAL 변수 수정 # INTERVAL=60 (기본값, 1분) # INTERVAL=30 (더 자세한 데이터, 저장 용량 2배) ``` ### 2. 특정 시간대만 분석 ```python import pandas as pd df = pd.read_csv('all_data.csv') df['timestamp'] = pd.to_datetime(df['timestamp']) # 평일 오후 1~3시만 분석 peak = df[ (df['timestamp'].dt.hour >= 13) & (df['timestamp'].dt.hour < 15) & (df['timestamp'].dt.weekday < 5) # 월~금 ] print(peak['system_cpu_usage_percent'].describe()) ``` ### 3. 특정 이슈 추적 ```bash # Slow Query 급증 확인 grep "mariadb_slow_queries" /home/ubuntu/chocomae-monitoring/chocomae-*.log | tail -50 # 메모리 스파이크 확인 grep -E "^[0-9]{4}-[0-9]{2}-[0-9]{2}" /home/ubuntu/chocomae-monitoring/chocomae-*.log | \ awk -F',' '$10 > 90 {print $0}' ``` --- ## ✅ 완료 체크리스트 - [ ] 필수 패키지 설치 완료 - [ ] sudo NOPASSWD 설정 완료 - [ ] 스크립트 배포 및 권한 설정 완료 - [ ] 모니터링 시작 확인 (로그 파일 생성) - [ ] 1주일 후 데이터 수집 완료 - [ ] Python 분석 스크립트 실행 - [ ] Serverless 마이그레이션 체크리스트 작성 - [ ] AWS 인프라 설계 시작 --- ## 📞 피드백 및 커스터마이징 **스크립트 커스터마이징이 필요하면:** - 모니터링 주기 조정: `INTERVAL` 변수 수정 - 추가 지표 수집: `get_*_metrics()` 함수 확장 - 데이터 보관 기간: `LOG_RETENTION_DAYS` 수정 **분석 스크립트 커스터마이징이 필요하면:** - `analyze_monitoring.py`의 함수 추가/수정 - 자체 분석 로직 구현 (pandas 기반) --- **시작하기**: `ssh ubuntu@` → `./chocomae-24h-monitoring.sh &` **1주일 후**: `python3 analyze_monitoring.py /home/ubuntu/chocomae-monitoring` **이 가이드를 완료하는 데 약 10-15분이 소요됩니다.**