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