500 내부 서버 오류 - 백엔드 서버

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

동영상

동영상 설명
500 내부 서버 오류 - 백엔드로 인해 발생 백엔드 서버로 인해 발생하는 실시간 500 Internal Server Error와 오류를 해결하고 해결하는 단계를 보여줍니다.

증상

클라이언트 애플리케이션은 API 호출에 대한 응답으로 500 HTTP 상태 코드와 메시지 Internal Server Error를 가져옵니다.

HTTP 상태 코드 500은 일반적인 오류 응답입니다. 이는 서버에서 요청을 수행할 수 없는 예기치 않은 조건을 발생했음을 의미합니다. 이 오류는 일반적으로 다른 오류 코드가 적합하지 않은 경우 서버에서 반환됩니다.

오류 메시지

클라이언트 애플리케이션은 다음 응답 코드를 가져옵니다. 

HTTP/1.1 500 Internal Server Error

또한 아래와 유사한 오류 메시지가 표시될 수 있습니다.

샘플 1

샘플 백엔드 서버 응답 1

{"errorMessage":"Sorry either your e-mail or password didn't match.",
"errorParameters":"{}",
"errorCode":"500",
"errorKey":"INVALID_EMAILPASSWORD"}

샘플 2

샘플 백엔드 서버 응답 2

<Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <Body>
      <Error>
         <code>500</code>
         <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
      </Error>
   </Body>
</Envelope>

가능한 원인

500 Internal Server Error는 여러 가지 원인으로 인해 백엔드 서버에서 반환될 수 있습니다. 이 플레이북에서는 일반적인 단계를 사용하여 문제를 해결하고 원인과 관계없이 이 오류를 해결하는 방법을 설명합니다.

이 문제의 가능한 원인은 다음과 같습니다.

원인 설명 다음에 관한 문제 해결 안내
백엔드 서버의 오류 백엔드 서버가 어떤 이유로 실패할 수 있습니다. Edge Private 및 Public Cloud 사용자

일반적인 진단 단계

다음 도구/기법 중 하나를 사용하여 이 오류를 진단합니다.

API 모니터링

절차 1: API 모니터링 사용

API 모니터링을 사용하여 오류를 진단하려면 다음 단계를 따르세요.

  1. 적절한 역할을 가진 사용자로 Apigee Edge UI에 로그인합니다.

  2. 문제를 조사하려는 조직으로 전환합니다.

  3. 분석 > API 모니터링 > 조사 페이지로 이동합니다.
  4. 오류가 발생한 특정 기간을 선택합니다.

  5. 오류 코드 를 시간 에 대해 표시합니다.

  6. 아래와 같이 오류 코드 messaging.adaptors.http.flow.ErrorResponseCode가 있는 셀을 선택합니다.

    ( 큰 이미지 보기)

  7. 오류 코드 messaging.adaptors.http.flow.ErrorResponseCode에 대한 정보가 아래와 같이 표시됩니다.

    ( 큰 이미지 보기)

  8. 로그 보기 를 클릭하고 실패한 요청의 행을 펼칩니다.

    ( 큰 이미지 보기)

  9. 로그 창에서 다음 세부정보를 확인합니다.
    • 요청 메시지 ID
    • 상태 코드: 500
    • 오류 소스: target
    • 오류 코드: messaging.adaptors.http.flow.ErrorResponseCode

Trace

절차 2: Trace 도구 사용

Trace 도구를 사용하여 오류를 진단하려면 다음 단계를 따르세요.

  1. trace 세션을 사용 설정하고 다음 중 하나를 수행합니다.
    • 오류 코드 messaging.adaptors.http.flow.ErrorResponseCode가 포함된 500 Internal Server Error 오류가 발생할 때까지 기다립니다.
    • 문제를 재현할 수 있는 경우 API를 호출하여 문제를 재현합니다. 500 Internal Server Error

  2. 모든 FlowInfo 표시 가 사용 설정되어 있는지 확인합니다.

  3. 실패한 요청 중 하나를 선택하고 trace를 검사합니다.
  4. trace의 여러 단계를 탐색하고 실패가 발생한 위치를 찾습니다.

  5. 일반적으로 아래와 같이 대상 서버에서 수신된 응답 단계 후 흐름에서 오류가 발생합니다.

    ( 큰 이미지 보기)

  6. trace의 AX (기록된 분석 데이터) 단계로 이동하여 클릭합니다.

  7. 아래와 같이 단계 세부정보 응답 헤더 섹션으로 스크롤하고 X-Apigee-fault-code, X-Apigee-fault-source, X-Apigee-Message-ID 값을 확인합니다.

    ( 큰 이미지 보기)

  8. X-Apigee-fault-code, X-Apigee-fault-source, X-Apigee-Message-ID 값을 확인합니다.
    9. 응답 헤더 값
    X-Apigee-fault-code messaging.adaptors.http.flow.ErrorResponseCode
    X-Apigee-fault-source target
    X-Apigee-Message-ID MESSAGE_ID

