このドキュメントでは、Confluent Cloud のインポート トピックに関する一般的なトラブルシューティングのヒントを示します。
インポート トピックを構成してメッセージの取り込みを開始したら、関連する Cloud Monitoring 指標をチェックして、データが取り込まれているかどうかを確認できます。次の手順を行います。
コンソールで [トピック] ページに移動します。
トラブルシューティングする Confluent Cloud インポート トピックをクリックします。
トピックの詳細ページで、[指標] タブをクリックします。
グラフで [Ingestion byte count] 指標を確認します。
データが取り込まれていない場合は、トピックの詳細ページで、[トピックの状態] フィールドにエラーがあるかどうかを確認します。
[取り込みデータソースの状態] の指標を確認することもできます。これを行うには、トピックの詳細ページで [指標] タブをクリックします。
発生する可能性のあるエラーの一覧を次に示します。
エラーコード 説明 修正 CONFLUENT_CLOUD_PERMISSION_DENIED
権限の問題により、Confluent Cloud からのデータの使用時にエラーが発生した。 ID プロバイダが正しく構成され、 ID プールに適切なロールが付与されていることを確認します。 Pub/Sub サービス アカウントに iam.serviceAccounts.getOpenIdToken
権限があることを確認します。詳細については、Pub/Sub サービス アカウントにサービス アカウント トークン作成者のロールを追加するをご覧ください。サービス アカウントにサービス アカウント ユーザーロールが追加されていることを確認します。詳細については、サービス アカウントにサービス アカウント ユーザーロールを追加するをご覧ください。 PUBLISH_PERMISSION_DENIED
権限の問題により、トピックへの公開時にエラーが発生した。 Pub/Sub サービス アカウントに必要な公開権限を付与します。詳細については、Pub/Sub パブリッシャーのロールを Pub/Sub サービス アカウントに追加するをご覧ください。 UNREACHABLE_BOOTSTRAP_SERVER
指定されたブートストラップ サーバーのアドレスに到達できません。 ブートストラップ サーバーのアドレスが正しいことを確認し、サーバーが一般公開されていることを確認します。 CLUSTER_NOT_FOUND
指定されたクラスタが見つかりませんでした。 クラスタ ID が正しいことを確認します。クラスタが存在することを確認します。 TOPIC_NOT_FOUND
指定された Kafka トピックが見つかりませんでした。 Kafka トピック名が正しいことを確認します。トピックが指定されたクラスタ内に存在することを確認します。
この時点でエラーがない場合は、正常なパブリッシャーの維持のベスト プラクティスを確認してください。
インポート トピックのプラットフォーム ログを有効にすることもできます。これらのログは、Pub/Sub インポート トピックにオブジェクトを取り込む際に問題が発生した場合のトラブルシューティングに役立ちます。