データポータルのエラーのトラブルシューティング

データポータルでは、レポート作成中にエラーが表示されることがあります。これらのエラーは、データソースの破損、グラフの設定の誤り、プラットフォームの割り当て超過など、さまざまな理由で発生する可能性があります。一般的なエラーを理解することで、レポートのトラブルシューティングに役立ちます。

このガイドの手順に沿って、グラフ、レポート、データソース全体の問題を調査して解決してください。

健全性維持の基本手順

一時的なネットワークの問題やサーバーの誤動作が原因で、データポータルで予期しない問題が発生することがあります。複雑な設定のトラブルシューティングを行う前に、次の簡単なチェックをお試しください。各手順を試したら、問題が解決したかどうかを確認します。

考えられる症状とエラー メッセージ

エラー メッセージはコードフォントで表示されます。

  • ページが応答しない
  • System error
  • Data Studio is not available

解決手順

  • ブラウザ ウィンドウを更新します。
  • ブラウザのキャッシュと Cookie をクリアします。
  • ウェブブラウザを再起動します。
  • 別のウェブブラウザを使用してみます。
  • パソコンを再起動します。
  • 別のデバイスがある場合は、そちらを使用してみます。

上記の手順で問題が解決しない場合は、数分待ってからもう一度お試しください。問題が解決しない場合は、データポータル コミュニティ フォーラムで、他のユーザーが同様の問題に遭遇していないかどうかを確認してください。

アクセスに関する問題

Google Workspace または Cloud Identity を使用している場合、データポータルにアクセスするには、組織の管理者がデータポータルを有効にする必要があります。同様に、別の組織のユーザーとレポートを共有する場合は、そのユーザーの管理者がアカウントのデータポータルを有効にする必要があります。

アカウントでサービスが無効になっている

We are sorry, but you do not have access to this service. Please contact your Organization Administrator for access.

解決手順

組織の管理者に、組織のデータポータルを有効にするよう依頼します（詳しくは、エンタープライズ向け機能をご覧ください）。

データポータルに初めてログインするときや、データポータルの機能を初めて使用するときに、Google アカウントへのアクセスをリクエストする OAuth の同意ダイアログが表示されることがあります。この同意を付与すると、データポータルは基盤となるデータ API と安全に通信できるようになります。

解決手順

ダイアログで [続行]（または [許可]）をクリックして、必要な権限を付与します。アクセス権を明示的に取り消さない限り、同意は 1 回付与するだけで済みます。

レポートの受信者でサービスが無効になっている

データポータル レポートを別のユーザーと共有しようとすると、次のエラー メッセージが表示されることがあります。

You do not have access to Data Studio. To enable this service, please log in to the Admin console.

原因: このエラー メッセージは、受信者の Google Workspace または Cloud Identity アカウントでデータポータル サービスが有効になっていないことを示しています。組織の管理者が、そのグループのデータポータルを無効にするか、制限しています。

解決手順

受信者は、組織の管理者に連絡してアクセス権をリクエストする必要があります。アクセス権は受信者のドメイン ポリシーによって異なるため、送信者側でこの問題を解決することはできません。

データソースと接続に関する問題

データ接続エラーは、データの認証情報の欠落、設定の破損、データソースの削除、アクセス権の取り消しなど、さまざまな理由で発生します。データへの接続に関する問題を解決するには、次の手順をお試しください。

コネクタ固有のトラブルシューティングとエラー

特定のデータコネクタでエラー（クエリのタイムアウト、結合フィールドの曖昧さ、データセットの上限など）が発生した場合は、そのコネクタのトラブルシューティング ガイドをご覧ください。

表示される可能性のあるエラー メッセージ

エラー メッセージはコードフォントで表示されます。

  • Missing data source
  • Data set configuration error
  • No data set access
  • Data source not attached
  • Data source needs to be added
  • The underlying data has changed
  • Database connection error

解決手順

VPC Service Controls の背後で送信日時を設定したメールまたはアラートが失敗する

IP ベースのアクセスレベルを使用してデータソースが VPC Service Controls（VPC-SC）境界で保護されている場合、自動化されたバックグラウンド機能が失敗することがあります。

考えられる症状とエラー メッセージは次のとおりです。

  • 送信日時を設定したメール配信にレポートのリンクのみが含まれ、レポートの内容や PDF ファイルが添付されていない。
  • グラフのアラートがトリガーされない、または通知の送信が停止する。
  • Organization VPC Service Controls prohibit access to data set used by this component
  • Service Control Failure

