docs: 헬스체크 빈도 과다로 인한 로그 오염 문제 문서화

- 매 30초마다 실행되는 헬스체크로 인한 로그 과부하 문제
- 하루 8,640개의 불필요한 로그 생성
- robeing-monitor 404 에러 지속
- 해결책 및 개선 방안 제시

troubleshooting/250921_happybell80_healthcheck_frequency_issue.md

@@ -0,0 +1,76 @@
+# 헬스체크 빈도 과다로 인한 로그 오염 문제
+
+**작성일**: 2025-09-21
+**작성자**: happybell80
+**상태**: 문제 확인
+
+## 문제 현상
+
+rb8001 서비스가 매 30초마다 다른 서비스들의 헬스체크를 수행하면서 과도한 로그를 생성하고 있음.
+
+### 로그 패턴
+```
+{"time":"2025-09-21 23:24:33,703","level":"INFO","module":"httpx","msg":"HTTP Request: GET http://172.17.0.1:8501/health "HTTP/1.1 200 OK""}
+{"time":"2025-09-21 23:24:33,705","level":"INFO","module":"httpx","msg":"HTTP Request: GET http://localhost:8505/health "HTTP/1.1 200 OK""}
+{"time":"2025-09-21 23:24:33,707","level":"INFO","module":"httpx","msg":"HTTP Request: GET http://localhost:9024/health "HTTP/1.1 404 Not Found""}
+```
+
+## 문제점
+
+1. **로그 과부하**
+   - 매 30초마다 3개 서비스 체크 = 분당 6개, 시간당 360개, 하루 8,640개 로그
+   - 실제 에러나 중요한 이벤트 로그가 헬스체크 로그에 묻힘
+   - 로그 분석 및 디버깅 어려움
+
+2. **리소스 낭비**
+   - 불필요한 네트워크 요청
+   - 로그 파일 용량 증가
+   - 로그 로테이션 빈도 증가
+
+3. **모니터링 실효성 부족**
+   - robeing-monitor (9024) 계속 404 반환
+   - 30초 간격은 실시간 모니터링으로는 부족, 로깅으로는 과다
+
+## 현재 설정 위치 (추정)
+
+- rb8001 서비스 내부 스케줄러 또는 백그라운드 태스크
+- APScheduler 또는 asyncio 기반 정기 실행
+
+## 제안 해결책
+
+### 1. 즉시 조치
+- 헬스체크 간격을 5분(300초)으로 증가
+- robeing-monitor 404 문제 해결 또는 체크 제외
+
+### 2. 로그 레벨 조정
+```python
+# httpx 로거 레벨을 WARNING으로 상향
+logging.getLogger("httpx").setLevel(logging.WARNING)
+
+# 또는 헬스체크 전용 로거 분리
+health_logger = logging.getLogger("healthcheck")
+health_logger.setLevel(logging.WARNING)
+```
+
+### 3. 장기 개선
+- 헬스체크 결과를 메모리에 캐싱
+- 상태 변경 시에만 로그 기록
+- Prometheus 등 전문 모니터링 도구 도입 검토
+
+## 영향 범위
+
+- rb8001 로그 파일
+- Docker 컨테이너 로그 (json-file 드라이버)
+- /mnt/51123logs 백업 로그
+
+## 관련 문서
+
+- 250908_rb8001_logging_issues.md - 로깅 시스템 구현
+- 250817_robeing_monitor_integration.md - robeing-monitor 통합
+
+## 다음 단계
+
+1. rb8001 코드에서 헬스체크 스케줄러 찾기
+2. 간격 설정을 환경변수로 외부화
+3. robeing-monitor health 엔드포인트 구현 또는 제거
+4. 로그 레벨 정책 수립