오류 메시지 참조

Apigee Edge 문서입니다.
Go to the Apigee X documentation.
info

이 페이지에는 Apigee Edge를 사용할 때 발생할 수 있는 오류 및 기타 문제의 문제 해결 플레이북 링크가 포함되어 있습니다. 각 문제 해결 플레이북은 각 문제 유형을 진단하고 해결하는 방법을 설명합니다.

애널리틱스 문제

이 주제에서는 애널리틱스 데이터가 애널리틱스 대시보드 또는 커스텀 보고서에 표시되지 않는 경우를 해결하는 방법을 설명합니다.

오류 메시지 또는 설명 플레이북
The report timed out: Try again with a smaller date range or a larger aggregation interval.

애널리틱스 보고서 시간 초과

또는

보고서 시간 초과

Postgres 서버에서 디스크 공간이 완전히 채워지지 않는 한 오류 메시지가 표시되지 않을 수 있습니다. Postgres 서버의 디스크 공간 부족
오류가 관찰되지 않습니다. 애널리틱스 커스텀 보고서에 커스텀 변수가 표시되지 않음
No traffic in the selected date range 애널리틱스 대시보드에 데이터가 표시되지 않음
이 주제에서는 일반적으로 요청되는 작업을 수행하는 방법을 설명합니다. 애널리틱스 그룹에서 애널리틱스 구성요소 추가 및 삭제
Could not get data for path 여러 axgroup이 구성된 경우 커스텀 측정기준이 표시되지 않음

배포 오류

API 프록시 배포는 Edge 서버 간의 네트워크 연결 문제 Cassandra 데이터 저장소 문제, ZooKeeper 예외, API 프록시 번들의 오류 등 다양한 이유로 실패할 수 있습니다. 이 섹션에서는 배포 오류를 해결하기 위해 따를 수 있는 몇 가지 구체적인 절차에 관한 정보와 안내를 제공합니다.
오류 메시지 또는 설명 플레이북
Error: Call timed out; either server is down or server is not reachable 시간 제한 오류
Unexpected error Error while fetching children for path 오류 경로의 하위 요소 가져오기
Error while accessing datastore;Please retry later 오류 데이터 저장소 액세스
Configuration failed, associated contexts = [] 구성 실패
Unexpected error occurred while processing the updates, associated contexts = [] 오류 업데이트 처리 중

개발자 포털 오류

이 주제에서는 개발자 포털을 사용할 때 발생할 수 있는 문제를 해결하는 데 도움이 되는 정보를 제공합니다. 개발자 포털 문제를 해결하기 전에 개발자 포털 문제 해결 개요에 설명된 대로 개발자 포털의 작동 방식을 기본적인 수준에서 이해해야 합니다.
오류 메시지 또는 설명 플레이북
An internal error has occurred. Please retry your request. 개발자 포털 내부 오류
The website encountered an unexpected error. Please try again later. 또는 There was an error trying to create the App. Please try again later. 개발자 포털 통신 문제

수익 창출 문제

다음 주제에서는 일반적인 수익 창출 문제를 해결하고 수정하는 데 도움이 되는 정보를 제공합니다.

오류 메시지 또는 설명 플레이북
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
개발자 일시중지됨
오류 메시지가 표시되지 않을 수 있지만 수익 창출 설정 문제 증상 섹션에 설명된 대로 문제가 표시됩니다. 수익 창출 설정 문제

Edge 라우터 문제

Edge 라우터는 NGINX로 구현됩니다. Edge 업그레이드 프로세스 중 또는 라우터 구성을 변경할 때 NGINX 구성 오류가 표시될 수 있습니다. 다음 주제 에서는 이러한 문제를 해결하는 데 도움이 되는 정보를 제공합니다.

오류 메시지 또는 설명 플레이북
오류 메시지가 표시되지 않습니다. 하지만 잘못된 구성 파일로 인해 API 프록시를 실행하지 못할 수 있습니다. 잘못된 구성 파일
429 Too Many Requests: Tuning Nginx Router connection limits 429 너무 많은 요청

OpenLDAP 문제

다음 주제에서는 일반적인 OpenLDAP 문제를 해결하고 수정하는 데 도움이 되는 정보를 제공합니다.

오류 메시지 또는 설명 플레이북
Unknown username and password combination. SMTP가 사용 중지되어 사용자가 비밀번호를 재설정해야 함
오류가 표시되지 않고 Edge UI에 모든 OpenLDAP 서버에서 복제되어야 하는 사용자 목록이 표시되지 않습니다. LDAP가 복제되지 않음
SLAPD Dead But Pid File Exists OpenLDAP을 시작할 수 없음
Unknown username and password combination. OpenLDAP 데이터 손상

런타임 오류

다음 주제에서는 일반적인 런타임 문제를 해결하고 수정하는 데 도움이 되는 정보를 제공합니다.

오류 메시지 또는 설명 플레이북
HTTP/1.1 500 Internal Server Error 또는
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}


500 내부 서버 오류
HTTP/1.1 502 Bad Gateway 또는
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 잘못된 게이트웨이
HTTP/1.1 503 Service Unavailable 또는 HTTP/1.1 503 Service Unavailable: Back-end server is at capacity 또는
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 서비스 사용할 수 없음
HTTP/1.1 503 Service Unavailable 또는 Received fatal alert: handshake_failure SSL 핸드셰이크 실패
HTTP/1.1 503 Service Unavailable 또는
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL 핸드셰이크 실패 - 잘못된 클라이언트 인증서
HTTP/1.1 504 Gateway Timeout 또는
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}


504 게이트웨이 시간 초과

Zookeeper 문제

다음 주제에서는 일반적인 Zookeeper 문제를 해결하고 수정하는 데 도움이 되는 정보를 제공합니다.
오류 메시지 또는 설명 플레이북
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

또는

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

또는

Edge UI에 다음 오류가 표시될 수 있습니다.

Error Fetching Deployments Error while checking path existence for path: path
Zookeeper 연결 손실 오류
일반적으로 연결 문제라고 하는 데이터 관련 문제는 여러 문제 중 하나로 나타날 수 있습니다. 자세한 내용은 Zookeeper 데이터 문제 를 참고하세요. Zookeeper 데이터 문제
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] Zookeeper를 시작할 수 없음

진단 도구 및 로그

이 주제에서는 Apigee Edge를 사용할 때 발생할 수 있는 특정 종류의 문제를 진단하는 데 사용할 수 있는 도구와 로그를 설명합니다.

  • TCP/IP 패킷 스니퍼 (tcpdump) 유틸리티
    tcpdump 도구는 네트워크를 통해 수신되거나 전송되는 TCP/IP 패킷을 캡처하거나 필터링할 수 있는 명령줄 패킷 스니퍼 도구입니다.
  • 힙 덤프
    힙 덤프는 자바 프로세스의 메모리 스냅샷입니다. 힙 덤프가 수집되는 순간 힙에 있는 자바 객체 및 클래스에 관한 정보가 포함되어 있습니다.
  • 스레드 덤프
    스레드 덤프는 실행 중인 자바 프로세스의 모든 스레드 상태에 대한 스냅샷입니다. 각 스레드의 상태는 스택 트레이스라고 하는 스택 콘텐츠와 함께 표시됩니다.