Apigee 和 Apigee Hybrid 教戰手冊簡介

您正在查看 ApigeeApigee 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 UI 中未填入 API 產品、開發人員和應用程式。
  • API Proxy 部署作業無法完成。
  • 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 混合元件卡在 creatingreleasing 狀態時重設元件。 僅限 Apigee Hybrid