드라이런이란?
드라이런(Dry Run)은 단일 입력 fact가 특정 정책 버전의 규칙에 대해 어떻게 평가되는지 부작용 없이 테스트합니다. 실행 로그가 기록되지 않고, 과금되지 않으며 요금제 사용량에도 잡히지 않습니다. 대신 분당 한도가 따로 있습니다. 규칙에 대한 단위 테스트라고 보면 됩니다.드라이런 vs 변경 영향 시뮬레이션 vs 의사결정 재실행: 드라이런은 빠른 검증을 위해 직접 입력한 하나의 값을 테스트합니다. 변경 영향 시뮬레이션은 수백~수천 개의 과거 입력에 버전을 돌려 비교 기준 버전과 결과를 맞대 봅니다. 의사결정 재실행(Decision Replay)은 실제 과거 결정 하나를 후보 버전으로 재평가해 결과를 diff합니다. 개발 중에는 드라이런을, 배포 전 회귀 검증에는 시뮬레이션을, “바로 이 프로덕션 결정은 어떻게 됐을까”라는 질문에는 재실행을 사용하세요.
언제 사용하나요
- 규칙을 만들거나 수정한 직후: 의도한 입력에 매칭되는지 확인
- DRAFT 버전을 발행하기 전: 안전망
- 예상과 다른 실행 결과를 디버깅할 때: 시나리오 재현
- 두 버전을 동일 입력으로 비교하고 싶을 때 (Dry Run Compare)
드라이런 실행
콘솔
정책 버전 페이지 → Dry Run 탭 → 입력 fact 입력 → Run 클릭.CLI
API
403(A-002)을 받습니다. 범위를 참고하세요.
요청 메타데이터는 실행 호출처럼 contexts에 담습니다. 드라이런은 facts, contexts, includeDebugInfo만, 비교는 facts, contexts, versionIdA, versionIdB만 받습니다. 그 밖의 칸은 비어 있어도 400(C-001)으로 실패합니다. 옛 이름 context도 여기에 듭니다.
응답
versionNo는 실행한 버전의 번호이고 latencyMs는 평가에 걸린 시간(밀리초)입니다. inputContexts는 보낸 contexts이고, 보내지 않았으면 {}입니다. 드라이런은 실행 이력에 남지 않아서 응답에 traceId와 executedAt이 없습니다.
상태 3 층위 (State Layers)
data 객체는 상태를 세 층위로 명시적으로 분리해 노출합니다. 한 덩어리로 합쳐서 돌려주지 않습니다.
inputFacts: 요청에서 받은 입력 fact (정규화 후).mutatedFacts: 규칙 액션에 의해 값이 변경된 fact만.generatedVariables: 규칙 액션이 새로 생성한 변수 (입력에 없었던 것). 액션별 변화 키도 포함됩니다.{targetVar}__delta는MUTATE_FACT가 적용한 부호 포함 변화량입니다.
{ ...inputFacts, ...mutatedFacts, ...generatedVariables }로 재구성할 수 있습니다. 분리해서 돌려주는 이유는 감사·재현·디버그가 결정적이어야 하기 때문입니다. 어떤 값이 어디서 왔는지가 항상 명확합니다.
실행 트레이스 (Execution Traces)
엔진이 평가한 모든 규칙은 실행 트레이스 하나를 남깁니다. 트레이스는 어떤 매칭 표현식이 검증됐는지, 어떤 액션이 생성됐는지를 기록합니다:policyGroupId, policyVersionId, ruleId)가 모든 트레이스를 그 자체로 식별할 수 있게 만듭니다. 외부 조회 없이도 어느 그룹·버전·규칙에서 나온 트레이스인지 알 수 있습니다. 규칙이 본 입력 fact는 inputFacts이고, 응답은 그것을 트레이스마다 되풀이하지 않고 한 번만 싣습니다.
의사결정 트레이스 (Decision Traces)
실행 트레이스가 무엇을 평가했는가를 기록한다면, 의사결정 트레이스는 무엇이 선택됐는가를 기록합니다. 모든 규칙은decisionTraces에 최종 status와 그 사유 코드와 함께 등장합니다:
status는 결과의 상위 분류를, reasonCode는 그 분류 안의 구체적 사유를 담습니다.
reasonDetail은 nullable이며, 엔진이 추가로 노출할 컨텍스트가 있을 때 사람이 읽을 수 있는 메시지가 들어갑니다 (예: 도달한 구체적 한도 값).
status와 reasonCode의 전체 값 목록과 매핑은 정책 규칙의 Decision Trace를 참조하세요.요구사항 확인
드라이런 전에 버전이 기대하는 fact를 확인하세요:드라이런 비교
두 버전이 동일한 입력에 대해 어떻게 평가하는지 나란히 비교합니다.diff가 담깁니다.
diff에는 두 버전에서 값이 다른 키만 실립니다. before는 버전 A의 값, after는 버전 B의 값입니다.
한도
조직마다 1분에 60회까지, 하루에 1,000회까지 평가할 수 있고, 아래 호출과 모든 콘솔 사용자, API 키가 이 횟수를 함께 씁니다. 이 호출들은 요금제의 TPS와 월 한도를 쓰지 않습니다.
분당 한도를 넘은 호출은
429(C-007)를 받습니다. 1분 기다린 뒤 다시 보내세요. 하루 한도를 넘은 호출은 429(AN-041)를 받습니다. UTC 0시가 지나면 다시 보내세요. 입력 여럿을 한꺼번에 시험하려면 변경 영향 시뮬레이션을 쓰세요.
드라이런에 보내는 facts와 contexts의 값에도 실행 호출과 같은 값 상한이 걸립니다. 넘는 값이 있으면 400(P-064)으로 실패합니다.
드라이런 요청에도 실행 호출과 같은 요청 본문 상한이 걸립니다. 본문이 상한을 넘으면 413(C-011)으로, 중첩이 상한보다 깊으면 400(C-012)으로 실패합니다.
다음 단계
변경 영향 시뮬레이션
수백 개의 과거 입력에 대해 한 번에 테스트합니다.
배포
검증된 버전을 프로덕션에 배포합니다.

