Looker の起動オプション

セルフホスト型インスタンスでオプションで構成可能な Looker の起動設定は複数あります。これらのオプションを変更する必要がない場合は、変更せずに Looker を起動できます。

起動オプションのリスト

次の表に、現在の起動オプションのアルファベット順のリストを示します。オプション --help を指定した Looker の起動スクリプトを実行し、起動オプションのリストを表示することもできます。

オプション 説明
--alerts-scheduler-threads=<i> 同時にスケジュールされるアラートの数(デフォルト: 3)。
--ami 非推奨。--marketplace=aws を代わりに使用してください。
--api-server-max-threads=<i> Puma API サーバーの最大スレッド数。
--api-server-min-threads=<i> Puma API サーバーの最小スレッド数。
--application-server-max-threads=<i> Puma アプリケーション サーバーの最大スレッド数。
--application-server-min-threads=<i> Puma アプリケーション サーバーの最小スレッド数。
--apply-db-migrations 起動時に DB 移行を適用する。移行を個別に適用する場合のみ無効にします(デフォルト: true)。
--async-results-cache-time=<i> 非同期の結果をキャッシュに保存する時間の長さ(デフォルト: 300)。
--byoid-studio-load-url=<s> BYOID Studio を iframe に読み込む URL。
--cdn-hosts=<s> CDN プールのカンマ区切りのホスト名(デフォルト: static-a.lookercdn.com,static-b.lookercdn.com)。
--cipher-key-file=<s> 暗号鍵を含むファイルへのパス(以前の暗号化のみ)。
--cloud-trace-enabled cloud_trace_json_file を介して指定されている場合、デフォルトの認証情報または json の認証情報を使用してトレースを有効にする(デフォルト: false )。
--cloud-trace-json-file=<s> トレースデータを Google Cloud Trace にアップロードするためのサービス アカウント認証情報を含む JSON ファイル。
--cloud-trace-project-id=<s> トレースデータをアップロードする Google プロジェクト ID。
--cloud-trace-sample-rate=<f> トレースをサンプリングするレート(0 ~ 1)。(デフォルト: 0.0)。
--clustered このサーバーがクラスタの一部であるかどうか(デフォルト: false)。
--concurrent-render-caching-jobs=<i> レンダリングキャッシュ処理の同時処理数(デフォルト: 3)。
--concurrent-render-jobs=<i> PhantomJS または Chromium レンダリングの同時処理数(デフォルト: 2)
--core-on-loopback ループバック インターフェースでコア API を公開する(デフォルト: false)。
--core-port=<i> コアを実行するポート(デフォルト: 19999)。
--customer-artifact-maxsize=<i> お客様のアーティファクト ストアの最大サイズ(MB)。
-d, --internal-db-creds=<s> DB 認証情報を含む YAML ファイルへのパス。
--daemonize デーモンとして実行(デフォルト: true)。
--default-mailer-domain=<s> デフォルトのメーラー ドメイン。
--default-mailer-fromemail=<s> デフォルトのメーラーのメール送信元のメールアドレス(デフォルト: Looker <noreply@lookermail.com>)。
--default-mailer-host=<s> デフォルトのメール送信元ホスト名(デフォルト: smtp.sendgrid.net)。
--default-mailer-password=<s> デフォルトのメーラーのパスワード(コマンドラインでのパスワードは推奨されません)。
--default-mailer-port=<i> デフォルトのメーラーのポート(デフォルト: 587)。
--default-mailer-username=<s> デフォルトのメーラー ユーザー名。
--disable-db-log 内部 DB クエリのロギングを無効する(デフォルト: false)。
--dogstatsd-host-ip=<s> Datadog statsd サーバーのホスト IP。
--dogstatsd-host-port=<i> Datadog サーバーのホストポート。
-e, --help 起動オプションのリストが表示される。
--enable-blobstore-recryption 再鍵化操作で Persistent Blobstore の再暗号化を有効にする(デフォルト: false)。
--error-emails-to=<s> <email address> へのエラーメール。
--experimental-features=<s> 許可される試験運用機能のカンマ区切りのリスト。
--experimental-routes=<s> 末尾に -next のサフィックスが付くルートを生成する、許可された実験ルートのカンマ区切りのリスト。
--extension-load-url=<s> 拡張機能を安全な iframe に読み込む URL。
--external-solr-enabled デフォルトの組み込み Solr とは異なり、外部 Solr を有効にする(デフォルト: false)。
--fips FIPS-140 暗号化を有効にする(デフォルト: false)。
--force-cdn CDN を強制的に有効にする(デフォルト: false)。
--force-cipher-key 暗号鍵設定の安全策を無視する(以前の暗号化のみ、デフォルト: false)。
--force-enable-pendo 非公開ラベルのインスタンスまたは埋め込みコンテキストで Pendo ガイドを有効にする(デフォルト: false)。
--force-error-emails Looker がメールでエラーを報告する(デフォルト: false)。
--force-gcm-encryption 非推奨(このオプションは不要になりました)。
--force-mismatched-internal-db 同期されていない Looker 内部 DB の使用を許可する(デフォルト: false)。
--force-no-cdn CDN を強制的に無効にする(デフォルト: false)。
--git-hooks-use-local-path 共有ストレージの代わりに git_hooks ディレクトリにローカルパスを使用する。
--git-performance-logging JGit パフォーマンスのロギングを有効にする(デフォルト: false)。
--google-analytics-tracker-id=<s> 追加の Google アナリティクス トラッカーにページビューを送信するために使用するトラッキング ID。
-h, --hosted Looker がホストする。
-H, --hostname=<s> ノード間通信用のホスト名。
--hosted-action-hub-disabled ホストされているアクションハブをオフにする。
--in-memory-cache-size=<i> メモリ キャッシュのサイズ(MB)(デフォルト: 200)。
--integration-proxy-cert=<s> 統合プロキシ PKI 証明書ファイルへのパス。
--integration-proxy-key=<s> 統合プロキシ PKI 鍵ファイルへのパス。
--internal-analytics-connection-file=<s> system__activity モデルのデータをホストする内部分析接続を記述する YAML ファイル。このオプションは、リードレプリカ バックエンド データベースでのみ使用できます。
--internal-analytics-connection-pool-size=<i> システム アクティビティ モデル クエリを実行する可能性がある DB の同時接続数。このオプションは、リードレプリカ バックエンド データベースでのみ使用できます。
--internal-analytics-retention-days=<i> 内部データベースに履歴データを保持する日数。ETL プロセスには影響しません。デフォルト値は 90。このオプションは、リードレプリカ バックエンド データベースでのみ使用できます。
--k8s-deployment-api-s3bucket-url=<s> この Looker プロセスが Kubernetes Secret として維持される S3 バケット認証情報を書き込むことができる URL。
--log-format=<s> text または json のログ形式(デフォルト: text)。
--log-level=<s> ログレベル(デフォルト: info)。
--log-to-file ログ出力を Looker ログファイル(デフォルト: true)に送信する。
--lookml-runtime-cache-size=<i> LookML ランタイム キャッシュのサイズ(MB)(デフォルト: 200)。
--loose-cipher-key-file 暗号鍵ファイルには 0600 権限は必要はない(以前の暗号化のみ、デフォルト: false)。
--marketplace=<s> Looker Marketplace のインスタンスで実行。
--max-async-threads=<i> 非同期クエリ スレッドの最大数(デフォルト: 200)。
--max-configurable-db-connections=<i> UI でお客様の DB 接続に使用できる最大接続数。
--max-db-connections-records=<i> db_connection テーブルで許可される接続レコードの最大数(デフォルト: 10,000)。
--max-pdt-regen-threads=<i> PDT リジェネレータ スレッドの最大数。
--max-scheduled-plans=<i> アクティブな繰り返しスケジュールされる計画の最大数(デフォルト: unlimited)。
--max-scheduler-jitter-in-seconds=<i> スケジュールを不鮮明にするフラグが指定された秒数にわたりランダムに実行されます。
--max-unstreamed-limit=<i> ストリーミングされないすべてのクエリで返される行の最大数を設定(デフォルト: 100,000)。
--min-pdt-regen-threads=<i> PDT リジェネレータの最小スレッド数。
--monitoring-port=<i> モニタリングをホストするポート(Prometheus等)(デフォルト: 1552)。
-n, --node-to-node-port=<i> ノード間通信用のポート(デフォルト: 1551)。
--new-cipher-key-file=<s> 新しい暗号鍵を含むファイルへのパス(以前の暗号化のみ)。
--on-disk-cache-size=<i> ディスク キャッシュのサイズ(MB)(デフォルト: 2,000。)
-p, --port=<i> 実行するポート(デフォルト: 9999)。
--per-user-query-limit=<i> ユーザーごとの同時実行クエリ数を制限する(デフォルト: 15)。
--per-user-query-timeout=<i> 接続を待機するユーザーごとのタイムアウトの長さ(デフォルト: 600)。
--prefer-ipv4 IPv4 を優先。
--public-embed-auth-param-file=<s> 公開認証用の認証パラメータ ファイル。
--public-host-url=<s> public_host_url ライセンス機能が有効になっている場合、このオプションでは、管理者が public_host_url ホスト名を指定することで、Looker Action API コールバック URI が、Looker のデフォルト ホスト URL ではなく public_host_url で構築されます。起動オプションの入力は、URL の末尾にスラッシュのない https://<my.host.name> にする必要があります。この方法を使用する場合は、アクションハブを介したデータの共有のドキュメント ページに記載されている静的下り(外向き)IP アドレスも許可リストに登録する必要があります。
-q, --queue-broker-port=<i> キュー ブローカー用のポート(デフォルト: 61616)。
--qm-long-poll-max-sleep-interval-in-seconds=<f> ロング ポーリング API が結果が利用可能かどうかを確認する前の最大スリープ間隔(デフォルト: 1)。
--qm-long-poll-sleep-interval-in-seconds=<i> ロング ポーリング API が結果が利用可能かどうかを確認する前の初期スリープ間隔(デフォルト: 0.1)。
--qm-long-poll-timeout-in-seconds=<i> ロング ポーリング API がクライアントに返されるまでのサーバー側の最大タイムアウト(デフォルト: 30)。
--query-manager-max-threads=<i> Query Manager の最大スレッド数。
--query-manager-min-threads=<i> Query Manager の最小スレッド数。
--query-metrics-retention-hours=<i> 内部データベースに query_metrics データを保持する時間(デフォルト: 336)。
--queue-startup-timeout-in-seconds=<i> 起動時にキューへの接続を許可する秒数(デフォルト: 180)。
--query-task-cleanup-interval-seconds=<i> クエリタスク テーブルのクリーンアップ ジョブの間隔(デフォルト: 600)。
--query-task-persistence-duration-minutes=<i> クエリの完了後、クエリタスク テーブルに行を保持する時間(デフォルト: 360)。
-r, --root root としての実行が可能。

