このドキュメントでは、Cloud Storage のインポート トピックに関する一般的なトラブルシューティングのヒントを示します。
インポート トピックを構成してメッセージの取り込みを開始したら、関連する Cloud Monitoring 指標をチェックして、データが取り込まれているかどうかを確認できます。次の手順を行います。
コンソールで [トピック] ページに移動します。
トラブルシューティングする Cloud Storage インポート トピックをクリックします。
トピックの詳細ページで、[指標] タブをクリックします。
グラフで [Ingestion byte count] 指標を確認します。
データが取り込まれていない場合は、トピックの詳細ページで、[トピックの状態] フィールドにエラーと赤い感嘆符があるかどうかを確認します。
[取り込みデータソースの状態] の指標を確認することもできます。これを行うには、トピックの詳細ページで [指標] タブをクリックします。
これらの指標の詳細については、インポートのトピックをモニタリングする指標をご覧ください。
発生する可能性のあるエラーの一覧を次に示します。
エラーコード 説明 修正 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 バケットが見つかりませんでした。 バケット名が正しいことを確認します。 TOO_MANY_OBJECTSCloud Storage バケットにオブジェクトが多すぎるため、取り込みが一時停止されています。バケット内のオブジェクト数が 5,000 万未満になると、取り込みが再開されます。 オブジェクトの上限は 5,000 万個です。バケット内のオブジェクトの数を減らすか、Google Cloud サポートにお問い合わせください。
この時点でエラーがない場合は、正常なパブリッシャーの維持のベスト プラクティスを確認してください。
Cloud Storage インポート トピックでプラットフォーム ログを有効にすることもできます。これらのログは、Pub/Sub インポート トピックにオブジェクトを取り込む際に問題が発生した場合のトラブルシューティングに役立ちます。