排解 Amazon Managed Streaming for Apache Kafka 匯入主題的問題

本文提供 Amazon Managed Streaming for Apache Kafka (Amazon MSK) 匯入主題的一些常見疑難排解提示。

設定匯入主題並開始擷取訊息後，您可以查看相關的 Cloud Monitoring 指標，確認資料是否已擷取。請執行下列步驟：

1. 前往控制台的「主題」頁面。

   前往「主題」

2. 按一下要排解問題的 Amazon MSK 匯入主題。

3. 在主題詳細資料頁面中，按一下「指標」分頁標籤。

4. 查看「擷取位元組計數」指標的圖表。

5. 如果系統未擷取任何資料，請在主題詳細資料頁面中，檢查「主題狀態」欄位是否有錯誤。

6. 您也可以查看「Ingestion data source state」指標。如要查看指標，請在主題詳細資料頁面中，按一下「指標」分頁標籤。

7. 以下列出您可能會遇到的錯誤：

   錯誤代碼	說明	修正
   MSK_PERMISSION_DENIED	因權限問題，無法使用 Amazon MSK 資料。	確認 AWS 角色 ARN 是否正確，並檢查 AWS 角色是否具備必要的讀取權限。詳情請參閱「在 AWS 中建立政策」。
   		確認服務帳戶存在，且已按照「使用自訂信任政策在 AWS 中建立角色」程序所述，正確設定服務帳戶。如要進一步瞭解如何建立服務帳戶，請參閱「在 Google Cloud中建立服務帳戶」。
   		確認 Pub/Sub 服務帳戶具備 iam.serviceAccounts.getOpenIdToken 權限。詳情請參閱為 Pub/Sub 服務帳戶新增服務帳戶憑證建立者角色。
   		確認您已將服務帳戶使用者角色新增至服務帳戶。詳情請參閱「為服務帳戶新增服務帳戶使用者角色」。
   PUBLISH_PERMISSION_DENIED	因權限問題，無法發布至 Pub/Sub 主題。	授予 Pub/Sub 服務帳戶必要發布權限。詳情請參閱「為 Pub/Sub 服務帳戶新增 Pub/Sub 發布者角色」。
   CLUSTER_NOT_FOUND	找不到提供的叢集。	確認叢集 ARN 是否正確。確認叢集存在且可存取。
   Cluster is not public	無法存取提供的叢集	系統不支援虛擬私有雲後方的非公開叢集。您必須使用公開叢集。
   TOPIC_NOT_FOUND	找不到提供的 Kafka 主題。	確認主題名稱是否正確。確認主題位於指定叢集內。

如果到目前為止都沒有錯誤，請參閱「維持發布商的良好狀態」中的最佳做法。

您也可以為匯入主題啟用平台記錄。如果將物件擷取至 Pub/Sub 匯入主題時發生問題，這些記錄可協助您排解問題。

Apache Kafka® 是 The Apache Software Foundation 或其關聯企業在美國與/或其他國家/地區的註冊商標。