Colab Enterprise のトラブルシューティング

このページでは、Colab Enterprise の問題を解決する方法について説明します。

Colab Enterprise にアクセスできない

Google Cloud コンソールで Colab Enterprise にアクセスしようとすると、次のエラーが発生します。

Authentication error: 7; Error Details: User not allowed to access service.

Google Workspace の [追加サービス（個別のコントロールなし）] 設定が無効になっている。

この問題を解決するには、[追加サービスへのアクセス（個別のコントロールなし）] を [オン] に設定します。

ランタイムに接続できない

この問題は、いくつかの原因で発生します。デフォルトのランタイムに接続できないもご覧ください。最も一般的な原因は次のとおりです。

ブラウザがサードパーティ Cookie をブロックする

使用しているブラウザが、Colab Enterprise がランタイムとの HTTPS 接続を確立するために使用するサードパーティ Cookie をブロックしています。

この問題を解決するには、ドメイン *.aiplatform-notebook.googleusercontent.com の DATALAB_TUNNEL_TOKEN サードパーティの Cookie を許可するようにブラウザを構成します。

ネットワークがノートブック ドメインへのアウトバウンド トラフィックをブロックする

ネットワークのファイアウォール ルールによって、*.aiplatform-notebook.cloud.google.com または *aiplatform.googleapis.com へのアウトバウンド トラフィックがブロックされています。

この問題を解決するには、*.aiplatform-notebook.cloud.google.com と *aiplatform.googleapis.com へのアウトバウンド トラフィックを許可するようにネットワークのファイアウォール ルールを構成します。

デフォルトのランタイムに接続できない

既存のデフォルトのランタイム テンプレートがない場合に、デフォルトのランタイムに接続しようとすると、次のエラーが発生します。

Failed to connect to runtime

まだ作成されていないデフォルトのランタイムに接続すると、Colab Enterprise はまずデフォルトのランタイム テンプレートを作成し、そのデフォルトのランタイム テンプレートを使用してデフォルトのランタイムを生成します。ただし、ランタイム テンプレートの作成に必要な権限がない場合、Colab Enterprise はデフォルトのランタイム テンプレートもデフォルトのランタイムも作成できません。

この問題を解決するには、aiplatform.notebookRuntimeTemplates.create 権限を含むロールを付与するよう管理者に依頼してください。

ノートブックがランタイムに接続するのに時間がかかる

ランタイムへの接続を開始してから数分経っても、ノートブックの右上隅に Connecting メッセージが表示され、Colab Enterprise がランタイムにまだ接続されていません。

この問題を解決するには、数分待ってからもう一度お試しください。Colab Enterprise がランタイムに接続中です。Vertex AI が新しい仮想マシン（VM）インスタンスを割り当てるため、実行されていないランタイムへの接続には数分かかることがあります。

ランタイムを作成できない

この問題は、ランタイムを作成できない場合に発生します。デフォルトのランタイムを作成できないもご覧ください。最も一般的な原因は次のとおりです。

割り当て不足

ランタイムを作成できない場合、Compute Engine ランタイムの割り当てを超過している可能性があります。

Colab Enterprise では、ランタイムに Compute Engine の割り当てを使用します。詳細については、Compute Engine の割り当てと上限の概要をご覧ください。

この問題を解決するには、割り当ての調整をリクエストします。

リソースを利用できない

ランタイムを作成しようとすると、次のエラーが発生します。

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

このエラーは、ノートブックのリージョン内にマシンタイプ構成で使用できるリソースがない場合に発生します。

この問題を解決するには、次のいずれかを試してください。

  • 別のリージョンにランタイムを作成します。
  • 別のマシンタイプ構成でランタイム テンプレートを作成し、新しいランタイム テンプレートに基づいてランタイムを作成します。

ランタイム テンプレートと予約の構成が一致しない

ランタイムを作成しようとすると、次のようなエラーが発生します。

Failed to create notebook runtime with error: Invalid value for field
'resource.reservationAffinity': '{"consumeReservationType":
"SPECIFIC_ALLOCATION", "key": "compute.googleapis.com/reservation-name...'.
No available resources in specified reservations.

このエラーは、予約の VM プロパティが Colab Enterprise ランタイムと一致しない場合に発生します。たとえば、予約で e2-standard-8 マシンタイプを指定した場合、Colab Enterprise ランタイムは e2-standard-8 マシンタイプも使用している場合にのみ、予約を消費できます。詳細については、要件をご覧ください。

この問題を解決するには、予約の VM プロパティと一致する構成でランタイム テンプレートを作成します。

Colab Enterprise でランタイム テンプレートを作成できない

このセクションでは、ランタイム テンプレートの作成に関する問題を解決する方法について説明します。

十分な数の GPU を選択できない

ランタイム テンプレートの作成時に、必要な GPU の数を選択できません。これは、割り当てが不足していることが原因である可能性があります。

Colab Enterprise では、GPU に Compute Engine の割り当てを使用します。詳細については、Compute Engine の割り当てと上限の概要をご覧ください。

この問題を解決するには、割り当ての調整をリクエストします。

デフォルトのランタイムがすでに存在する

