503 서비스를 사용할 수 없음

추적 도구

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

1. 문제가 여전히 활성 상태인 경우 영향을 받는 API에 대해 추적 세션을 사용 설정합니다.
2. API를 호출하고 문제를 재현합니다(오류 코드 messaging.adaptors.http.flow.ServiceUnavailable.이 있는 503 서비스 사용 불가).
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-code messaging.adaptors.http.flow.ServiceUnavailable과 관련된 503 오류가 있는 경우 다음 예와 같이 하나 이상의 요청에 대한 메시지 ID를 기록합니다.

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

   

추적 도구

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

1. 문제가 여전히 활성 상태인 경우 영향을 받는 API에 대해 추적 세션을 사용 설정합니다.
2. API를 호출하고 문제를 재현합니다(오류 코드 messaging.adaptors.http.flow.ServiceUnavailable.이 있는 503 서비스 사용 불가).
3. 실패한 요청 중 하나를 선택합니다.
4. 트레이스의 다양한 단계를 탐색하여 장애가 발생한 위치를 찾습니다.
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 또는 JavaScript 정책을 사용하여 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 Trace를 사용하여 오류가 발생한 위치를 확인하려면 다음 단계를 따르세요.

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 Trace를 사용하여 오류가 발생한 위치를 확인하려면 다음 단계를 따르세요.

문제가 이전에 발생한 적이 있거나 간헐적으로 발생하여 트레이스를 캡처할 수 없는 경우 다음 단계를 따르세요.

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