Looker では、通常の操作に root 権限は必要ありません。セキュリティ上の理由から、Looker を root 以外のアカウントで実行することをおすすめします。トラブルシューティングの目的で Looker アナリストから要求された場合など、必要な場合にのみ root として実行するオプションを使用します。
--redis-cache-config-file=<s> Redis 構成を含むファイル。
--report-backend-errors, --no-report-backend-errors バックエンドからエラーを報告する(デフォルト: false)。
--report-frontend-errors, --no-report-frontend-errors フロントエンドからエラーを報告する(デフォルト: false)。注: この起動オプションは廃止されています。代わりに client_monitor フィーチャー トグルを使用してください。
-S, --ssh-tunnel-sidecar-url=<s> SSH トンネル サーバーのサイドカーへの接続に使用されるベース URL。
--scheduled-job-attempt-limit=<i> スケジュールされるジョブの試行回数の上限(デフォルト: 10)。
--scheduled-job-max-age-days=<i> スケジュールされるジョブの削除までの最大存続期間(デフォルト: 60)。
--scheduler-query-limit=<i> スケジュールされる同時クエリの数を制限する(デフォルト: 10)。
--scheduler-query-timeout=<i> 接続を待機するスケジューラ タイムアウトの長さ(デフォルト: 1200)。
--scheduler-start-delay=<i> タスクランナーの起動を遅延させる秒数(デフォルト: 60)。
--scheduler-threads=<i> 同時にスケジュールされるタスクの数(デフォルト: 10)。
--search-result-comparison 検索サービスの結果と以前の結果を比較する(デフォルト: false)。
--search-service 検索サービスを有効にする(デフォルト: false)。
--search-service-ab-test 検索サービスの AB テストを有効にします(デフォルト: false)。
--self-signup 誰でも自分用のアカウントを作成できるようにする。
--shared-storage-dir=<s> ネットワーク ファイル システムの共有ストレージへのパス。
--snowplow-host=<s> Extra Snowplow コレクター。
--solr-basic-auth=<s> Solr への呼び出し用の基本認証情報(デフォルト: solr:SolrRocks)。
--ssl SSL を使用する(デフォルト: true)。
--ssl-ca-cert=<s> 非推奨。--ssl-keystore を代わりに使用してください。
--ssl-cert=<s> 非推奨。--ssl-keystore を代わりに使用してください。
--ssl-key=<s> 非推奨。--ssl-keystore を代わりに使用してください。
--ssl-keystore-pass-file=<s> ssl-keystore パスワードを含むファイルへのパス。
--ssl-keystore-pass=<s> ssl-keystore ファイル用のパスワード。
--ssl-keystore=<s> SSL のキーストア ファイルへのパス。
--ssl-provided-externally-by=<s> Looker を実行しているサーバーから外部 SSL プロバイダの host:port にアクセスできるようにする。指定しない場合、Looker アプリサーバーは SSL を提供します。

