バッチとセッションの接続のトラブルシューティング

このページでは、Managed Service for Apache Spark のバッチ ワークロードとインタラクティブ セッションで発生する一般的なネットワーク接続の問題を診断して解決するためのガイダンスについて説明します。これらの問題により、ワークロードが必要なデータソース、外部サービス、 Google Cloud API にアクセスできなくなる可能性があります。

一般的な症状とエラー メッセージ

Managed Service for Apache Spark で接続の問題が発生すると、次のようなエラーが発生することがあります。

  • Unable to connect to service_name.googleapis.com
  • Could not reach required Google APIs
  • Connection refused
  • Host unreachable
  • Operation timed out
  • Permission denied(API 呼び出しをブロックしている場合は、ネットワーク関連であることが多い)

Cloud Storage、BigQuery、またはその他のデータベースのデータへのアクセスに関連するエラーが発生することもあります。

一般的な原因とトラブルシューティングのヒント

このセクションでは、Managed Service for Apache Spark の接続に関する問題の一般的な原因と、その解決に役立つトラブルシューティングのヒントについて説明します。

ネットワークの構成

ネットワークの構成ミスは、接続障害の一般的な原因です。Managed Service for Apache Spark 用のワークロードとセッションは、内部 IP アドレスを持つ VM で実行されます。ワークロードまたはセッションのサブネットで プライベート Google アクセス(PGA)が自動的に有効になり、Google API とサービスにアクセスします。詳細については、Managed Service for Apache Spark のネットワーク構成をご覧ください。

  • アクセス オプション:

    • Private Service Connect(PSC): VPC ネットワーク内にプライベート エンドポイントを作成して、特定の Google API にアクセスできます。

      • Google Cloud コンソールで、[Private Service Connect] > [エンドポイント] に移動します。storage.googleapis.com や dataproc.googleapis.com など、必要なすべての API のエンドポイントを接続するか、エンドポイントが接続されていること、およびバッチ ワークロードまたはセッションの Virtual Private Cloud ネットワークに接続されていることを確認します。
    • Cloud NAT: ワークロードが公共のインターネットにアクセスする必要がある場合は、バッチ ワークロードまたはセッション サブネットに Cloud NAT を構成できます。

      • Google Cloud コンソールで、[Cloud NAT] ページに移動します。ゲートウェイを構成するか、バッチ ワークロードまたはセッションの VPC ネットワーク、リージョン、サブネットにゲートウェイが構成されていることを確認します。また、ファイアウォール ルールで 0.0.0.0/0 への下り(外向き)が許可されていることを確認します。詳細については、Cloud NAT を設定するをご覧ください。
  • ファイアウォール ルール:

    • VPC ネットワーク(または共有 VPC ネットワーク ホスト プロジェクト(該当する場合))の下り(外向き)ファイアウォール ルールで、必要な宛先への送信トラフィックをブロックしないでください。
      • 該当する場合、下り(外向き)ルールでは、 Google Cloudの外部のパブリック API やデータベースなどの外部サービスへのトラフィックを許可する必要があります。バッチ ワークロードまたはセッションでインターネット アクセスが必要な場合は、Cloud NAT を使用してサブネットの下り(外向き)を提供できます。
    • 接続性の問題の一般的な原因ではありませんが、過度に制限された内向きルールにより、必要な戻りトラフィックや内部通信が誤ってブロックされる可能性があります。
  • DNS の解決:

    • DNS の解決は VPC ネットワーク内で構成する必要があります。ワークロードとセッションは、storage.googleapis.com や bigquery.googleapis.com などの Google API と外部サービスのホスト名を解決できる必要があります。
    • カスタム DNS サーバーと Cloud DNS のプライベート ゾーンは、Google ドメインのクエリを転送または解決する必要があります。
    • Google API へのプライベート アクセスに Private Service Connect を使用している場合、Google サービスの DNS レコードは、PSC エンドポイントを使用して VPC ネットワーク内のプライベート IP アドレスに解決される必要があります。

トラブルシューティングのヒント:

  • ネットワークとサブネットの構成を特定します。

    • Managed Service for Apache Spark のバッチまたはセッションの詳細から、networkUri と subnetUri を確認します。
    • Google Cloud コンソールで、VPC ネットワークとサブネットの設定を確認します。
  • プロキシ VM からの接続をテストします。

    • バッチまたはセッションのサービス アカウントを使用して、バッチまたはセッションのサブネットでテスト用の Compute Engine VM を起動します。
    • テスト VM から、次の接続テストを実行します。
      • nslookup storage.googleapis.com を使用して DNS 解決を検証します。bigquery.googleapis.com や dataproc.googleapis.com などの他の Google API ドメインをルックアップします。Managed Service for Apache Spark サブネットで自動的に有効になるプライベート Google アクセス、または Private Service Connect を使用する場合、ドメインはプライベート IP アドレスに解決される必要があります。
      • curl -v https://storage.googleapis.com: Google API への HTTPS 接続を確認します。他の Google サービスへの接続も試します。
      • ping 8.8.8.8。バッチまたはセッションで必要な場合は、インターネット接続をテストします。Cloud NAT が想定される場合は、curl -v https://example.com を試してください。
    • Google CloudNetwork Intelligence Center 接続テストを実行して、サブネットから関連するエンドポイント(Google API や外部 IP アドレスなど)へのネットワーク パスを診断します。
  • Cloud Logging でネットワーク エラーを確認します。

    • Managed Service for Apache Spark のワークロードまたはセッションのロギングを確認します。ネットワーク タイムアウト、接続拒否、API 呼び出しの失敗に関連する ERROR または WARNING メッセージを探します。Spark 固有のネットワークの問題については、jsonPayload.component="driver" または jsonPayload.component="executor" でフィルタします。

IAM の権限

IAM 権限が不十分な場合、ワークロードやセッションがリソースにアクセスできなくなり、API 呼び出しが拒否されるとネットワーク障害が発生する可能性があります。

バッチ ワークロードまたはセッションで使用されるサービス アカウントには、必須のロールが必要です。

  • Managed Service for Apache Spark ワーカーロール(roles/dataproc.worker)。
  • データアクセス ロール(roles/storage.objectViewer、roles/bigquery.dataViewer など)。
  • ロギング: (roles/logging.logWriter)。

トラブルシューティングのヒント:

外部サービス構成

ワークロードが Google Cloud外のデータベースまたはサービスに接続する場合は、それらの構成を確認します。

  • 外部サービスのファイアウォールまたはセキュリティ グループが、VPC ネットワークの IP 範囲からのインバウンド接続を許可していることを確認します。該当する場合は、VPC ピアリング、Cloud VPN、Cloud Interconnect、または Cloud NAT の IP アドレスを使用して内部 IP アドレスを確認します。
  • データベースの認証情報または接続文字列を確認します。接続の詳細、ユーザー名、パスワードを確認してください。

次のステップ