錯誤訊息參考資料

您正在查看 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 伺服器磁碟空間不足
沒有發現任何錯誤。 自訂報表無法顯示自訂變數
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. OR 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>
Developer 帳戶遭到停權
您可能不會看到任何錯誤訊息，但會遇到「營利功能設定問題」中的「症狀」一節所述的問題。 營利設定問題

Edge Router 問題

Edge Router 是使用 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 OR 
{
   "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 OR 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 閘道錯誤
HTTP/1.1 503 Service Unavailable OR HTTP/1.1 503 Service Unavailable: Back-end server is at capacity OR 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
503 服務無法使用
HTTP/1.1 503 Service Unavailable OR Received fatal alert: handshake_failure SSL 握手失敗
HTTP/1.1 503 Service Unavailable OR 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL 握手失敗 - 用戶端憑證錯誤
HTTP/1.1 504 Gateway Timeout OR 
{
   "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 使用者介面可能會顯示以下錯誤：

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 程序所有執行緒狀態的快照。每個執行緒的狀態會隨堆疊內容一併顯示，這稱為堆疊追蹤。