503 서비스를 사용할 수 없음

추적 도구

Trace 도구를 사용하여 실패한 요청의 메시지 ID를 확인하려면 다음 안내를 따르세요.

1. 문제가 아직 활성 상태이면 영향을 받은 API에 추적 세션을 사용 설정합니다.
2. API를 호출하여 문제를 재현합니다. - 503 서비스를 사용할 수 없음(오류 코드: messaging.adaptors.http.flow.ServiceUnavailable.)
3. 실패한 요청 중 하나를 선택합니다.
4. AX 단계로 이동하고 다음 그림과 같이 단계 세부정보 섹션에서 아래로 스크롤하여 요청의 메시지 ID (X-Apigee.Message-ID)를 확인합니다.

   

NGINX 액세스 로그

NGINX 액세스 로그를 사용하여 실패한 요청의 메시지 ID를 확인하려면 다음 안내를 따르세요.

NGINX 액세스 로그를 참조하여 503 오류의 메시지 ID를 확인할 수도 있습니다. 이 기능은 문제가 이전에 발생했거나 간헐적인 경우 특히 유용합니다. UI에서 트레이스를 캡처할 수 없습니다. NGINX 액세스 로그에서 이 정보를 확인하려면 다음 단계를 따르세요.

1. NGINX 액세스 로그를 확인합니다(/opt/apigee/var/log/edge-router/nginx/ <org>~ <env>.<port#>_access_log).
2. 특정 기간 동안 특정 API 프록시에 503 오류가 발생했는지 검색합니다. (과거에 문제가 발생한 경우) 또는 여전히 503으로 실패한 요청이 있는지 확인합니다.
3. X-Apigee-fault-codemessaging.adaptors.http.flow.ServiceUnavailable에 503 오류가 있으면 다음 예와 같이 하나 이상의 이러한 요청에 대한 메시지 ID를 기록해 두세요.

   503 오류를 보여주는 샘플 항목

   

추적 도구

Trace 도구를 사용하여 진단하려면 다음 안내를 따르세요.

1. 문제가 아직 활성 상태이면 영향을 받은 API에 추적 세션을 사용 설정합니다.
2. API를 호출하여 문제를 재현합니다. - 503 서비스를 사용할 수 없음(오류 코드: messaging.adaptors.http.flow.ServiceUnavailable.)
3. 실패한 요청 중 하나를 선택합니다.
4. 추적의 다양한 단계를 살펴보고 오류가 발생한 위치를 찾습니다.
5. 오류가 있는 FlowInfo를 선택합니다. 다음 예와 같이 error.cause 필드에서 자세한 정보를 확인할 수 있으며 실패 원인을 설명합니다.

   trace에서 error.cause를 보여주는 샘플 요청

   
6. error.cause에 호스트에 연결할 수 없음이 표시되면 다음 중 하나가 오류의 원인일 수 있습니다. <ph type="x-smartling-placeholder">
   </ph>
   • 대상 서버/대상 엔드포인트 구성에 지정된 호스트 이름이 잘못되었거나 원치 않는 공백 또는 특수문자가 포함되어 있습니다.
     
     예를 들어 아래와 같이 호스트 이름에 원치 않는 공백이 있습니다.
     

     "demo-target.apigee.net "
                       

   • AssignMessage를 사용하여 API 프록시에서 target.url 변수로 덮어쓴 호스트 이름 또는 JavaScript 정책이 잘못되었거나 공백 또는 기타 원치 않는 특수문자가 포함되어 있습니다.
7. 대상 엔드포인트 구성 또는 대상 서버 정의를 확인하여 대상 서버 호스트 이름이 잘못되었거나 원치 않는 공백이나 특수문자가 있는지 확인합니다.
8. 대상 서버 호스트가 동적으로 생성된 경우 대상 서버 호스트를 만드는 데 사용된 적절한 정책 (예: AssignMessage/JavaScript 정책)을 확인합니다. 체크박스를 선택합니다. 대상 서버 호스트 이름이 잘못되었거나 불필요한 공백이나 특수문자가 있는지 확인하세요.
9. 대상 서버 호스트 이름을 확인했으면 호스트 이름에서 nslookup/dig 명령어를 실행하여 확인할 수 있는지 확인합니다.

   예를 들어 호스트 이름에 불필요한 공백이 있는 nslookup 명령어를 실행하면 다음과 같은 출력이 반환됩니다.

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN
   

10. 운영체제 명령어 nslookup도 호스트 이름을 확인하지 못하는 경우, 대상 서버에 잘못된 호스트 이름이 사용된 것이 문제의 원인입니다.

    Resolution(해결 방법)으로 이동합니다.

메시지 프로세서 로그

메시지 프로세서 로그를 사용하여 진단하려면 다음 안내를 따르세요.

1. 실패한 요청의 메시지 ID를 확인합니다.
2. 메시지 프로세서 로그에서 메시지 ID를 검색합니다. (/opt/apigee/var/log/edge-message-processor/logs/system.log)
3. 다음 경고/오류 메시지가 표시되면 메시지 프로세서가 호스트 이름을 확인할 수 없는 것입니다. 메시지에 다시 알림이 설정되므로 이 메시지가 표시되지 않을 수도 있습니다. 경고 메시지가 표시됩니다.

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 WARN S.HTTPCLIENTSERVICE - DNSCache$2.failed() : Failed to resolve hostname www.somehost.com . Reason mocktarget.apigee.net : Name or service not known. This log message will snooze for 2 hours
       

4. 이렇게 하면 경고 메시지가 표시됩니다. 이 메시지는 대상 서버 호스트에 연결할 수 없어 메시지 프로세서가 DNS 캐시에서 주소를 삭제합니다.

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid> NIOThread@0 WARN  c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.addressNotReachable() : The last address has been removed from Address list null refreshing
       

5. 그러면 메시지 프로세서에 오류가 발생했다는 메시지와 함께 '호스트에 연결할 수 없음'이라는 메시지가 표시될 수 있습니다. 오류 메시지의 일부로 호스트 이름이 표시되는 경우도 있습니다.

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

6. 아래와 같이 호스트 이름을 확인하거나 연결할 수 없기 때문에 때로는 null로 표시될 수도 있습니다. <ph type="x-smartling-placeholder">

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
   java.lang.RuntimeException: Host not reachable
   	at com.apigee.protocol.http.HTTPClient$Context.initConnect(HTTPClient.java:704)
   	at com.apigee.protocol.http.HTTPClient$Context.send(HTTPClient.java:675)
   	at com.apigee.messaging.adaptors.http.flow.data.TargetRequestSender.sendRequest(TargetRequestSender.java:234)
   	…<snipped>
       

   </ph>
7. Host not reachable 오류는 일반적으로 다음 사례 중 하나에서 발생합니다. <ph type="x-smartling-placeholder">
   </ph>
   • 대상 서버/대상 엔드포인트 구성에 지정된 호스트 이름이 잘못되었거나 원치 않는 공백 또는 특수문자가 포함되어 있습니다.
     
     예를 들어 호스트 이름 'demo-target.apigee.net'에 불필요한 공백이 있는 것입니다. 아래와 같은 오류 메시지가 표시됩니다.

     NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to demo-target.apigee.net  failed with exception
             

   • AssignMessage 또는 JavaScript 정책을 사용하여 API 프록시에서 target.url 변수로 덮어쓴 호스트 이름이 잘못되었거나 공백이나 기타 원치 않는 특수문자가 포함되어 있습니다.
8. 다음 중 하나를 사용하여 메시지 프로세서가 통신을 시도하는 대상 서버 호스트 이름을 확인합니다.
1. Host not reachable 가 포함된 오류 메시지를 주의 깊게 검토합니다.
2. 오류 메시지에 호스트 이름이 표시되면 공백이나 특수문자를 포함하여 호스트 이름을 복사합니다.
3. 다음 오류 메시지에 표시된 것처럼 오류 메시지의 호스트 이름에 대해 null이 표시되면 <ph type="x-smartling-placeholder">

   org:myorg env:prod api:TestTargetServer rev:2 messageid:<messageid>  NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() :  connect to null failed with exception {}
           

   </ph>
1. 실패한 API 프록시에 사용된 대상 서버 정의를 확인하여 호스트 이름을 확인합니다.
2. 대상 서버 호스트가 동적으로 생성된 경우 대상 서버 호스트를 만드는 데 사용된 적절한 정책 (예: AssignMessage/JavaScript 정책)을 확인합니다.
9. 대상 서버 호스트 이름을 확인했으면 호스트 이름에서 nslookup/dig 명령어를 실행하여 해결할 수 있는지 확인합니다.

   예를 들어 공백이 있는 호스트 이름에 nslookup 명령어를 실행합니다.

   nslookup "demo-target.apigee.net "
   Server:	49.205.75.2
   Address:	49.205.75.2#53
   
   ** server can't find demo-target.apigee.net\032: NXDOMAIN
         

10. 운영체제 명령어 nslookup이 호스트 이름을 확인하지 못하는 경우 이 문제의 원인은 대상 서버에 잘못된 호스트 이름이 사용되었기 때문입니다.

UI 트레이스

UI Trace를 사용하여 오류가 발생한 위치를 확인하려면 다음을 실행합니다.

1. 문제가 계속 발생하면 영향을 받는 API의 UI 트레이스를 사용 설정합니다.
2. 실패한 API 요청의 UI trace에 503 Service Unavailable 오류가 표시되는 경우 대상 요청 흐름 중에 발생하거나 백엔드 서버에서 전송된 경우 southbound (메시지 프로세서와 백엔드 사이) 있습니다.
3. 특정 API 호출에 대한 추적을 가져올 수 없는 경우 문제는 다음과 같습니다. 클라이언트 애플리케이션과 라우터 간의 northbound에 위치합니다.

API 모니터링

API 모니터링을 사용하면 문제 영역을 빠르게 격리하여 오류, 성능, 지연 시간 문제와 그 원인을 진단할 수 있습니다. 백엔드 타겟, API 플랫폼 등의 서비스를 정의할 수 있습니다

API Monitoring을 사용하여 API의 5xx 문제를 해결하는 방법을 보여주는 샘플 시나리오를 살펴봅니다. 예를 들어 messaging.adaptors.http.flow.ServiceUnavailable 오류 수가 특정 기준점을 초과할 때 알림을 받도록 알림을 설정할 수 있습니다.

NGINX 액세스 로그

UI Trace를 사용하여 오류가 발생한 위치를 확인하려면 다음을 실행합니다.

문제가 과거에 발생한 적이 있거나 문제가 간헐적으로 발생해 문제를 해결할 수 없는 경우 트레이스를 캡처한 후 다음 단계를 수행합니다.

1. NGINX 액세스 로그 (/opt/apigee/var/log/edge-router/nginx/ org-env.port_access_log)를 확인합니다.
2. 특정 API 프록시에 503 오류가 있는지 검색합니다.
3. 특정 시점에 특정 API에서 503 오류를 식별할 수 있는 경우 남쪽 바운드 연결 (메시지 프로세서와 )합니다.
4. 그렇지 않은 경우 북쪽 경계 연결( 클라이언트 애플리케이션과 라우터).