docs: 시스템 메트릭 문서 미해결 섹션 제거 및 해결 완료 표시

- "미해결 문제" → "최종 해결 (2025-07-15)"
- Prometheus + Grafana 대체 사실 명시
- frontend-base/backend/metrics_database.py 참조 추가
- "후속 작업" 섹션 삭제 (완료됨)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
happybell80 2025-10-15 12:17:47 +09:00
parent 6a61fba2b7
commit d2120d93a9

View File

@ -108,10 +108,12 @@ backend/
- `GET /admin/metrics/history/{period}` - 기간별 메트릭 히스토리
- `POST /admin/metrics/collect` - 수동 메트릭 수집
## 미해결 문제
**현재 상태**: 테이블 구조 불일치로 인한 메트릭 데이터 삽입 실패
**증상**: `column "timestamp" of relation "system_metrics" does not exist`
**예상 원인**: 코드 내 일부 SQL 쿼리에서 여전히 `timestamp` 컬럼 참조
## 최종 해결 (2025-07-15)
**상태**: 메트릭 수집 비활성화 (Prometheus + Grafana로 대체)
**관련 파일**: frontend-base/backend/metrics_database.py:58-60, 78-80, 148-150
**해결 방법**: system_metrics 테이블 사용 중단, TODO 주석 처리
**참고**: 아래 Prometheus + Grafana 방식으로 완전 전환
## 학습 포인트
1. **Docker 네트워크**: 컨테이너간 통신 시 서비스 이름 사용
@ -120,13 +122,7 @@ backend/
4. **데이터베이스 스키마**: 코드와 실제 테이블 구조 일치 중요성
5. **PostgreSQL 인증**: Docker 환경에서 비밀번호 설정 필요
## 후속 작업
1. 테이블 구조 불일치 문제 완전 해결
2. 메트릭 데이터 수집 정상 동작 확인
3. 그래프에 실제 데이터 표시 검증
4. 성능 최적화 및 에러 핸들링 개선
## (*update*) `node-exporter` + `Prometheus` + `Grafana` 를 이용한 compute 자원 모니터링
## `node-exporter` + `Prometheus` + `Grafana` 를 이용한 compute 자원 모니터링
해당 문서는 직접 개발하는 방식이 아닌 기존에 널리 쓰이는</br>
`node-exporter` + `Prometheus` + `Grafana`를 이용하여</br>