本頁面適用於 Apigee 和 Apigee Hybrid。
查看 Apigee Edge 說明文件。
疑難排解是一門藝術,也是一門科學。Apigee 技術支援團隊持續努力,揭開問題識別和解決背後的藝術和科學。
什麼是應對手冊?
Apigee 疑難排解教戰手冊由 Apigee 技術支援團隊合作開發,旨在提供快速有效的解決方案,協助您解決使用 Apigee 產品時可能遇到的錯誤或其他問題。
目標對象
疑難排解教戰手冊適用於對 Apigee 及其架構有高階瞭解,並對政策和數據分析等基本概念有一定瞭解的讀者。
部分問題只能由 Apigee hybrid 使用者診斷及解決,且可能需要具備 Cassandra 資料儲存庫、訊息處理器和同步器等內部元件的相關知識。
如果您使用的是 Apigee,我們會明確指出何時可以執行指定的疑難排解步驟,以及何時需要與 Google Cloud Customer Care 聯絡尋求協助。
應對手冊
本節說明目前的教戰手冊。
如要篩選這個表格,請執行下列一或多項操作:選取類別、選取產品、輸入搜尋字詞,或按一下資料欄標題來排序。
| 類別 | 教戰手冊/問題說明 | 錯誤訊息 | 應對手冊適用對象 |
|---|---|---|---|
| Cassandra | Cassandra TLS 憑證驗證失敗 | 如果 Apigee CA 憑證在叢集之間不相符,Cassandra 中的 TLS 憑證驗證可能會失敗。 | 僅限 Apigee hybrid |
| Cassandra | 排解 Cassandra 還原問題 | 在 Apigee hybrid 中還原 Cassandra 時,還原記錄可能會出現錯誤。 | 僅限 Apigee hybrid |
| 自動顯示問題 | 執行階段層與控制層之間沒有網路連線 | Apigee API 管理要求失敗:
|
僅限 Apigee hybrid |
| 自動顯示問題 | 虛擬主機缺少環境群組 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_VIRTUALHOST_MISSING_ENVGROUP 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | 虛擬主機缺少選取器 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_VIRTUALHOST_MISSING_SELECTOR 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | Ingress 憑證不符 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_INGRESS_CERT_MISMATCH 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | Ingress 憑證到期日 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_INGRESS_CERT_EXPIREY 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | Ingress mTLS CA 憑證到期 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_INGRESS_MTLS_CA_CERT_EXPIREY 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | Ingress mTLS CA 憑證無效 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_INGRESS_MTLS_CA_CERT_INVALID 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | MCP mTLS 用戶端憑證到期 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_MCP_MTLS_CLIENT_CERT_EXPIRY 問題。 |
僅限 Apigee hybrid |
| 自動顯示問題 | MCP mTLS 用戶端憑證無效 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_MCP_MTLS_CLIENT_CERT_INVALID 錯誤。 |
僅限 Apigee hybrid |
| 自動顯示問題 | MCP mTLS CA 憑證到期 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_MCP_MTLS_CA_CERT_EXPIRY 問題。 |
僅限 Apigee hybrid |
| 自動顯示問題 | MCP mTLS CA 憑證無效 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_MCP_MTLS_CA_CERT_INVALID 錯誤。 |
僅限 Apigee hybrid |
| Cassandra | Cassandra 資料複製失敗 |
在多區域擴充期間複製資料時,CassandraDataReplication 狀態可能會顯示錯誤狀態,且資料複製作業可能會失敗。 |
僅限 Apigee hybrid |
| Cassandra | Cassandra Java 堆積空間問題 |
Cassandra 堆積問題可能會導致 Apigee hybrid Proxy 執行速度緩慢,甚至發生 Datastore 錯誤。有時記錄會是早期指標,甚至在症狀出現前就會顯示。 |
僅限 Apigee hybrid |
| Cassandra | Cassandra Pod 未在次要區域啟動 |
在多區域混合設定中,Cassandra Pod 無法在其中一個區域啟動。Cassandra Pod 記錄中可能會顯示 node already exists 錯誤訊息,或 Cassandra Pod 狀態中可能會顯示 FailedPreStopHook 警告。 |
僅限 Apigee hybrid |
| Cassandra | Cassandra 疑難排解指南 |
使用 kubectl 查看 Pod 狀態時,您會發現一或多個 Cassandra Pod 卡住。本指南說明如何診斷及解決 Cassandra 資料儲存庫的問題。 |
僅限 Apigee hybrid |
| 部署作業 | API Proxy 部署作業失敗,並顯示「沒有任何執行中的執行階段 Pod」警告 | 在 API Proxy 頁面上,No active runtime pods 警告會顯示在「Details」對話方塊中,旁邊會顯示錯誤訊息 Deployment issues on ENVIRONMENT: REVISION_NUMBER。 | 僅限 Apigee hybrid |
| Ingressgateway | API 呼叫失敗,並顯示逾時錯誤 |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
僅限 Apigee hybrid |
| Ingressgateway | API 呼叫失敗,並顯示 TLS 錯誤 |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
僅限 Apigee hybrid |
| 記錄 | 排解 Cloud Logging 缺少 Apigee 記錄的問題 | 在這種情況下,系統不會顯示任何錯誤訊息。 | Apigee 和 Apigee hybrid |
| 管理/使用者介面 | 在混合式 UI 或透過 Management API 觀察到的實體資料不一致/沒有資料 | 在這種情況下,系統不會顯示任何錯誤訊息。 | 僅限 Apigee hybrid |
| 網路設定 | Apigee 的存取路由問題 |
外部用戶端無法以預期的方式存取/連線至 Apigee。包括網路連線失敗 (TLS 握手失敗) 或 Apigee 的 4xx/5xx 回應。 |
Apigee 和 Apigee hybrid |
| 網路設定 | Apigee 與 Northbound Private Service Connect 的連線能力問題 |
北向 Private Service Connect 設定無法正常運作,網路端點群組狀態仍為 Pending。 |
僅限 Apigee |
| 網路設定 | Apigee 與南向 Private Service Connect 目標的連線問題 |
Apigee 與目標服務之間的網路連線問題或 TCP 逾時,會顯示為 503 錯誤回應,如果您建立偵錯工作階段,則會顯示類似下方的錯誤。{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee 和 Apigee hybrid |
| 其他 | 在排空節點時,增加 Istio 屬性副本數量 | Istio Pod 耗盡時,部分節點可能不會耗盡,因為這些節點的副本數量為 1,但需要 3 個以上的副本。為避免這種情況,請將每項資源的副本數量下限設為至少 3 個。 | 僅限 Apigee hybrid |
| 其他 | 訊息處理器疑難排解指南 |
一或多個 apigee-runtime Pod 未處於 Ready 狀態。使用 kubectl 描述失敗的 apigee-runtime Pod 時,會看到以下錯誤:Readiness probe failed: HTTP probe failed with statuscode: 500 |
僅限 Apigee hybrid |
| 其他 | 列印建構資訊 |
buildinfo API 會傳回執行階段元件目前建構作業的相關資訊。聯絡支援團隊時,可能需要提供這項資訊。
|
僅限 Apigee hybrid |
| 其他 | StreamingPull 錯誤 100% |
如果指標資訊主頁顯示 google.pubsub.vl.Subscriber.StreamingPull 方法失敗,且錯誤率為 100%,可以放心忽略這個問題。這是正常現象。 |
僅限 Apigee hybrid |
| 部署作業 | 執行個體未回報環境群組的狀態 | 在 Apigee Hybrid UI 中,API Proxy 部署作業失敗,並顯示「Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME 」(執行個體 未回報環境群組 的狀態) 錯誤。 | 僅限 Apigee hybrid |
| 部署作業 | API Proxy 部署作業失敗,並顯示找不到 apigee-serving-cert 或已過期 |
API Proxy 部署作業失敗,apigee-watcher 記錄中顯示錯誤訊息。 |
僅限 Apigee hybrid |
| Ingressgateway | 展開 Istio 屬性副本數量,避免在耗盡 Istio 節點時發生問題 |
在 Istio Pod 耗盡時,部分節點可能不會耗盡,因為其副本數量為 1,但需要 3 個以上的副本。為避免這種情況,請將每項資源的副本數量下限設為至少 3 個。 |
僅限 Apigee hybrid |
| 網路設定 | 沒有可用的 IP 位址空間疑難排解 | 在 Apigee 佈建期間,如果您選取的網路 CIDR 範圍並非完全可用,可能會看到錯誤訊息。 | Apigee 和 Apigee hybrid |
| 網路設定 | 503 Service Unavailable 錯誤,並顯示 TARGET_CONNECT_TIMEOUT (網際網路和虛擬私有雲對接目標) | 本文說明如何診斷及修正使用網際網路或虛擬私有雲對接目標時,TARGET_CONNECT_TIMEOUT 造成的「503 Service Unavailable」錯誤。 | Apigee |
| 網路設定 | 504 Gateway timeout - Target read timeout | 本文說明如何診斷及修正原因為 TARGET_READ_TIMEOUT 的「504 Gateway Timeout」錯誤。 | Apigee 和 Apigee hybrid |
| 執行階段 | API 要求失敗,並顯示 TARGET CONNECT HOST NOT REACHABLE 錯誤 | 本文說明如何診斷及解決 HTTP 503 回應狀態碼錯誤,原因為「TARGET_CONNECT_HOST_NOT_REACHABLE」。 | Apigee 和 Apigee hybrid |
| 執行階段 | API 要求失敗,並顯示 502 Bad Gateway「Unexpected EOF at target」錯誤 | 本教戰手冊說明如何診斷及解決 502 Bad Gateway Unexpected EOF 錯誤。 | Apigee 和 Apigee hybrid |
| 其他 | 排解 Apigee Hybrid 卡在建立或釋出狀態的問題 |
本文說明如何重設卡在 creating 或 releasing 狀態的 Apigee hybrid 元件。 |
僅限 Apigee hybrid |
| 其他 | 立即刪除 Apigee 或 Apigee Hybrid 組織 |
本文說明如何使用 NO_RETENTION 選項,立即刪除 Apigee 或 Apigee Hybrid 組織,而不保留任何資料。 |
Apigee 和 Apigee hybrid |
| Apigee hybrid 安裝與升級 | Cassandra Pod 處於 CrashLoopBackOff 狀態 | Cassandra Pod 在安裝或升級後卡在 CrashLoopBackOff 狀態。 | 僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | Apigee Metrics Pod 處於 CrashLoopBackOff 狀態 | 安裝或升級後,Apigee Metrics Pod 仍處於 CrashLoopBackOff 狀態。 | 僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | Apigee 輸入閘道 Pod 顯示 2 個容器中有 1 個正在執行 |
取得 Pod 清單時,apigee-ingressgateway Pod 只會顯示 2 個容器中的 1 個正在執行。 |
僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | UDCA Pod 錯誤 | UDCA 和 Connect 代理程式 Pod 擲回權限問題錯誤。 | 僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | 非 SNI 用戶端在 TLS 握手期間重設連線 | 非 SNI 用戶端在 TLS 握手期間會重設連線。 | 僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | Cassandra 磁碟空間不足 | Cassandra 資料庫的磁碟空間不足,導致 Apigee hybrid 安裝程序失敗。 | 僅限 Apigee hybrid |
| Apigee hybrid 安裝與升級 | CPU 不足 |
使用 kubectl 查看 Pod 狀態時,您會看到一或多個 Pod 處於 CrashLoopBackoff 或 FailedScheduling 狀態。 |
僅限 Apigee hybrid |