오류 메시지 참조

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

이 페이지에는 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 여러 축이 구성된 경우 맞춤 측정기준이 표시되지 않음

배포 오류

에지 서버 간의 네트워크 연결 문제, Cassandra 데이터 스토어 관련 문제, JoKeeper 예외, API 프록시 번들의 오류와 같은 다양한 이유로 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 Datastore 액세스 오류
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 Router는 NGINX로 구현됩니다. 에지 업그레이드 프로세스 중에 또는 라우터 구성을 변경할 때 NGINX 구성 오류가 표시될 수 있습니다. 다음 주제는 이러한 문제를 해결하는 데 도움이 됩니다.

오류 메시지 또는 설명 플레이북
어떠한 오류 메시지도 표시되지 않습니다. 하지만 잘못된 구성 파일로 인해 API 프록시를 실행하지 못할 수 있습니다. 잘못된 구성 파일

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 게이트웨이 시간 초과

동물원키퍼 문제

다음 주제는 일반적인 동물원키퍼 문제를 해결하는 데 도움이 됩니다.
오류 메시지 또는 설명 플레이북
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 패킷을 캡처하거나 필터링할 수 있는 명령줄 패킷 스니퍼 도구입니다.
  • 힙 덤프
    힙 덤프는 자바 프로세스의 메모리에 대한 스냅샷입니다. 여기에는 힙 덤프가 수집되는 시점의 힙에 있는 자바 객체 및 클래스에 관한 정보가 포함됩니다.
  • 스레드 덤프
    스레드 덤프는 실행 중인 자바 프로세스의 모든 스레드 상태에 관한 스냅샷입니다. 각 스레드의 상태에는 스택 트레이스라고 하는 스택의 콘텐츠가 표시됩니다.