コンテンツ ガードレール

このドキュメント ページでは、[管理] パネルの [パフォーマンス センター] セクションにある [コンテンツ ガードレール] ページについて説明します。コンテンツ ガードレールは、Looker 管理者が Looker ユーザーによるダッシュボード設定の構成方法に制限を課すことができる設定です。

ダッシュボードはビジネス インサイトを伝える強力なツールですが、そのパフォーマンスは次のような要因によって影響を受ける可能性があります。

  • ダッシュボード タイル、タブ、ビジュアリゼーションの数が多すぎる
  • クエリの実行頻度が高い
  • 複雑なクエリの実行

管理者は、コンテンツ ガードレールを使用して、ダッシュボードのカスタマイズ性とパフォーマンスのトレードオフを考慮できます。

[コンテンツ ガードレール] ページには次のオプションがあります。

パフォーマンスの高いダッシュボードの構築に関する詳細と推奨事項については、パフォーマンスの高い Looker ダッシュボードを構築する際の考慮事項をご覧ください。

統合された結果のクエリを制限する

インスタンス上のすべてのダッシュボードで、統合された結果のクエリを無効にするか、制限するかを選択できます。統合された結果のクエリは、クエリ後の処理で計算されます。過剰な計算は Looker インスタンスの Java メモリと競合する可能性があるため、Looker インスタンスのレスポンスが遅くなります。

次のオプションのいずれかまたは両方を有効にできます。

  • [統合された結果のすべてのクエリを制限する] オプションを有効にすると、統合されたすべてのクエリの実行が停止します。統合された結果のクエリタイルを含む既存のダッシュボードでは、「No Results」と表示され、対応する要素のエラーが表示されます。Looker でこれらのエラーが発生した場合、統合された結果のクエリタイルを含むダッシュボードのスケジュール設定された配信は実行されません。
  • [ダッシュボードでの統合された結果の新しいクエリを制限する] オプションを有効にすると、ユーザーが統合された結果の新しいクエリをダッシュボードに保存できなくなります。統合された結果のクエリタイルがすでに含まれているダッシュボードには影響しません。

カスタム ビジュアリゼーションの読み込み時間を短縮する

[カスタム ビジュアリゼーション用の（データ読み込み前の）iframe の事前レンダリング] オプションを有効にすると、クエリデータが読み込まれる前でも iframe のレンダリングを開始することで、カスタム ビジュアリゼーションの読み込み時間を短縮できます。

この設定を有効にすると、ダッシュボードの初回読み込み時に一部のカスタム ビジュアリゼーションが正しく表示されないことがあります。

カスタム ビジュアリゼーションの JavaScript コードが、iframe 環境の初期化時にデータがすでに使用可能であることを前提として記述されている場合、データの読み込み前に iframe を事前レンダリングすると、エラーや予期しない動作が発生する可能性があります。ビジュアリゼーションがまだ存在しないデータにアクセスしようとして、失敗したり、正しくレンダリングされなかったりする可能性があります。

ダッシュボードのガードレール

ダッシュボードのガードレールを使用すると、ダッシュボードとダッシュボード タイルの設定をさらに制御できます。このセクションでは、インスタンス上のすべてのダッシュボードの自動更新機能を管理できます。また、ユーザーがインスタンス上の任意のダッシュボードに追加できるタブとタイルの数を管理することもできます。

ダッシュボードの更新を制限する

ダッシュボードの自動更新の速度を制御できます。また、管理者を除くすべてのユーザーに対して、自動更新オプションを無効にすることもできます。

[ダッシュボードの自動更新オプションを制限する] を有効にすると、Looker 管理者のみがダッシュボードを 自動更新 するように構成できます。

[ダッシュボードとタイルの自動更新の最小更新間隔をグローバルで制限します] オプションを使用すると、ダッシュボードの自動更新オプションの最小時間間隔を設定できます。この設定は、Looker インスタンス内のすべてのダッシュボードに適用されます。

このフィールドの時間間隔よりも頻繁に自動更新するように構成されているダッシュボードは、このフィールドで構成されている値よりも頻繁に自動更新されません。

