503 서비스를 사용할 수 없음 - NoActiveTargets

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

동영상

503 오류에 대한 자세한 내용은 다음 동영상을 참고하세요.

증상

클라이언트 애플리케이션은 API 프록시 요청에 대해 503 HTTP 응답 상태 코드와 메시지 서비스를 사용할 수 없음, 오류 코드 NoActiveTargets 를 수신합니다.

오류 메시지

다음과 같은 오류 응답이 표시됩니다.

HTTP/1.1 503 Service Unavailable
  

HTTP 응답에 다음과 같은 오류 메시지가 표시됩니다.

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

가능한 원인

오류 코드 NoActiveTargets 가 포함된 HTTP 응답 503 서비스를 사용할 수 없음 은 일반적으로 API 프록시의 대상 엔드포인트 구성에서 하나 이상의 대상 서버를 사용할 때 관찰됩니다.

다음 표에는 오류 코드 NoActiveTargets 응답이 포함된 503 서비스를 사용할 수 없음 의 가능한 원인이 나와 있습니다.

원인: 대상 서버가 사용 중지됨

대상 엔드포인트 구성에 지정된 모든 대상 서버가 사용 중지된 경우 오류 코드 NoActiveTargets가 포함된 503 서비스를 사용할 수 없음 응답이 표시됩니다.

진단

1. 다음 방법 중 하나를 사용하여 실패한 API 프록시의 특정 대상 엔드포인트 구성에서 사용 중인 대상 서버의 이름을 확인합니다.
1. 대상 엔드포인트가 하나인 경우 해당 대상 엔드포인트를 확인합니다.
2. 대상 엔드포인트가 여러 개이고 사용 중지된 대상 서버가 있는 엔드포인트를 잘 모르는 경우 아래 단계를 따르세요.
1. 추적 세션을 사용 설정하고 API 호출을 수행하여 503 서비스를 사용할 수 없음 문제를 재현합니다.
2. 추적에서 대상 요청 흐름 시작 으로 이동하여 아래와 같이 대상 엔드포인트의 이름을 확인합니다.



2. 대상 엔드포인트를 식별한 후 아래 예와 같이 대상 엔드포인트 구성에서 사용된 대상 서버 이름을 가져옵니다.

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   위 예에는 demo-target 이라는 대상 서버가 하나 있습니다.

3. Edge UI 또는 Edge API 호출을 사용하여 대상 엔드포인트에서 사용되는 각 대상 서버의 정의를 가져옵니다.

   Edge UI

   Edge UI를 사용하여 정의를 가져오려면 다음 안내를 따르세요.

   1. 관리자 > 환경 > 대상 서버 로 이동합니다.
   2. 실패가 발생하는 특정 환경을 선택합니다.
   3. 특정 대상 서버 이름을 검색하여 대상 서버 정의를 가져옵니다.

      예를 들어 대상 서버 이름 demo-target을 입력하면 아래와 같이 정의가 표시됩니다.

      

      여기서 대상 서버 demo-target 에 호스트 별칭, 포트 번호가 있고 SSL이 사용 설정되어 있습니다. 하지만 대상 서버 자체가 사용 중지 되어 있으며, 이는 ENABLED 요소가 회색으로 표시되어 있음을 나타냅니다.

   Edge API

   Edge API를 사용하여 정의를 가져오려면 다음 안내를 따르세요.

   대상 서버 가져오기 API를 사용하여 대상 서버 정의를 가져옵니다.

   대상 서버 정의 출력

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   Apigee API 출력은 IsEnabled 요소가 false로 설정되어 있으므로 대상 서버 demo-target 이 사용 중지 되어 있음을 보여줍니다.

   대상 서버가 사용 중지되어 있으므로 메시지 프로세서는 클라이언트에 대한 응답으로 오류 코드 NoActiveTargets 가 포함된 503 서비스를 사용할 수 없음 을 즉시 전송합니다.

해결 방법

API 프록시의 대상 엔드포인트 구성에서 사용되는 특정 대상 서버가 항상 사용 설정되어 있는지 확인합니다.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

문제가 계속되면 진단 정보를 수집해야 함으로 이동합니다.

API 모니터링을 사용하여 문제 진단

API 모니터링을 사용하면 문제 영역을 빠르게 격리하여 오류, 성능, 지연 시간 문제 및 개발자 앱, API 프록시, 백엔드 대상, API 플랫폼과 같은 원인을 진단할 수 있습니다.

API 모니터링을 사용하여 API의 5xx 문제를 해결하는 방법을 보여주는 샘플 시나리오 를 단계별로 설명합니다. 예를 들어 오류messaging.adaptors.http.flow.NoActiveTargets 수가 특정 기준을 초과할 때 알림을 받도록 알림을 설정할 수 있습니다.

진단 정보 수집 필요

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

1. Public Cloud 사용자인 경우 다음 정보를 제공합니다.
1. 조직 이름
2. 환경 이름
3. API 프록시 이름
4. 오류를 재현하는 전체 curl 명령어
5. 오류 코드 NoActiveTargets가 포함된 503 서비스를 사용할 수 없음 요청이 포함된 추적 파일
2. Private Cloud 사용자인 경우 다음 정보를 제공합니다.
   1. 확인된 전체 오류 메시지
   2. 환경 이름
   3. API 프록시 번들
   4. 오류 코드 NoActiveTargets가 포함된 503 서비스를 사용할 수 없음 요청이 포함된 추적 파일
   5. NGINX 액세스 로그

      (/opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log)

   6. 메시지 프로세서 로그

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)