모니터링 및 알림
마켓메이커가 모니터링하고 알림을 설정해야 할 항목입니다.
헬스 체크
API 상태
엔드포인트: GET /health
응답: {"status":"ok"}
준비 상태: GET /ready는 컴포넌트별 ready 플래그와 함께 {"status":"ready","components":[...]}를 반환합니다. 접속은 가능하지만 아직 요청을 처리하지 않는 API와 정상 상태의 API를 구분하는 데 사용하십시오.
모니터링: 30~60초마다 확인합니다
알림: 헬스 체크가 실패하면 API 서버가 다운되었을 수 있습니다
WebSocket 연결
모니터링: WebSocket 연결 상태를 추적합니다
알림: 연결이 끊기면 즉시 재연결합니다
모범 사례: 재연결 시 지수 백오프(exponential backoff)를 구현합니다
주문 모니터링
거부율
지표: 거부된 주문의 비율
알림: 거부율이 5%를 초과하면 다음을 점검합니다.
- 증거금 문제
- 티어 제한
- 만기된 상품
- 시스템 과부하
체결률
지표: 체결된 주문의 비율
알림: 체결률이 크게 떨어지면 다음을 점검합니다.
- 시장 상황
- 호가 경쟁력
- 호가창 깊이
주문 지연 시간
지표: 주문 제출부터 체결/확인(ack)까지 걸리는 시간
알림: 지연 시간이 1초를 초과하면 다음을 점검합니다.
- 시스템 과부하
- 네트워크 문제
- 엔진 처리 지연
포트폴리오 모니터링
증거금 사용률
지표: GET /portfolio?wallet=...의 margin_summary로 계산한 증거금 사용률. margin_summary.initial_margin과 margin_summary.maintenance_margin은 요건을 차감한 뒤 남은 **여유분(headroom)**이며, 사용 중인 증거금이 아닙니다. 각 모드에서 실제로 증거금을 뒷받침하는 기준값으로 사용률을 계산합니다.
margin_summary.mode | 기준값 | 개시증거금 여유분 | 유지증거금 여유분 |
|---|---|---|---|
portfolio | equity | initial_margin | maintenance_margin |
standard | standard_margin.cash_margin | standard_margin.initial_margin_headroom | standard_margin.maintenance_margin_headroom |
im_utilization = (basis - initial_margin_headroom) / basis
mm_utilization = (basis - maintenance_margin_headroom) / basis
기준값이 0 이하이면 사용률 100%로 취급합니다.
알림: 개시증거금 사용률이 80%를 넘으면 신규 주문이 거부되기 직전입니다. 유지증거금 사용률이 100%에 가까워지면 계정이 청산에 가까워진 상태입니다. 다음을 고려합니다.
- 포지션 규모 축소
- 담보 추가
- 포지션 청산
가용 담보
지표: GET /portfolio?wallet=...의 available_balance. 신규 거래에 쓸 수 있는 가용 담보이며 USDC 현금 잔고가 아닙니다. 옵션 마크, 무기한 선물 손익, 증거금 요건에 따라 현금 이동 없이 변합니다. 출금 가능 금액은 withdrawable_usdc를 사용합니다.
알림: 가용 담보가 기준치 미만이면 위험을 줄이거나 자금을 입금합니다
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 연결 상태 추적
- 정확성 확인을 위한 주문/체결 대사
- 포트폴리오 증거금 추적
현재: 내장 모니터링 대시보드는 제공되지 않습니다. 외부 도구(예: Prometheus, Grafana)를 사용하십시오.