NGINX

절차 3: NGINX 액세스 로그 사용

NGINX 액세스 로그를 사용하여 오류를 진단하려면 다음 단계를 따르세요.

  1. Private Cloud 사용자인 경우 NGINX 액세스 로그를 사용하여 HTTP 500 Internal Server Error에 대한 주요 정보를 확인할 수 있습니다.

  2. NGINX 액세스 로그를 확인합니다.

    /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  3. 특정 기간(문제가 과거에 발생한 경우) 동안 오류 코드 messaging.adaptors.http.flow.ErrorResponseCode가 포함된 500 오류가 있는지 또는 500으로 인해 여전히 실패하는 요청이 있는지 검색합니다.

  4. X-Apigee-fault-code 가 messaging.adaptors.http.flow.ErrorResponseCode 값과 일치하는 500 오류를 발견한 경우 X-Apigee-fault-source 값을 확인합니다.

    NGINX 액세스 로그의 샘플 500 오류:

    ( 큰 이미지 보기)

    NGINX 액세스 로그의 위 샘플 항목에는 X-Apigee-fault-code 및 X-Apigee-fault-source:에 대한 다음 값이 있습니다.

    헤더 값
    X-Apigee-fault-code messaging.adaptors.http.flow.ErrorResponseCode
    X-Apigee-fault-source target

원인: 백엔드 서버의 오류

진단

백엔드 서버에서 응답한 500 Internal Server Error는 여러 가지 이유로 발생할 수 있습니다. 각 상황을 개별적으로 진단해야 합니다.

  1. 일반적인 진단 단계에 설명된 대로 API 모니터링, Trace 도구 또는 NGINX 액세스 로그를 사용하여 관찰된 오류의 오류 코드, 오류 소스 를 확인합니다.
  2. 오류 소스가 target이고 오류 코드가 messaging.adaptors.http.flow.ErrorResponseCode이면 오류가 백엔드 서버에서 반환됨을 나타냅니다.
  3. 다음 단계 중 하나를 사용하여 문제의 원인을 진단할 수 있습니다.

    Trace

    Trace 사용:

    실패에 대한 trace 세션이 있는 경우 다음 단계를 수행합니다.

    1. trace에서 500 Internal Server Error로 실패한 API 요청을 선택합니다.

    2. 아래 그림과 같이 실패한 API 요청에서 대상 서버에서 수신된 응답 단계를 선택합니다.

      ( 큰 이미지 보기)

    3. 단계 세부정보 섹션으로 스크롤하고 백엔드 서버의 응답이 포함된 응답 콘텐츠를 확인합니다.

      샘플 응답 콘텐츠:

      <Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <Body>
      <Error>
         <code>500</code>
         <message xml:lang="en-US">Not Authorised(e4138fa0-ec57).</message>
      </Error>
   </Body>
