錯誤訊息參考資料

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

本頁面提供疑難排解手冊的連結，協助您解決使用 Apigee Edge 時可能遇到的錯誤和其他問題。每份疑難排解劇本都會說明如何診斷及解決各類問題。

Analytics 問題

這些主題說明如何排解 Analytics 資訊主頁或自訂報表未顯示 Analytics 資料的案例。

錯誤訊息或說明 應對手冊
The report timed out: Try again with a smaller date range or a larger aggregation interval.

Analytics 報表逾時

或：

報表已逾時
除非 Postgres 伺服器上的磁碟空間完全填滿，否則您可能不會看到任何錯誤訊息。 Postgres 伺服器磁碟空間不足
未觀察到任何錯誤。 自訂變數不會顯示在 Analytics 自訂報表中
No traffic in the selected date range 分析資訊主頁未顯示資料
本主題說明如何執行常見要求的工作。 在 Analytics 群組中新增及刪除 Analytics 元件
Could not get data for path 設定多個 axgroup 時，系統不會顯示自訂維度

部署錯誤

API Proxy 可能因各種原因而無法部署，例如 Edge 伺服器之間的網路連線問題、Cassandra 資料存放區問題、ZooKeeper 例外狀況，以及 API Proxy 套件中的錯誤。本節提供一些特定程序的相關資訊和指引，可用於排解部署錯誤。
錯誤訊息或說明 應對手冊
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>
開發人員帳戶已停權
您可能不會看到任何錯誤訊息，但會遇到「 營利設定問題」一文「 問題」一節中說明的問題。 營利設定問題

邊緣路由器問題

邊緣路由器是使用 NGINX 實作而成。在 Edge 升級程序中，或變更 Router 的設定時，可能會看到 NGINX 設定錯誤。以下主題將說明如何解決這類問題。

錯誤訊息或說明 應對手冊
系統不會顯示任何錯誤訊息。不過，由於設定檔有誤，您可能無法執行 API Proxy。 設定檔錯誤
429 Too Many Requests: Tuning Nginx Router connection limits 429 要求數量過多

OpenLDAP 問題

下列主題有助於排解及修正常見的 OpenLDAP 問題。

錯誤訊息或說明 應對手冊
Unknown username and password combination. SMTP 已停用，使用者必須重設密碼
沒有顯示任何錯誤，Edge 使用者介面只是未顯示應已複製到所有 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 Internal Server Error
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 Service Unavailable
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 Gateway Timeout

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 使用者介面可能會顯示這則錯誤訊息：

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 程序所有執行緒狀態的快照。每個執行緒的狀態都會以堆疊內容呈現，也就是所謂的堆疊追蹤。