排解 Cloud Storage 匯入主題的疑難問題

本文提供一些常見的 Cloud Storage 匯入主題疑難排解提示。

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

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

   前往「主題」

2. 按一下要進行疑難排解的 Cloud Storage 匯入主題。

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

4. 查看「攝入位元組數量」指標的圖表。

5. 如果沒有擷取任何資料，請在主題詳細資料頁面中檢查「主題狀態」欄位是否有錯誤和紅色驚嘆號。

6. 您也可以查看「擷取資料來源狀態」指標。如要這樣做，請在主題詳細資料頁面中按一下「指標」分頁標籤。

   如要進一步瞭解這些指標，請參閱「用於監控匯入主題的指標」。

7. 以下是您可能遇到的錯誤清單：

   錯誤代碼	說明	修正
   CLOUD_STORAGE_PERMISSION_DENIED	權限問題導致無法使用 Cloud Storage 資料。	請確認 Pub/Sub 服務帳戶具備存取 Cloud Storage 值區的必要權限。請確認服務帳戶具備下列權限： storage.objects.list：列出值區中的物件。 storage.objects.get：讀取值區中的物件。 storage.buckets.get：取得值區位置，以及值區是否存在。 詳情請參閱建立 Cloud Storage 主題的必要條件。
   PUBLISH_PERMISSION_DENIED	因權限問題，無法發布至主題。	授予 Pub/Sub 服務帳戶必要的發布權限。詳情請參閱「為 Pub/Sub 服務帳戶新增 Pub/Sub 發布者角色」。
   BUCKET_NOT_FOUND	找不到指定的 Cloud Storage 值區。	確認 bucket 名稱是否正確無誤。
   TOO_MANY_OBJECTS	Cloud Storage 值區內的物件過多，因此已暫停擷取。值區中的物件數量少於 5,000 萬後，系統就會恢復攝入作業。	物件上限為 5000 萬。請減少集區中的物件數量，或洽詢 Google Cloud 支援團隊尋求協助。

如果到目前為止沒有任何錯誤，請參閱維持健康的發布商中的最佳做法。

您也可以為 Cloud Storage 匯入主題啟用平台記錄。當您在將物件擷取至 Pub/Sub 匯入主題時遇到問題時，這些記錄可協助您排解問題。