</Envelope>

      위 응답에서 백엔드 서버의 오류 메시지는 승인되지 않음 입니다. 이는 사용자가 잘못된 사용자 인증 정보를 전달했을 수 있으며 이로 인해 이 오류가 발생했음을 나타냅니다.

    백엔드 서버 호출

    백엔드 서버에 직접 호출:

    백엔드 서버에 직접 호출하고 다음을 수행할 수 있습니다.

    • Apigee Edge를 통해 요청이 이루어졌을 때 수신된 것과 동일한 500 Internal Server Error 응답을 수신하는지 확인합니다.
    • 백엔드 서버에서 수신한 오류 메시지 (응답)를 확인합니다.

    백엔드 서버에 직접 호출하려면 다음 단계를 수행합니다.

    1. 요청의 일부로 백엔드 서버에 전달해야 하는 모든 필수 헤더, 쿼리 매개변수, 사용자 인증 정보가 있는지 확인합니다.
    2. 백엔드 서비스에 공개적으로 액세스할 수 있는 경우 curl 명령어, Postman 또는 기타 REST 클라이언트를 사용하여 백엔드 서버 API를 직접 호출할 수 있습니다.

    3. 백엔드 서버가 메시지 프로세서에서만 액세스할 수 있는 경우 curl 명령어, Postman 또는 기타 REST 클라이언트를 사용하여 백엔드 서버 API를 메시지 프로세서에서 직접 호출할 수 있습니다.

    4. 백엔드 서비스가 실제로 500 Internal Server Error를 반환하는지 확인하고 백엔드 서버에서 반환된 오류 메시지 (응답)를 확인하여 이 오류의 원인을 파악합니다.

    백엔드 서버 로그

    백엔드 서버 로그 사용

    1. 백엔드 서버 로그를 검토하고 오류 및 원인에 대한 자세한 정보를 확인합니다.
    2. 가능한 경우 백엔드 서버에서 디버그 모드를 사용 설정하여 오류 및 원인에 대한 자세한 정보를 확인합니다.

  4. 실패한 API 프록시의 특정 대상 엔드포인트에서 프록시 체인을 사용하는지 확인합니다. 즉, 대상 서버/대상 엔드포인트가 Apigee Edge에서 다른 프록시를 호출하는지 확인합니다. 이를 확인하려면 다음 단계를 따르세요.

    1. 실패한 요청의 trace가 있는 경우 대상 서버로 전송된 요청 단계로 이동하여 Curl 표시 를 클릭합니다.

    2. 대상 서버로 전송된 요청의 Curl 창이 열리고 여기서 대상 서버 호스트 별칭을 확인할 수 있습니다.
    3. API 프록시의 대상 엔드포인트를 검토하고 백엔드 서버 URL 또는 대상 서버의 호스트 이름이 다른 프록시 또는 자체 백엔드 서버를 가리키는지 확인합니다.
    4. 대상 서버 호스트 별칭이 가상 호스트 별칭을 가리키는 경우 프록시 체인입니다. 이 경우 체인 프록시에 대해 위의 모든 단계를 반복하여 실제로 원인이 무엇인지 파악해야 합니다. 500 Internal Server Error 이러한 경우 500 Internal Server Error가 다른 단계의 다른 체인 프록시에서도 발생할 수 있으며, 이 플레이북 또는 500 내부 서버 오류 플레이북에 제공된 안내에 따라 진단하고 해결할 수 있습니다.
    5. 대상 서버 호스트 별칭이 백엔드 서버를 가리키는 경우 해결 방법으로 이동합니다.

해결 방법

500 오류가 백엔드 서버에서 발생한 것으로 확인되면 백엔드 서버팀과 협력하여 문제를 적절하게 해결합니다.

위에서 설명한 예에서는 이 문제를 해결하기 위해 사용자에게 유효한 사용자 인증 정보를 전달하도록 요청해야 할 수 있습니다.

핵심 사항

  1. 500 Internal Server Error에 대해 백엔드 서버에서 반환된 실제 오류 메시지는 실패한 요청의 trace 세션을 캡처한 경우에만 볼 수 있습니다.
  2. 보안상의 이유로 백엔드 서버 응답은 API 모니터링, NGINX 액세스 로그 또는 메시지 프로세서 로그에 로깅되지 않습니다.
  3. 백엔드 서버 로그를 검토하거나 백엔드에서 디버그 모드를 사용 설정하여 자세한 정보를 확인하거나500 Internal Server Error 백엔드 서버에서 반환된 오류 메시지를 볼 수 있습니다.

진단 정보 수집 필요

위 안내를 따른 후에도 문제가 지속되면 다음 진단 정보를 수집한 후 Apigee Edge 지원팀에 문의하세요.

Public Cloud 사용자인 경우 다음 정보를 제공하세요.

  • 조직 이름
  • 환경 이름
  • API 프록시 이름
  • 500 오류를 재현하는 전체 curl 명령어
  • 500 Internal Server Error이(가) 포함된 요청이 포함된 trace 파일
  • 500 오류가 현재 발생하지 않는 경우 과거에 500 오류가 발생한 시간대 정보가 포함된 기간을 제공합니다.

Private Cloud 사용자인 경우 다음 정보를 제공하세요.

  • 실패한 요청에 대해 관찰된 전체 오류 메시지
  • 오류가 관찰되는 조직, 환경 이름, API 프록시 이름 500
  • API 프록시 번들
  • 500 Internal Server Error이(가) 포함된 요청이 포함된 trace 파일
  • NGINX 액세스 로그 /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

    위치: ORG, ENV, PORT#은 실제 값으로 대체됩니다.

  • 메시지 프로세서 시스템 로그 /opt/apigee/var/log/edge-message-processor/logs/system.log
  • 500 오류가 발생한 시간대 정보가 포함된 기간