錯誤訊息參考資料

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

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

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 資料未顯示在數據分析資訊主頁
本主題說明如何執行通常要求的工作。 在數據分析群組中新增及刪除數據分析元件
Could not get data for path 設定多個軸群組時，自訂維度無法顯示

部署錯誤

許多原因都可能導致 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 = [] 處理錯誤更新

開發人員入口網站錯誤

這些主題可協助您解決使用開發人員入口網站時可能遇到的問題。嘗試修正開發人員入口網站問題前，請務必您已熟悉開發人員入口網站的基本概念，詳情請參閱開發人員入口網站疑難排解 Overiew 中的說明。
錯誤訊息或說明 教戰手冊
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 Proxy。 錯誤的設定檔

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 問題。
錯誤訊息或說明 教戰手冊
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] 無法啟動動物守門員

診斷工具和記錄

以下主題介紹了工具和記錄檔，您可以利用這些工具和記錄檔診斷您在使用 Apigee Edge 時可能會遇到的特定問題。

  • TCP/IP 封包 sniffer (tcpdump) 公用程式
    tcpdump 工具是一種指令列封包 Sniffer 工具，可讓您擷取或篩選透過網路接收或傳輸的 TCP/IP 封包。
  • 記憶體快照資料
    記憶體快照資料是 Java 程序的記憶體快照。其中包含在收集記憶體快照資料時，當下的 Java 物件和類別相關資訊。
  • 執行緒傾印
    執行緒傾印是執行中 Java 程序所有執行緒的狀態快照。每個執行緒的狀態都會呈現其堆疊的內容，這稱為堆疊追蹤。