Files

233 lines
6.1 KiB
Markdown

# ChocoMae 24/7 모니터링 설정 가이드
## 개요
이 모니터링 스크립트는 EC2 인스턴스(t3a.medium, Ubuntu 24.04.1 LTS)의 성능 지표를 1주일 동안 수집합니다.
- **모니터링 대상**: Apache(WEB), PHP-FPM(WAS), MariaDB(DB)
- **수집 간격**: 1분
- **보관 기간**: 7일 (자동 rotation)
- **저장 형식**: CSV
---
## 설치 및 실행
### 1. 사전 요구사항
```bash
# 필수 패키지 설치
sudo apt-get update
sudo apt-get install -y sysstat curl
# iostat 확인
which iostat
# /usr/bin/iostat가 있어야 DISK IO 정보 수집 가능
```
### 2. 스크립트 배치
```bash
# 스크립트 복사
sudo cp chocomae-24h-monitoring.sh /home/ubuntu/
# 실행 권한 설정
sudo chmod +x /home/ubuntu/chocomae-24h-monitoring.sh
# 모니터링 디렉토리 생성
sudo mkdir -p /home/ubuntu/chocomae-monitoring
sudo chown ubuntu:ubuntu /home/ubuntu/chocomae-monitoring
```
### 3. Cron 등록 (선택사항)
시스템 부팅 시 자동으로 모니터링을 시작하려면:
```bash
sudo crontab -e
# 다음 라인 추가:
@reboot /home/ubuntu/chocomae-24h-monitoring.sh > /home/ubuntu/chocomae-monitoring/monitor.log 2>&1 &
```
또는 `systemd` 서비스로 등록하려면:
```bash
# /etc/systemd/system/chocomae-monitoring.service 생성
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
```
### 4. 수동 실행
```bash
cd /home/ubuntu
./chocomae-24h-monitoring.sh &
# 프로세스 확인
ps aux | grep chocomae-24h-monitoring
```
---
## 수집 지표 상세
| 지표 | 설명 | 단위 |
|------|------|------|
| **Apache** |
| apache_cpu | Apache 프로세스 CPU 사용률 | % |
| apache_mem | Apache 프로세스 메모리 사용량 | MB |
| apache_busy_workers | 요청 처리 중인 Worker 수 | 개 |
| apache_idle_workers | 대기 중인 Worker 수 | 개 |
| apache_ka_connections | Keep-Alive 연결 수 | 개 |
| apache_total_accesses | 누적 요청 수 | 개 |
| **PHP-FPM** |
| php_cpu | PHP-FPM 프로세스 CPU 사용률 | % |
| php_mem | PHP-FPM 프로세스 메모리 사용량 | MB |
| php_conn_count | PHP-FPM 프로세스 개수 | 개 |
| **MariaDB** |
| mariadb_cpu | MariaDB CPU 사용률 | % |
| mariadb_mem | MariaDB 메모리 사용량 | MB |
| mariadb_conn_current | 현재 연결 수 | 개 |
| mariadb_conn_max | 최대 사용된 연결 수 | 개 |
| mariadb_threads_running | 실행 중인 스레드 수 | 개 |
| mariadb_slow_queries | Slow Query 누적 수 | 개 |
| **디스크** |
| disk_root_usage_percent | 루트 파티션 사용률 | % |
| disk_root_free_gb | 루트 파티션 여유 공간 | GB |
| disk_io_read_mb_s | 디스크 읽기 속도 | MB/s |
| disk_io_write_mb_s | 디스크 쓰기 속도 | MB/s |
| **시스템** |
| system_cpu_usage_percent | 전체 시스템 CPU 사용률 | % |
| system_mem_usage_percent | 전체 시스템 메모리 사용률 | % |
| system_mem_free_gb | 전체 시스템 여유 메모리 | GB |
---
## 로그 파일 구조
### 저장 위치
```
/home/ubuntu/chocomae-monitoring/
├── chocomae-20260921.log # 2026-09-21 데이터
├── chocomae-20260922.log # 2026-09-22 데이터
└── ...
```
### 파일 포맷 (CSV)
```
timestamp,apache_cpu,apache_mem,apache_conn_count,php_cpu,...
2026-09-21 14:30:00,5.2,180,50,2.1,...
2026-09-21 14:31:00,6.1,185,52,2.3,...
```
---
## 문제 해결
### 1. MariaDB 연결 실패
```bash
# sudo 비밀번호 입력 없이 mariadb 명령 실행 설정
sudo visudo
# 다음 라인 추가:
ubuntu ALL=(ALL) NOPASSWD: /usr/bin/mariadb
```
### 2. iostat 명령 없음
```bash
sudo apt-get install -y sysstat
```
### 3. Apache /server-status 접근 불가
```bash
# Apache 설정 확인
sudo a2enmod status
sudo apache2ctl configtest
sudo systemctl restart apache2
```
### 4. 로그 파일 접근 권한 문제
```bash
sudo chown ubuntu:ubuntu /home/ubuntu/chocomae-monitoring
sudo chmod 755 /home/ubuntu/chocomae-monitoring
```
---
## 데이터 분석
수집된 데이터는 CSV 형식으로, 다음과 같은 도구로 분석 가능합니다:
### Python 예시
```python
import pandas as pd
import matplotlib.pyplot as plt
# CSV 파일 로드
df = pd.read_csv('/home/ubuntu/chocomae-monitoring/chocomae-20260921.log')
# 시간대별 평균 CPU 사용률
df['hour'] = pd.to_datetime(df['timestamp']).dt.hour
hourly_cpu = df.groupby('hour')['system_cpu_usage_percent'].mean()
hourly_cpu.plot(title='시간대별 CPU 사용률')
plt.show()
# 피크 타임 분석
peak_time = df[
(df['timestamp'] >= '2026-09-21 13:00:00') &
(df['timestamp'] <= '2026-09-21 15:00:00')
]
print(f"피크 타임 평균 CPU: {peak_time['system_cpu_usage_percent'].mean():.2f}%")
```
---
## 성능 최적화 팁
- **모니터링 주기**: 1분이 기본값. 더 자세한 분석이 필요하면 30초로 조정 가능
- **저장 공간**: 1분 간격으로 7일 데이터 ≈ 10KB/일
- **대역폭 영향**: 미미함 (초당 <1KB)
---
## Serverless 마이그레이션 체크리스트
수집된 데이터로 다음을 검토하세요:
- [ ] **동시 사용자 수** (Apache busy_workers, MariaDB connections)
- [ ] **피크 시간대** (시간별 CPU, 메모리 사용률)
- [ ] **데이터베이스 부하** (MariaDB slow queries, threads_running)
- [ ] **메모리 요구사항** (Peak memory usage)
- [ ] **처리량** (Requests per second)
- [ ] **응답 시간** (필요하면 애플리케이션 로그와 연관 분석)
---
## 참고사항
- 스크립트는 `ubuntu` 사용자로 실행되어야 합니다
- MariaDB 접근 시 sudo 권한이 필요하므로 설정을 확인하세요
- 네트워크 지연이나 서버 과부하로 인해 일부 메트릭 수집이 실패할 수 있습니다 (NA로 기록)