502.3 timeout errors

확인 방법

ARR 컨트롤러에서 해당 웹 사이트의 IIS 로그를 확인합니다.

sc-status, sc-substatus, sc-win32-status 값이 각각 502, 3, 12002인지 비교합니다.

세 값이 일치하면 sc-win32-status 12002는 오류 페이지에 보고되는 ERROR_WINHTTP_TIMEOUT에 해당합니다.

의미

ARR은 프록시로 동작하는 동안 업스트림 서버 요청을 완료하고 클라이언트에 응답을 돌려주지 못했습니다. 원문은 이 상태에 서버 연결 실패, 서버 응답 없음, 서버 응답 시간 초과 등 여러 이유가 있을 수 있다고 설명합니다.

출처: Microsoft Learn — Troubleshooting 502 errors in ARR (새 창에서 열림)

진단 기록

먼저 문제가 발생한 URL 또는 화면, 표시 시각, 사용한 플랫폼과 배포 버전을 기록합니다. 화면과 로그에서 오류 문자열이 일부만 보이면 앞뒤 문장을 포함해 원문을 보존하고, 민감한 값은 가립니다.

다음 순서로 관찰값을 대조합니다.

1. ARR 컨트롤러의 IIS 로그에서 sc-status가 502인지 확인합니다.
2. 같은 로그 항목에서 sc-substatus가 3이고 sc-win32-status가 12002인지 확인합니다.
3. 세 값이 모두 일치하면 ERROR_WINHTTP_TIMEOUT으로 식별합니다.

각 항목은 확인한 값과 확인하지 못한 이유를 함께 기록해야 합니다. 이 문서의 조건과 실제 관찰값이 다르면 원인을 단정하지 말고, 문제 해결 시작 가이드에서 더 넓은 분기를 선택하십시오.

판정 기준

오류 문자열이 일치한다는 사실만으로 원인이 확정되지는 않습니다. 같은 문구가 여러 환경에서 나타날 수 있으므로 웹서버·런타임·운영체제·최근 변경 사항을 함께 비교합니다. 한 단계에서 기대한 값이 나오지 않으면 다음 단계로 넘어가지 말고 해당 환경의 공식 문서를 우선 확인합니다.

안전한 다음 단계

검사 전에 백업과 변경 이력을 확인하고, 비밀번호·세션 쿠키·인증 토큰·개인정보를 공개 로그나 문의 내용에 넣지 않습니다. 설정·권한·데이터를 변경해야 한다면 영향 범위와 되돌리는 방법을 먼저 기록한 뒤 운영 시간과 승인 절차에 맞춰 진행합니다.

원인 분포

[Observation] 입력된 3건의 사례에서는 다음 원인이 각각 1건씩 관측되었습니다.

원인 유형	관측 사례 수	관련 사례
ARR 기본 요청 제한 초과	1	사례 1
유휴 원본 연결 재사용과 관련된 ARR 모듈 버그	1	사례 2
HiveServer의 HTTP 응답 지연	1	사례 3

[Observation] 이 분포는 관측된 사례 기준이며 실제 발생 빈도를 의미하지 않습니다.

오진 함정

[Observation] 502.3은 서로 다른 환경에서 요청 처리 시간 초과, 원본 연결 재사용 문제, 백엔드 쿼리 응답 지연으로 나타났습니다.

[Hypothesis] 따라서 502.3을 단일 원인으로 판단하지 말고, ARR 제한 시간·원본 연결 상태·백엔드 응답 지연을 구분해 확인해야 합니다.

[Observation] 사례 2에서는 원본 연결 제한 시간을 늘리면 증상이 사라졌지만, 근본 원인은 ARR 모듈 버그로 기록되었습니다.

환경 매트릭스

환경	증상	확인된 원인 또는 점검 대상	기록된 수정·조치
Windows Server 2012, ARR 3, IIS 8 웹 팜	간헐적 502.3 12002	요청 시간이 ARR 기본 30초 제한 초과	IIS 로그 확인 후 ApplicationHost.config의 ARR protocol timeout 조정
IIS ARR 캐시 프록시, nginx 원본 서버	원본 응답 미수신 후 502.3	유휴 연결 재사용과 관련된 ARR 모듈 버그	원본 연결 제한 시간 증가, 후속 릴리스 수정 예정
Azure HDInsight, Ambari Hive View, IIS 8.5	장시간 Hive 쿼리 중 502.3	HiveServer가 2분 안에 HTTP 응답을 반환하지 못함	Metastore 부하, 병렬 작업, 클러스터 용량, Ranger 정책, HiveServer 힙, 쿼리 성능 점검

[Observation] 표의 환경과 조치는 입력된 사례 원문에 기록된 내용만 정리했습니다.

진단 순서

1. [Observation] IIS 또는 관련 로그에서 502.3 발생 시점과 요청 소요 시간을 확인합니다.
2. [Observation] 요청 시간이 ARR 기본 제한 또는 설정된 protocol timeout을 초과했는지 확인합니다.
3. [Observation] ARR 프록시와 원본 서버 사이에서 유휴 연결 재사용 후 응답이 반환되지 않았는지 확인합니다.
4. [Observation] 백엔드가 장시간 작업을 수행하는 경우, 서버가 제한 시간 내 HTTP 응답을 반환했는지 확인합니다.
5. [Observation] 백엔드 응답 지연이 의심되면 Metastore 부하, 병렬 작업, 클러스터 용량, Ranger 정책, HiveServer 힙, 쿼리 성능을 점검합니다.
6. [Observation] 제한 시간 조정으로 증상이 사라져도 모듈 버그 가능성이 기록된 사례가 있으므로, ARR 모듈의 후속 릴리스 수정 여부를 확인합니다.