참조 문자열을 사용하여 4xx 및 5xx 오류 문제 해결

아티클
12/24/2024

Azure Front Door 문제를 진단하고 해결하기 위해 참조 문자열을 이해하고 사용하는 가이드입니다.

필수 조건

Azure Front Door 프로필이 있어야 합니다. 프로필을 만들려면 Azure Front Door 프로필 만들기를 참조하세요.

참조 문자열이란?

참조 문자열(RefString이라고도 함)은 Azure Front Door가 각 요청의 HTTP 응답 헤더에 추가하는 짧은 문자열입니다. POP(현재 상태 지점) 및 백 엔드 상태를 포함하여 요청이 처리된 방법에 대한 세부 정보를 제공합니다.

참조 문자열을 사용하면 캐시 누락, 백 엔드 오류 및 대기 시간 문제와 같은 Azure Front Door 문제를 해결하고 해결할 수 있습니다. 요청의 참조 문자열을 분석하여 근본 원인을 식별하고 적절한 조치를 취하여 해결할 수 있습니다.

참고 항목

Microsoft 서비스 오류 페이지가 발생하면 오류 페이지를 생성한 요청에 대한 참조 문자열이 이미 포함됩니다. 이러한 경우 진단 단계로 직접 건너뛸 수 있습니다.

참조 문자열을 수집하는 방법

참조 문자열을 수집하려면 요청의 HTTP 응답 헤더를 캡처하고 X-Azure-Ref라는 헤더를 찾아야 합니다. 이 헤더에는 Base64로 인코딩된 참조 문자열이 포함되어 있습니다. 기본 설정 및 상황에 따라 다른 메서드를 사용하여 HTTP 응답 헤더를 캡처할 수 있습니다. 다음은 Microsoft Edge 브라우저에서 참조 문자열을 가져오는 방법의 예입니다.

Microsoft Edge Browser

를 누르 F12 거나 Ctrl+Shift+I눌러 브라우저의 개발자 도구를 엽니다.
네트워크 탭으로 이동합니다.
페이지를 새로 고치거나 요청을 트리거하는 작업을 수행합니다.
목록에서 특정 요청을 찾고 응답 헤더 섹션에서 X-Azure-Ref 헤더를 찾습니다.
Azure Portal에서 참조 문자열 문제 해결 도구와 함께 사용할 X-Azure-Ref 헤더의 값을 복사합니다.

자세한 내용은 네트워크 작업 검사 - Microsoft Edge 개발자 설명서를 참조 하세요.

Microsoft Edge 브라우저에서 참조 문자열을 가져오는 방법의 예:

문제 해결 도구 중 일부와 함께 참조 문자열을 사용하는 방법

Azure Front Door는 참조 문자열을 사용하여 4xx 및 5xx 오류를 관리합니다. 다음은 연결 문제를 추적하고 진단하기 위해 참조 문자열과 함께 진단 도구를 사용하는 단계입니다.

Azure Front Door 프로필로 이동합니다.
진단 및 문제 해결 메뉴를 선택합니다.
아래로 스크롤하여 일반적인 문제 섹션에서 연결을 선택합니다.
어떤 문제가 있나요? 문제 하위 형식을 선택하고 드롭다운 메뉴에서 4xx 및 5xx 오류를 선택한 다음, 다음을 선택합니다.
4xx 및 5xx 오류 섹션 내의 상자에 참조 문자열을 입력합니다. 추적 참조 - RefString 필드 아래 의 요청에서 지정된 참조 문자열을 입력합니다 .
마지막으로 진단 실행을 선택하여 문제의 원인을 식별합니다. 알려진 문제인 경우 오류를 설명합니다.

문제를 표시하는 결과의 예:

참고 항목

진단 기능은 결과를 제공하는 데 최대 15분이 필요할 수 있습니다. 우리는 추가 조치를 취하기 전에 프로세스가 완료 될 수 있도록 인내심을 요청합니다.