解決手順

自動化されたバックグラウンド タスクはエンドユーザーの IP アドレスから実行されないため、VPC Service Controls はリクエストをブロックします。これらのエラーを解決するには、データソースを構成してサービス アカウントの認証情報を使用するか、バックグラウンド リクエストを許可するアクセスレベルを作成します（詳細）。

構成とグラフレベルの問題

設定が不完全なグラフや、互換性のないフィールドを含むグラフにはエラーが表示されます。また、かっこがない、関数名が正しくない、演算子が不適切などの数式構文エラーが発生することもあります。データポータルでは、数式の破損した部分がハイライト表示されます。

表示される可能性のあるエラー メッセージ

エラー メッセージはコードフォントで表示されます。

  • System error
  • Chart configuration incomplete
  • Invalid combination of metrics and dimensions
  • Get report failed

解決手順

Invalid combination of metrics and dimensions エラーについて

原因: このエラーは、グラフでフィールドを組み合わせる方法が、基盤となるデータソースでサポートされていない場合に発生します。Google アナリティクスや Google 広告などのバックエンド システムでは、特定のディメンションと指標のみを同時にクエリできる固定スキーマにデータが保存されます。

ヒント: Google アナリティクスでは、ディメンション と指標のリファレンスを使用して、互換性のある組み合わせを確認してからグラフにフィールド を追加してください。

ユーザー インターフェースと機能に関する問題

データポータルが適切に動作しなくなった場合や、応答しなくなった場合は、ブラウザの拡張機能やアドオンが原因で競合が発生している可能性があります。

考えられる症状とエラー メッセージ

エラー メッセージはコードフォントで表示されます。

  • 機能が動作しない
  • UI 要素が表示されない
  • サービスが応答しなくなった
  • Sorry! We can't save this report right now.

解決手順

  • このページの冒頭で説明した健全性維持の基本手順をお試しください。
  • 別のウェブブラウザを使用してみます。
  • サードパーティのブラウザ拡張機能とアドオンを無効にします。

拡張機能を無効にすると問題が解決する場合は、拡張機能を 1 つずつ有効にして、競合している拡張機能を特定します。特定した拡張機能について、Looker フォーラムで共有することをご検討ください。

統合に関する問題

統合エラーのほとんどは、結合の設定の誤り、データソースの欠落、予期しない統合結果の 3 つのカテゴリに分類されます。

結合の設定の誤りによるエラー

エラー メッセージはコードフォントで表示されます。

  • One or more join configurations is incomplete.
  • One or more join configurations is missing a join condition.
  • Join key incomplete. Each selected data source must specify a join key field for every join key.
  • 結合条件の中にピンク色の Missing フィールドが表示される。

解決手順

  • 結合の設定を編集します。
  • 統合のすべての結合に有効な条件と演算子が含まれていることを確認します。クロス結合（`CROSS JOIN`）では結合条件は使用されません。
  • フィールドが欠落している場合は、破損したフィールドを削除するか、結合された両方のテーブルで対応するキー列が共有されていることを確認します。

データソースの接続がない、または正しくない

One or more tables is missing its data source.

Google アナリティクス 4 の割り当ての上限に達した場合

Google アナリティクス 4（GA4）のデータに接続するレポートには、GA4 Data API の割り当てが適用されます。レポートのトークン割り当ての使用状況は、[Google アナリティクス トークンの使用状況] ダイアログを開いて確認できます。

トークンの使用状況を表示する

  1. データポータル レポートを編集します。
  2. レポートの全体的なトークン使用量を確認するには、レポート キャンバスを右クリックして [Google アナリティクス トークンの使用状況] を選択します。
  3. 特定のグラフのトークンの使用状況を確認するには、グラフを右クリックして [Google アナリティクス トークンの使用状況] を選択します。

全体的な使用状況の概要には、次の情報が表示されます。

レポート全体で使用されたトークン割り当て数を表示する [Google Analytics Token Usage]（Google アナリティクス トークンの使用状況）ダイアログ

  • セッション中にレポート全体または現在のページで使用されたトークン割り当て量。
  • API の上限に達するまでに残っているトークン割り当て量。
  • グラフごとに使用されたトークン割り当て量（多い順）。

