您目前正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看
Apigee Edge 說明文件。
疑難排解是一門藝術，也是一門科學。Apigee 技術支援團隊一直努力揭開問題識別和解決背後的科學原理，
什麼是應對手冊？
Apigee 疑難排解手冊是與 Apigee 技術支援團隊合作開發，旨在針對您使用 Apigee 產品時可能遇到的錯誤或其他問題，提供快速有效的解決方法。
目標對象
疑難排解劇本適用於對 Apigee 及其架構有高階瞭解，且對政策和數據分析等基本概念有一定認識的讀者。
部分問題只能由 Apigee Hybrid 使用者診斷及解決，可能需要瞭解內部元件，例如 Cassandra 和 Postgres 資料存放區、訊息處理器和路由器。
如果您使用 Apigee，我們會明確指出何時可以執行指定的疑難排解步驟，以及何時需要聯絡 Google Cloud 客戶服務團隊尋求協助。
應對手冊
本節說明目前的劇本。
如要篩選這個表格，請執行下列一或多個動作：選取類別、選取產品、輸入搜尋字詞，或按一下資料欄標題進行排序。
| 類別 | 應對手冊/問題說明 | 錯誤訊息 | 適用於 |
|---|---|---|---|
| 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 |
| 自動顯示問題 | 輸入憑證到期時間 | 執行 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 Hybrid 代理程式執行速度緩慢，甚至發生 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 頁面上的錯誤訊息「ENVIRONMENT 部署問題：REVISION_NUMBER」旁，會顯示「沒有有效的執行階段 pod」警告訊息。點選「詳細資料」對話方塊中的警告訊息，即可查看詳細資料。 | 僅限 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 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 使用者介面中，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 無法提供服務錯誤，並顯示 TARGET_CONNECT_TIMEOUT (網際網路和 VPC 對等互連目標) | 本文說明如何診斷及修正使用網際網路或 VPC 對等互連目標時，發生「503 Service Unavailable」錯誤和 TARGET_CONNECT_TIMEOUT 的問題。 | Apigee |
| 網路設定 | 504 閘道逾時 - 目標讀取逾時 | 本文說明如何診斷及修正「504 Gateway Timeout」錯誤，原因為 TARGET_READ_TIMEOUT。 | Apigee 和 Apigee Hybrid |
| 其他 | 排解 Apigee Hybrid 停滯在建立或發布狀態的問題 |
本文說明如何重設處於 creating 或 releasing 狀態的 Apigee Hybrid 元件。 |
僅限 Apigee Hybrid |
| Apigee Hybrid 安裝與升級 | 處於 CrashLoopBackOff 狀態的 Cassandra Pod | 安裝或升級後，Cassandra Pod 停滯在 CrashLoopBackOff 狀態。 | 僅限 Apigee Hybrid |