デフォルトのランタイムがすでに存在する場合に、デフォルトのランタイム テンプレートからランタイムを作成しようとすると、次のエラーが発生します。

Failed to create runtime

One click runtime already exists.

デフォルトのランタイム テンプレートからランタイムを作成しようとすると、Colab Enterprise はデフォルトのランタイムの作成を試みます。デフォルトのランタイムは、ユーザー、プロジェクト、リージョンごとに 1 つだけ作成できます。デフォルトのランタイムがすでに存在するときに、Colab Enterprise が別のデフォルトのランタイムを作成することはできません。

この問題を解決するには、既存のデフォルトのランタイムに接続するか、デフォルト以外のランタイム テンプレートからランタイムを作成します。

デフォルトのランタイムを作成できない

Colab Enterprise がデフォルトのランタイムを作成するときは、まずデフォルトのランタイム テンプレートを作成し、デフォルトのランタイムの生成に使用します。ランタイム テンプレートの作成に必要な権限がない状態でデフォルトのランタイムを作成しようとすると、Colab Enterprise はデフォルトのランタイムを作成できません。

この問題を解決するには、aiplatform.notebookRuntimeTemplates.create 権限を含むロールを付与するよう管理者に依頼してください。

コードの実行時にユーザー認証情報が見つからない

この問題は、 Google Cloud サービスと API を操作するノートブックでコードを実行しようとしたときに、Colab Enterprise にユーザー認証情報へのアクセス権が付与されていない場合に発生します。

次のようなエラー メッセージが表示されることがあります。

Request had invalid authentication credentials.
Expected OAuth 2 access token, login cookie or other valid authentication credential

DefaultCredentialsError: Your default credentials were not found.

この問題の一般的な原因とその解決策は次のとおりです。

  • エンドユーザー認証情報が有効になっているランタイムに初めて接続したときに表示される [ログイン] ダイアログを完了していません。このダイアログを完了すると、Colab Enterprise にユーザー認証情報へのアクセス権が付与されます。

    この問題を解決するには、ランタイムに再度接続してアクセス権を付与してみてください。

    アクセス権が付与されていることを確認するには:

    1. [アカウント> 管理対象の Google アカウント > データとプライバシー > サードパーティ製のアプリとサービス] をクリックします。

    2. Colab Enterprise が表示されていることを確認します。

  • エンドユーザー認証情報が有効になっているランタイムに初めて接続したときに表示される [ログイン] ダイアログ（同意画面）で、ユーザー アカウントを選択して Colab Enterprise にユーザー認証情報へのアクセスを許可していない。

    この問題を解決するには:

    1. Google Cloud コンソールで、アカウントのプロフィール画像をクリックし、[Google アカウント] をクリックします。

    2. [データとプライバシー] をクリックします。

    3. [ご利用のアプリ、サービスのデータ] で、[サードパーティ製のアプリとサービス] をクリックします。

    4. [Colab Enterprise] をクリックします。

    5. [Colab Enterprise に Google アカウントへの下記のアクセス権が付与されています] で、[詳細を表示] をクリックします。

    6. [アクセス権を削除] をクリックします。

    7. [確認] をクリックします。

      現在のアクセス設定が削除されます。

    8. 次回、エンドユーザー認証情報が有効になっているランタイムに接続する際は、[ログイン] ダイアログで正しいユーザー アカウントを選択してください。

  • ポップアップ ブロッカーが、Colab Enterprise の [ログイン] ダイアログ（同意画面）の表示を妨げている可能性があります。

    この問題を解決するには、ブラウザでポップアップを一時的に有効にして、ランタイムへの接続をもう一度試してください。

  • Google Workspace のその他のサービスで Colab が無効になっています。

    この問題を解決するには、Google Workspace で Colab サービスを有効にします。

    これは Colab を指していますが、Colab Enterprise にも影響します。

    Colab は [オン（すべてのユーザー）] に設定されている必要があります。

  • Enterprise サービスの制限により、Colab Enterprise へのアクセスがブロックされている可能性があります。

    この問題を特定するには、 組織のサービス制限によって Google サービスへのアクセスがブロックされていないことを確認します。

    [サービスのステータス] が [オン（すべてのユーザー）] になっている必要があります。

  • エンドユーザー認証情報が有効になっているランタイムを使用しておらず、Google Cloud CLI を使用してユーザー認証情報をアプリケーションのデフォルト認証情報（ADC）に提供していない。

    この問題を解決するには、ノートブックでコードを実行して ADC にユーザー認証情報を提供するをご覧ください。

Gemini の機能が動作しない

Colab Enterprise ノートブックに入力しても、コード補完の候補が表示されない。または、コードセルの上に pen_spark [コーディング サポート] ボタンが表示されない。

Colab Enterprise の設定で、[コンテキストに基づくコード補完を表示] 設定をオフにしている可能性があります。

この問題を解決するには、次の操作を行います。

  1. （ヘッダーの表示 / 非表示を切り替え）をクリックします。
  2. [ツール] メニューで、[設定] をクリックします。
  3. [編集者] をクリックします。
  4. [コンテキストに基づくコード補完を表示] を選択します。
  5. [保存] をクリックします。