모니터링 & 알림
마켓메이커가 모니터링하고 알림을 설정해야 할 항목입니다.
헬스 체크
API 헬스
엔드포인트: GET /health
응답: { "status": "ok" }
모니터링: 30-60초마다 체크
알림: 헬스 체크가 실패하면 API 서버가 다운되었을 수 있습니다
WebSocket 연결
모니터링: WebSocket 연결 상태 추적
알림: 연결이 끊어지면 즉시 재연결합니다
모범 사례: 재연결 시 지수 백오프(exponential backoff)를 구현합니다
주문 모니터링
거부율
지표: 거부된 주문의 비율
알림: 거부율이 5%를 초과하면 다음을 점검합니다:
- 증거금 문제
- 티어 제한
- 만기가 지난 종목
- 시스템 과부하
체결률
지표: 체결된 주문의 비율
알림: 체결률이 크게 떨어지면 다음을 점검합니다:
- 시장 상황
- 호가 경쟁력
- 호가창 깊이
주문 지연시간
지표: 주문 제출부터 체결/확인(ack)까지 걸리는 시간
알림: 지연시간이 1초를 초과하면 다음을 점검합니다:
- 시스템 과부하
- 네트워크 문제
- 엔진 처리 지연
포트폴리오 모니터링
증거금 사용률
지표: total_margin_used / balance
알림: 증거금 사용률이 80%를 초과하면 다음을 고려합니다:
- 포지션 규모 축소
- 담보 추가
- 포지션 청산(정리)
현금 잔고
지표: 계정 현금 잔고
알림: 현금 잔고가 임계값 미만이면 자금을 입금합니다(구현 시)
MMP 모니터링
MMP 트리거
지표: 시간당 MMP 트리거 횟수
알림: MMP가 자주 트리거되면 다음을 고려합니다:
- MMP 한도 상향
- 호가 제출 빈도 축소
- 체결 패턴 검토
MMP 취소율
지표: MMP에 의해 취소된 주문의 비율
알림: MMP 취소율이 10%를 초과하면 MMP 설정을 검토합니다
시스템 모니터링
API 응답 시간
지표: P50, P95, P99 응답 시간
알림: P95가 500ms를 초과하면 시스템 부하를 점검합니다
WebSocket 메시지 속도
지표: WebSocket의 초당 메시지 수
알림: 메시지 속도가 급증하면 다음을 점검합니다:
- 시장 변동성
- 시스템 과부하
- 메시지 처리 지연
권장 알림
- 헬스 체크 실패: API 서버 다운
- 높은 거부율: 주문 거부율 5% 초과
- 낮은 체결률: 주문 체결률 50% 미만 (상황에 따라 다름)
- 높은 증거금 사용률: 증거금 사용률 80% 초과
- MMP 트리거: 시간당 5회 초과
- WebSocket 연결 끊김: 연결 유실
- 높은 지연시간: P95 500ms 초과
모니터링 도구
권장:
- 가동시간 모니터링을 위한 헬스 체크 엔드포인트
- WebSocket 연결 상태 추적
- 정확성을 위한 주문/체결 대사(reconciliation)
- 포트폴리오 증거금 추적
현재: 기본 제공 모니터링 대시보드는 없습니다. 외부 도구(예: Prometheus, Grafana)를 사용하십시오.