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. trace의 다양한 단계를 살펴보고 실패가 발생한 위치를 찾습니다.
5. 오류가 있는 FlowInfo를 선택합니다. 다음 예와 같이 error.cause 필드에서 자세한 정보를 확인할 수 있습니다.

   트레이스의 error.cause를 보여주는 샘플 요청

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

     "demo-target.apigee.net "
                       

   • AssignMessage 또는 JavaScript 정책을 사용하는 API 프록시의 target.url 변수로 덮어쓴 호스트 이름이 잘못되었거나 공백 또는 기타 원치 않는 특수문자가 포함되어 있습니다.
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도 호스트 이름을 확인하지 못하는 경우 대상 서버에 사용된 호스트 이름이 잘못되었기 때문에 문제가 발생합니다.

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

메시지 프로세서 로그

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

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

   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로 표시될 수 있습니다.

   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>
       

7. Host not reachable 오류는 일반적으로 다음 중 한 가지 경우에 발생합니다.
   • 대상 서버/대상 엔드포인트 구성에 지정된 호스트 이름이 잘못되었거나 원치 않는 공백 또는 특수문자가 포함되어 있습니다.
     
     예를 들어 다음 오류 메시지의 호스트 이름 'demo-target.apigee.net'에 원치 않는 공백이 있습니다.

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

   • AssignMessage 또는 자바스크립트 정책을 사용하는 API 프록시의 target.url 변수로 덮어쓴 호스트 이름이 올바르지 않거나 공백이나 원치 않는 특수문자가 포함되어 있습니다.
8. 다음 중 하나를 사용하여 메시지 프로세서가 통신하려는 대상 서버 호스트 이름을 확인합니다.
1. Host not reachable 가 포함된 오류 메시지를 주의 깊게 검토합니다.
2. 오류 메시지에 호스트 이름이 표시되면 공백 또는 특수문자를 포함하여 호스트 이름을 복사합니다.
3. 다음 오류 메시지와 같이 오류 메시지에서 호스트 이름이 null을 표시하면

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

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 트레이스를 사용하여 오류가 발생한 위치를 확인하는 방법은 다음과 같습니다.

1. 문제가 아직 해결되지 않았다면 영향을 받은 API에 UI 트레이스를 사용 설정합니다.
2. 실패한 API 요청의 UI 트레이스에서 503 Service Unavailable 오류가 대상 요청 흐름 중에 발생하거나 백엔드 서버에서 전송된 경우 문제는 남쪽 경계 (즉, 메시지 프로세서와 백엔드 서버 사이)에 있습니다.
3. 특정 API 호출에 대한 트레이스를 가져오지 못하면 클라이언트 애플리케이션과 라우터 간의 북쪽바운드 문제가 됩니다.

API 모니터링

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

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

NGINX 액세스 로그

UI 트레이스를 사용하여 오류가 발생한 위치를 확인하는 방법은 다음과 같습니다.

이전에 문제가 발생했거나 문제가 간헐적으로 발생하여 트레이스를 캡처할 수 없는 경우 다음 단계를 수행합니다.

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