たとえば、データベースの ETL プロセスよりも頻繁に自動更新するように構成されたダッシュボードがある場合、次の ETL が発生する前にダッシュボードが更新されるたびに、ダッシュボードは新しいデータを取得しません。このような不要なクエリを防ぐには、このフィールドを使用して、データベースの ETL プロセス間の時間に合わせてダッシュボードの最小更新時間を設定します。これにより、ダッシュボードが更新されるときに新しいデータが取得されます。

ダッシュボードの自動更新の最小時間を設定するには、時間間隔（秒 、分 、時間 、日 ）を選択します。次に、選択した時間間隔の数を入力します。これが、ダッシュボードの自動更新間の最小時間になります。最小時間間隔を入力したら、[保存] をクリックします。

ダッシュボードの自動更新回数を無制限にするには、このフィールドを 0 に設定するか、空白のままにします。

ダッシュボード タブの最大数

[ダッシュボード タブの最大数] フィールドでは、ユーザーがダッシュボードに追加できるタブの最大数を設定できます。最大 10 個のタブを設定できます。

タブ付きダッシュボードの詳細をご覧ください。

クエリタイルの最大数

[ダッシュボードあたりの最大クエリタイル数] フィールドでは、ユーザーがダッシュボードに追加できるクエリタイルの最大数を設定できます。ダッシュボードあたりのクエリタイル数は 25 個以下にすることをおすすめします。

[タブあたりの最大クエリタイル数] フィールドでは、ユーザーがダッシュボード タブに追加できるクエリタイルの最大数を設定できます。タブあたりのクエリタイル数は 20 個以下にすることをおすすめします。

ユーザーが [タブあたりの最大クエリタイル数] フィールドで指定された最大数を超えるタイルを追加しようとすると、エラー タブにクエリタイルが多すぎます が表示されます。

ユーザーがタブにすでに追加しているタイル数よりも少ない最大数を設定しても、それらのタイルには影響しません。

ビジュアリゼーションの制限

次のフィールドでは、地図グラフ、散布図グラフ、テーブルグラフのユーザー クエリの行制限を設定します。上限は、以前の行制限の上限である 5,000 行を超える 50,000 行まで設定できます。

  • 地図ビジュアリゼーションの行制限: 地図プロットの最大 50,000 個のデータポイントのデータ密度を設定します。
  • 散布図ビジュアリゼーションの行制限: 散布図グラフの最大 50,000 個のデータポイントのデータ密度を設定します。
  • テーブル ビジュアリゼーションの行制限: 結果に返されて表示される行の最大数を設定します。最大 50,000 個のデータポイントです。

ビジュアリゼーションの制限については、次の点に注意してください。

  • 既存のダッシュボード タイルには、行制限の増加が自動的に反映されません。行制限を増やすには、既存のダッシュボード タイルを編集する必要があります。
  • ダッシュボードのクエリタイル、または個々の統合された結果のソースクエリを編集する場合、行制限を増やしても、表示されるデータは 5,000 行のみです。ただし、行制限を 5,000 行を超える値に設定すると、クエリタイルと統合された結果のソースクエリは、設定された制限で保存されます。
  • 行制限を増やしたダッシュボードは、次の注意点に沿って PDF 形式で送信、スケジュール設定、ダウンロードできます。
    • ダッシュボードの各テーブルグラフのクエリ結果には、最大 50,000 行が表示されます。ダッシュボードあたりの合計上限は 200,000 セルです。
    • ダッシュボードのテーブルグラフのセルの合計数が 200,000 セルを超える場合、テーブルグラフの結果が切り捨てられることがあります。上限に達すると、レンダリングされた PDF の下部に警告が表示されます。
    • ダッシュボードの PDF のテーブルグラフに、ダッシュボード タイルのサムネイルに表示される行よりも多くの行が表示されるのは、[テーブルを展開してすべての行を表示] オプションが選択されている場合のみです。
    • 散布図グラフと Google マップグラフでは、PDF ダウンロードで最大 50,000 個のデータポイント（行）がサポートされます。グラフは、タイルのサムネイルに表示されるとおりにレンダリングされるか、標準レンダラの上限に基づいて失敗します。