您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
本頁面提供疑難排解教戰手冊的連結,協助您瞭解使用 Apigee Edge 時可能遇到的錯誤和其他問題。每一份疑難排解教戰手冊都會說明如何診斷並解決各種問題。
Analytics (分析) 問題
這些主題說明如何排解數據分析資料未顯示在 Analytics (分析) 資訊主頁或自訂報表中的情況。
錯誤訊息或說明 | 教戰手冊 |
---|---|
The report timed out: Try again with a smaller
date range or a larger aggregation interval. |
或: |
除非 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 程序所有執行緒的狀態快照。每個執行緒的狀態都會呈現其堆疊的內容,這稱為堆疊追蹤。