このドキュメントでは、Amazon Kinesis Data Streams インポート トピックに関する一般的なトラブルシューティングのヒントを示します。
インポート トピックを構成してメッセージの取り込みを開始したら、関連する Cloud Monitoring 指標をチェックして、データが取り込まれているかどうかを確認できます。次の手順を行います。
コンソールで [トピック] ページに移動します。
トラブルシューティングする Amazon Kinesis Data Streams インポート トピックをクリックします。
トピックの詳細ページで、[指標] タブをクリックします。
グラフで [Ingestion byte count] 指標を確認します。
データが取り込まれていない場合は、トピックの詳細ページで、[トピックの状態] フィールドにエラーがあるかどうかを確認します。
[取り込みデータソースの状態] の指標を確認することもできます。これを行うには、トピックの詳細ページで [指標] タブをクリックします。
発生する可能性のあるエラーの一覧を次に示します。
エラーコード 説明 修正 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 が正確であることを確認します。必要に応じて、使用者を再作成します。 この時点でエラーがない場合は、正常なパブリッシャーの維持のベスト プラクティスを確認してください。