오류 메시지 참조

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

배포 오류

에지 서버 간의 네트워크 연결 문제, Cassandra 데이터 스토어 문제, ZooKeeper 예외, 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 라우터 문제

에지 라우터는 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 패킷을 캡처하거나 필터링할 수 있는 명령줄 패킷 스니퍼 도구입니다.
  • 힙 덤프
    힙 덤프는 Java 프로세스의 메모리 스냅샷입니다. 여기에는 힙 덤프가 수집되는 시점의 힙에 있는 Java 객체 및 클래스에 관한 정보가 포함됩니다.
  • 스레드 덤프
    스레드 덤프는 실행 중인 Java 프로세스의 모든 스레드 상태에 대한 스냅샷입니다. 각 스레드의 상태는 스택 트레이스라고 하는 스택의 콘텐츠와 함께 표시됩니다.