ColdFusion에서의 제3자 API 에러 핸들링: 재시도 로직, 서킷 브레이커(Circuit Breakers) 및 로깅

ColdFusion이 cfhttp를 사용하여 제3자 API를 호출할 때, 견고한 에러 핸들링(error handling)은 네 가지 요소에 달려 있습니다. 첫째, 응답을 적절히 검사해야 합니다. cfhttp는 statusCode, fileContent, errorDetail, elapsedTime을 포함하는 결과 구조체(result struct)를 반환하며, throwOnError="true"를 사용하여 예외(exception)를 발생시킬지 아니면 직접 상태 코드(status code)를 확인할지 결정해야 합니다. 둘째, 지수 백오프(exponential backoff)를 사용하여 일시적인 실패(transient failures)를 재시도해야 합니다. ColdFusion에는 내장된 재시도 기능이 없으므로, 루프(loop)와 cftry/cfcatch를 사용하여 구현하며, 천둥떼 문제(thundering-herd problems)를 방지하기 위해 지터(jitter)를 추가해야 합니다. 셋째, 서킷 브레이커(circuit breaker)를 추가해야 합니다. 이 또한 내장되어 있지 않으므로, 공유 캐시(shared cache)에서 연속된 실패를 추적하고, 죽은 서비스에 계속 요청을 보내는 것을 중단하기 위해 회로를 "개방(open)"한 다음, 복구 여부를 테스트하기 위해 "반개방(half-open)" 상태로 전환합니다. 넷째, 네이티브 cflog/writeLog를 사용하여 전용 로그 파일에 모든 것을 기록해야 합니다. 반드시 잡아야(catch) 하는 두 가지 예외 유형은 COM.Allaire.ColdFusion.HTTPFailure(연결 실패)와 coldfusion.runtime.RequestTimedOutException(타임아웃)입니다. 이 가이드는 검증된 코드로 이 네 가지 계층을 모두 구축합니다.

더 읽어보기