疑難排解 Event Streams

使用疑難排解提示來瞭解如何對 IBM® Event Streams for IBM Cloud®問題進行疑難排解。

網路相關問題

如果您有一個 Apache Kafka 應用程式無法連接至主題，或由於網路問題而無法從主題耗用或產生至主題，則可能會以下列不同方式列入清單。

無法解析主機。使用 nslookup 或 dig 來檢查是否可以解析分配管理系統位址。如果 nslookup 或 dig 失敗，請檢查 DNS 伺服器。通常，公用端點會解析為三個公用 IP，如下列範例所示。

$ nslookup broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com
Server:		172.31.255.241
Address:	172.31.255.241#53
Non-authoritative answer:
broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com	canonical name = kafka.svc08.us-south.eventstreams.cloud.ibm.com.
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 169.48.243.82
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 169.61.217.150
Name:	kafka.svc08.us-south.eventstreams.cloud.ibm.com
Address: 52.117.238.34

專用端點解析為三個以 166.9開頭的專用 IP。

$ nslookup kafka-0-mh-int-pipe-mzr-cse-kjh.private.us-south.messagehub.test.appdomain.cloud
Server:		172.31.255.241
Address:	172.31.255.241#53

連線逾時。使用 netcat (nc) 來檢查與分配管理系統的連線功能。
```
$ nc -zv broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com 9093
Connection to broker-0-93g2bbjd0pz8ghkj.kafka.svc08.us-south.eventstreams.cloud.ibm.com port 9093 [tcp/*] succeeded!
```
nc 指令逾時表示執行用戶端應用程式的網路無法連接至分配管理系統位址。原因有多種，例如防火牆規則、calico 網路原則及服務網眼設定。請與您的網路管理者合作，讓 netcat 運作。如果服務實例位於企業方案上，且叢集具有僅限專用服務端點，請檢查用戶端應用程式的 IP 是否已新增至 IP 允許清單或 CBR 規則。如需相關資訊，請參閱限制網路存取權。
連線重設或用戶端斷線。這不一定是網路問題，而不是應用程式層次問題。

在維護時間期間，會以漸進式方式重新啟動分配管理系統及 Proxy，且 Kafka 用戶端可能會看到斷線異常狀況。使用正確的配置，Kafka 用戶端會立即重新連接至不同的分配管理系統，因此可用性不受影響。如果您的應用程式長時間中斷連線，請在啟用除錯的情況下共用 Kafka 用戶端程式庫版本、用戶端配置及日誌，我們將檢閱並建議適當的值，以將用戶端配置成具復原力的分配管理系統重新啟動。如需支援的 Kafka 用戶端程式庫，請參閱建議用戶端清單。

如果問題持續存在，請提出支援問題單以進一步調查。

REST API 的 HTTP 錯誤代碼以及如何修復它們

HTTP 錯誤代碼適用於 REST API，包括 Admin REST、REST Producer 和 Schema Registry。

REST API 的 HTTP 錯誤代碼以及如何修復它們
HTTP 錯誤碼	管理 REST	REST 生產者	綱目登錄
400	不當的要求-不是有效的要求。請更正您的要求。	不當的要求-不是有效的要求。此錯誤可能是由形態異常的有效負載或不受支援的金鑰類型或超出金鑰/訊息大小所導致。	不當的要求-不是有效的要求。請更正您的要求。
403	無權執行該操作。使用的 API 金鑰遺漏特定角色。用來建立資源金鑰的 ID 沒有 IAM 原則。如需相關資訊，請參閱管理 Event Streams 實例的鑑別。	禁止。您提供的記號沒有足夠許可權來產生主題。請檢查您是否已提供具有必要存取角色的記號。如需相關資訊，請參閱管理 Event Streams 實例的鑑別。	禁止。客戶端無權執行此請求。服務 ID 未獲授權存取綱目資源。如需相關資訊，請參閱管理 Event Streams 實例的鑑別。
404	找不到。找不到具有您指定主題名稱的主題。Event Streams 將 `auto.create.topics.enable` 設為 `false`，因此必須先明確建立主題，才能使用它。	找不到。主題不存在。Event Streams 將 `auto.create.topics.enable` 設為 `false`，因此必須先明確建立主題，然後再產生訊息給它。	找不到。登錄不包含具有指定綱目 ID 的綱目，或綱目 ID 所識別的綱目不包含對應於指定版本號碼的版本，或綱目未配置指定的規則類型。
415		媒體類型不受支援。
422	要求語意無效。您有形態異常的要求。如果您在嘗試建立新主題時收到此錯誤，則可能是因為計劃容許的分割區數目上限。如需相關資訊，請參閱 Event Streams 如何使用限制和配額來驗證限制。
503	無法使用服務。要求失敗，因為 Event Streams 分配管理系統無法使用。處理請求時發生錯誤。無法使用服務。如果您在建立新主題失敗時收到此錯誤，請驗證限制和配額。	無法使用服務。要求失敗，因為 Event Streams 分配管理系統無法使用。

Kafka API 是 TCP 型 API。如需相關資訊，請參閱其有關錯誤碼的通訊協定手冊。

無法建立 Kafka 主題

如果您無法建立主題，可能是因為下列原因:

您沒有叢集上的管理角色。
磁碟空間不足。請檢查根據主題配置來保留磁碟空間。若要解決此問題，請刪除未用的主題，並將主題的配置 retention.ms 及 retention.bytes 更新為較小。若為企業實例，請調整叢集。如需相關資訊，請參閱調整企業方案容量。

錯誤“發送訊息失敗”

Event Streams 目標傳回錯誤，且您無法向其發送事件。查看日誌時，錯誤為“發送訊息失敗”，條目包含以下資訊：

“發送訊息失敗”，“錯誤”：“kafka伺服器：請求的主題或分區在此代理上不存在”，“原因”：“invalid_or_unreachable_topic”

如果主題尚未建立或已刪除，或者您將資料傳送至不是主題分區的目前領導者的代理，則可能會發生此錯誤。主題分區的領導地位可能會隨著時間的推移而變化，因為如果代理因任何原因離線，其分區的領導地位將轉移到其他代理，直到它恢復。

若要解決該問題，請驗證主題是否存在。透過正確的配置，Kafka 用戶端會快速刷新元資料或重新連接到不同的代理，因此此類錯誤情況通常會自行恢復。如果問題仍然存在，請聯絡雲端支援進行問題調查。