자동 완화 (Control Signal)
이 문서가 답하는 질문: 키 오류가 급증할 때 전체 서비스가 아니라 문제 scope만 자동으로 격리하려면 어떻게 해야 하는가?
핵심 개념
섹션 제목: “핵심 개념”- 한 줄 정의:
CryptoCircuitController는 실패 지표를 받아 scope별 회로 상태를 전환합니다. - 왜 필요한가: 한 테넌트/프로바이더/키 문제가 전체 트래픽으로 번지는 것을 막습니다.
- 설정 예시(
safe): scope=tenant+provider+kid, key/AAD/kid 불일치 계열만 auto-open - 흔한 실수: 일반 네트워크 오류까지 auto-open 대상으로 포함
상태 전이
섹션 제목: “상태 전이”closed: 정상open: 임계치 초과 시 격리half-open: cooldown 후 소량 재시도closed: 정상 응답이 확인되면 복구
운영 이벤트
섹션 제목: “운영 이벤트”- 구조화 이벤트: state, scope, reason, errorClass
- 메트릭:
crypto_circuit_state,crypto_circuit_open_count - 런북 트리거: open 전이 시 운영자 알림 자동 발행
위험 라벨
섹션 제목: “위험 라벨”safe: key 오류 계열만 자동 격리caution: 임계치가 너무 낮아 과민 반응unsafe: scope 없이 글로벌 격리