您正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看
Apigee Edge 說明文件。
疑難排解是一門藝術,也是一門科學。Apigee 技術支援團隊一直致力於揭開這項技藝的神秘面紗,並揭露問題識別和解決方法背後的科學原理。
什麼是 Playbook?
Apigee 疑難排解手冊是由 Apigee 技術支援團隊共同開發,旨在針對您在使用 Apigee 產品時可能遇到的錯誤或其他問題,提供快速有效的解決方案。
目標對象
故障排除手冊適用於對 Apigee 及其架構有高層次瞭解,以及對政策和分析等基本概念有一定認識的讀者。
有些問題只有 Apigee 混合式使用者可以診斷及解決,而且可能需要瞭解 Cassandra 和 Postgres 資料儲存庫、訊息處理器和路由器等內部元件。
如果您使用的是 Apigee,我們會明確指出您何時可以執行所示疑難排解步驟,以及何時需要聯絡 Google Cloud Customer Care 尋求協助。
應對手冊
本節將說明目前的 Playbook。
如要篩選這個表格,請執行下列一或多項操作:選取類別、選取產品、輸入搜尋字詞,或按一下資料欄標題進行排序。
類別 | 應對手冊/問題說明 | 錯誤訊息 | 適用的應對手冊 |
---|---|---|---|
Cassandra | Cassandra TLS 憑證驗證失敗 | 如果 Apigee CA 憑證在叢集之間不相符,則 Cassandra 中的 TLS 憑證驗證可能會失敗。 | 僅限 Apigee Hybrid |
Cassandra | 排解 Cassandra 還原問題 | 在 Apigee hybrid 中還原 Cassandra 時,還原記錄中可能會出現錯誤。 | 僅限 Apigee Hybrid |
自動顯示問題 | 執行階段和控制層之間沒有網路連線 | Apigee API 管理要求失敗:
|
僅限 Apigee Hybrid |
自動顯示問題 | Virtual host 缺少環境群組 | 執行 kubectl -n apigee get apigeeissues 後,系統會顯示 AIS_VIRTUALHOST_MISSING_ENVGROUP 錯誤。 |
僅限 Apigee Hybrid |
自動顯示問題 | Virtual Host 缺少選取器 | 執行 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 |
Cassandra | Cassandra 資料複寫失敗 |
在多區域擴充期間複製資料時,CassandraDataReplication 狀態可能會顯示錯誤狀態,且資料複製作業可能會失敗。 |
僅限 Apigee Hybrid |
Cassandra | Cassandra Java 堆積空間問題 |
Cassandra 堆積問題可能會導致 Apigee 混合式 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 警告 | 「Details」對話方塊中會顯示「No active runtime pods」警告,該對話方塊位於 API Proxy 頁面上「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 | 發生傳輸層安全標準 (TLS) 錯誤,API 呼叫失敗 |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
僅限 Apigee Hybrid |
記錄 | 解決 Cloud Logging 中缺少 Apigee 記錄的問題 | 在這種情況下,系統不會顯示任何錯誤訊息。 | Apigee 和 Apigee Hybrid |
管理/使用者介面 | 透過混合型使用者介面或 Management API 中的實體資料不一致/找不到 | 在這種情況下,系統不會顯示任何錯誤訊息。 | 僅限 Apigee Hybrid |
網路設定 | Apigee 的存取路由問題 |
外部用戶端無法以所需方式存取/連線至 Apigee。包括網路連線失敗 (TLS 握手失敗) 或 Apigee 的 4xx/5xx 回應。 |
Apigee 和 Apigee Hybrid |
網路設定 | Apigee 與南向 PSC 目標的連線問題 |
如果 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 容器不在 Ready 狀態。
當您使用 kubectl 描述失敗的 apigee-runtime 容器時,您會看到以下錯誤: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 |
部署作業 | 執行個體未回報環境群組的狀態 | API Proxy 部署作業失敗,且在 Apigee 混合型 UI 中,Instance INSTANCE_NAME 未回報環境群組 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 無法提供服務錯誤,並顯示 TARGET_CONNECT_TIMEOUT (網路和 VPC 對等連線目標) | 本文說明如何使用網路或虛擬私有雲對等互連目標,診斷並修正「503 Service Unavailable」錯誤,並使用 TARGET_CONNECT_TIMEOUT 進行修正。 | Apigee |
網路設定 | 504 閘道逾時 - 目標讀取逾時 | 本文說明如何診斷及修正原因為 TARGET_READ_TIMEOUT 的「504 閘道逾時」錯誤。 | Apigee 和 Apigee Hybrid |
其他 | 解決 Apigee Hybrid 卡在建立或釋放狀態的問題 |
本文說明如何在 Apigee 混合元件卡在 creating 或 releasing 狀態時重設元件。 |
僅限 Apigee Hybrid |