Looker クラスタの前面にある SSL プロキシの例を次に示します。

--ssl-provided-externally-by=192.168.123.13:443

Looker インスタンスと同じホスト上の SSL プロバイダの例を次に示します。

--ssl-provided-externally-by=localhost:443

null 値は、Looker アプリサーバーが SSL を提供することを示します。Looker インスタンスが公共のインターネットへのアクセスが制限されたサーバーで実行されている場合、Looker インスタンスのサーバーから到達可能な内部ネットワーク上の IP アドレスを指定する必要があります。
--ssl-provided-externally 非推奨。--ssl-provided-externally-by を代わりに使用してください。
--staging サーバーをステージングとして実行する。このオプションを選択すると、ステージング インスタンスからスケジュール設定レポートが送信されなくなります。ただし、ステージングされたインスタンスは引き続きスケジュールされたタスクを実行し、スケジュールされたタスクに問題がある場合はスケジュールされた計画のオーナーにエラーメールを送信します。
--staging-override-email=<s> ステージング インスタンスのメールを、通常の宛先ではなく、このアドレスに送信する。
--stereo-data-search-enabled ステレオデータ検索機能を有効にする(デフォルト: false)。
--studio-load-url=<s> Studio を iframe に読み込む URL。
--studio-one-platform-endpoint=<s> Studio One Platform API のエンドポイント。
--task-monitor-abandoned-query-in-seconds=<i> クエリタスクが放棄済みと見なされる、タスクが最後にアクセスされてから経過した時間。
--task-monitor-query-startup-interval-in-seconds=<i> クエリの実行を開始し、最初の長いポーリングが発生するまでの猶予期間。これによって、呼び出し元がポーリングを開始する前に余裕ができます。
--task-monitor-sleep-interval-in-seconds=<i> タスク追跡スレッドでタスクが放棄されたかどうかを確認できるようになるまでのスリープ間隔。
--unlimited-scheduler-threads=<i> スケジュールされるタスクの無制限数(デフォルト: 3)。
--use-custom-jdbc-config カスタム JDBC ドライバ構成を使用するかどうか(デフォルト: false)。
--user-db-credentials 制限付きの使用。接続でユーザーごとの認証情報を使用できます(デフォルト: false)。
-v, --version バージョンを出力し、終了する。

認証情報のファイル形式

アプリケーション データベースを MySQL に変更した場合は、次の設定を含む looker-db.yml という名前の認証情報ファイルが必要になります。

dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT

MySQL データベースに SSL 接続が必要な場合は、looker-db.yml ファイルにも次の記述が必要です。

ssl: true

起動オプションを永続化する

起動時の構成を永続化するには、Looker アプリケーション ディレクトリに lookerstart.cfg という名前のファイルを作成することをおすすめします。このファイルは、looker.jar に付属する Looker 起動スクリプトによって実行されます。lookerstart.cfg ファイルは、JAVAARGSLOOKERARGS の環境変数を設定するために推奨される場所です。Looker 起動スクリプトの新しいバージョンがインストールされても、上書きされません。

Looker の SSL を無効にしてポート 8080 で実行するように設定する lookerstart.cfg の例を次に示します。

LOOKERARGS="--no-ssl --port 8080"

lookerstart.cfg に変更を加えた場合は、Looker を再起動する必要があります。

次のステップ

Looker の起動オプションを構成したら、適切な HTTPS 用の SSL 証明書を構成します。