311 lines
7.6 KiB
Markdown
311 lines
7.6 KiB
Markdown
# 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@<your-ec2-instance>
|
|
|
|
# 필수 패키지 설치
|
|
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@<your-ec2-instance>:/home/ubuntu/
|
|
scp analyze_monitoring.py ubuntu@<your-ec2-instance>:/home/ubuntu/
|
|
|
|
# 또는 서버에서 직접 생성
|
|
# (파일 내용을 복사하여 /home/ubuntu/chocomae-24h-monitoring.sh 생성)
|
|
```
|
|
|
|
### 4. 권한 설정
|
|
|
|
```bash
|
|
ssh ubuntu@<your-ec2-instance>
|
|
|
|
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@<instance>` → `./chocomae-24h-monitoring.sh &`
|
|
|
|
**1주일 후**: `python3 analyze_monitoring.py /home/ubuntu/chocomae-monitoring`
|
|
|
|
**이 가이드를 완료하는 데 약 10-15분이 소요됩니다.**
|