このドキュメントでは、Amazon Managed Streaming for Apache Kafka（Amazon MSK）インポート トピックに関する一般的なトラブルシューティングのヒントを示します。
インポート トピックを構成してメッセージの取り込みを開始したら、関連する Cloud Monitoring 指標をチェックして、データが取り込まれているかどうかを確認できます。次の手順を行います。
コンソールで [トピック] ページに移動します。
トラブルシューティングする Amazon MSK インポート トピックをクリックします。
トピックの詳細ページで、[指標] タブをクリックします。
グラフで [Ingestion byte count] 指標を確認します。
データが取り込まれていない場合は、トピックの詳細ページで、[トピックの状態] フィールドにエラーがあるかどうかを確認します。
[取り込みデータソースの状態] の指標を確認することもできます。これを行うには、トピックの詳細ページで [指標] タブをクリックします。
発生する可能性のあるエラーの一覧を次に示します。
エラーコード 説明 修正 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 が正確であることを確認します。クラスタが存在し、アクセスできることを確認します。 TOPIC_NOT_FOUND指定された Kafka トピックが見つかりませんでした。 トピック名が正しいことを確認します。トピックが指定されたクラスタ内に存在することを確認します。
この時点でエラーがない場合は、正常なパブリッシャーの維持のベスト プラクティスを確認してください。
インポート トピックのプラットフォーム ログを有効にすることもできます。これらのログは、Pub/Sub インポート トピックにオブジェクトを取り込む際に問題が発生した場合のトラブルシューティングに役立ちます。
Apache Kafka® は、Apache Software Foundation または米国その他の諸国における関連会社の登録商標です。