グラフレベルの使用状況の概要には、次の情報が表示されます。

[Google アナリティクス トークンの使用状況の詳細] ダイアログ。各グラフで使用されたトークン割り当ての数が表示されます

  • 各クエリ リクエストで使用されたトークン割り当て量。
  • クエリの完了タイムスタンプ。
  • グラフが GA4 から直接読み込まれたか、メモリキャッシュから読み込まれたか。緑色のチェックマークは、トークンを消費せずにメモリからグラフが読み込まれたことを示します。赤い X は、グラフが GA4 に直接クエリを実行したことを示します（詳しくは、データの更新速度をご覧ください）。

割り当て超過エラー メッセージ

GA4 の割り当てを超えたレポートには、次のいずれかのエラーが表示されます。

  • Exhausted concurrent requests quota. Please send fewer requests concurrently.
  • This property has issued too many requests in the last day.
  • Too many requests using this Google Analytics property have encountered errors in the last hour.
  • This property has issued too many requests in the last hour.
  • This property is denied access to Google Analytics.
  • This property has issued too many potentially thresholded requests in the last hour.
  • This project/property has issued too many requests in the last hour.

解決手順

GA4 の割り当て上限を超えた場合は、次の方法で GA4 からクエリするデータを減らし、データポータルのキャッシュをより多く使用します。

  • データソースをオーナーの認証情報に切り替えます。オーナーの認証情報を使用すると、複数のレポート閲覧者が同じキャッシュ データを共有できるため、新しいトークン割り当てを消費せずに済みます。
  • 重複する GA4 データソースを 1 つの 再利用可能なデータソース に統合します。1 つのデータソースを共有すると、グラフ全体のメモリキャッシュが増加します。
  • レポートを共有するユーザーの数を減らすか、トラフィックの多いウェブページから埋め込みレポートを削除して、訪問者のトラフィックを減らします。
  • レポート ページのグラフの数を減らします。
  • GA4 データを静的なレポート スナップショットに抽出します。抽出を実行する前に、割り当て超過がリセットされるまで最大 24 時間待つ必要があります。
  • GA4 データを BigQuery にエクスポートし、BigQuery コネクタを使用してエクスポートしたデータセットに接続します。
  • アナリティクス 360 にアップグレードして、API の上限を引き上げます。
  • パートナー コネクタの使用を検討します。

複雑な問題のトラブルシューティング戦略

データポータルの複雑な問題を診断するには、まず問題が発生している場所を特定 します。ポイント:

  • すべてのレポートで問題が発生しているか、1 つのレポートのみで発生しているか。
  • すべてのグラフタイプに影響するか、特定のコンポーネントのみに影響するか。
  • すべてのウェブブラウザで発生するか、特定のバージョンのみで発生するか。

関連情報: データポータルの使用要件

次に、変数を減らします 。レポートまたはデータを簡素化して、問題の要因をできるだけ絞り込みます。

  • データに関する問題を特定する: データに問題があると思われる場合は、フィルタを適用して行の半分を非表示にします。エラーが消えた場合は、非表示の半分に破損したデータがあります。エラーが残っている場合は、表示されている半分に破損したデータがあります。不正なレコードが見つかるまで、行を分割し続けます。
  • グラフに関する問題を特定する: 1 つのディメンションと指標のみを含む、破損したグラフのバージョンを作成します。エラーが再表示されるまで、フィールドとスタイル設定オプションを 1 つずつ追加します。

Google に問題を報告

上記の手順を試しても問題を解決できない場合は、Google にご報告ください。次の情報をご提供ください。

  • 問題に関する詳細な説明
  • エラーを再現する手順
  • 表示されるエラー メッセージまたはエラー ID
  • 問題を示すテストレポートへのリンク

エラー ID について

8 文字の英数字のエラー ID（Error ID: a1b2c3d4）が表示された場合は、必ずバグレポートに含めてください。エラー ID は、Google のエンジニアがシステムログでエラーの正確なトレースを見つけるのに役立ちます。エラー ID は、エラーが発生するたびに動的に生成されるため、エラーが発生するたびに新しい ID が作成されます。

テストレポートについて

テストレポートを Google サポートと共有する場合は、レポートをできるだけ簡潔にしてください。元のレポートのコピーを作成し、バグの再現に不要な関連性のないページ、グラフ、フィルタをすべて削除します。