インポート トピックのトラブルシューティング

このドキュメントでは、Pub/Sub のインポート トピックに関する一般的なトラブルシューティングのヒントを示します。

インポート トピックを構成してメッセージの取り込みを開始したら、関連する Cloud Monitoring 指標をチェックして、データが取り込まれているかどうかを確認できます。次の手順を行います。

  1. コンソールで [トピック] ページに移動します。

    [トピック] に移動

  2. トラブルシューティングするインポート トピックをクリックします。

  3. トピックの詳細ページで、[指標] タブをクリックします。

  4. グラフで [Ingestion byte count] 指標を確認します。

  5. データが取り込まれていない場合は、トピックの詳細ページで、[トピックの状態] フィールドにエラーがあるかどうかを確認します。

  6. [取り込みデータソースの状態] の指標を確認することもできます。これを行うには、トピックの詳細ページで [指標] タブをクリックします。

  7. 発生する可能性のあるエラーの一覧を次に示します。

    エラーコード 説明 修正
    KINESIS_PERMISSION_DENIED 権限の問題により、Kinesis データの使用時にエラーが発生した。 AWS ロールの ARN が正しいことを確認し、AWS ロールに必要な Kinesis 読み取り権限があることを確認します。詳細については、AWS でポリシーを作成するをご覧ください。
    サービス アカウントが存在し、カスタム信頼ポリシーを使用して AWS でロールを作成するの手順に沿って、正しく構成されていることを確認します。サービス アカウントを作成する方法の詳細については、Google Cloud でサービス アカウントを作成するをご覧ください。
    Pub/Sub サービス アカウントに iam.serviceAccounts.getOpenIdToken 権限があることを確認します。 詳細については、Pub/Sub サービス アカウントにサービス アカウント トークン作成者のロールを追加するをご覧ください。
    サービス アカウントにサービス アカウント ユーザーロールが追加されていることを確認します。詳細については、サービス アカウントにサービス アカウント ユーザーロールを追加するをご覧ください。
    PUBLISH_PERMISSION_DENIED 権限の問題により、トピックへの公開時にエラーが発生した。 Pub/Sub サービス アカウントに必要な公開権限を付与します。詳細については、Pub/Sub パブリッシャーのロールを Pub/Sub サービス アカウントに追加するをご覧ください。
    STREAM_NOT_FOUND 指定された Kinesis ストリームが見つからない。 ストリームの ARN が正確であることを確認します。
    CONSUMER_NOT_FOUND Kinesis コンシューマが見つからない。 コンシューマの ARN が正確であることを確認します。必要に応じて、コンシューマを再作成します。

  8. この時点でエラーがない場合は、正常なパブリッシャーの維持のベスト プラクティスを確認してください。