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）。
--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）。デフォルトは 1%（デフォルト: 0.01）。
--clustered このサーバーがクラスタの一部かどうか（デフォルト: false）。
--concurrent-render-caching-jobs=<i> 同時レンダリング キャッシュ プロセスの数（デフォルト: 3）。
--concurrent-render-jobs=<i> PhantomJS または Chromium レンダリングの同時処理数（デフォルト: 2）
--content-repo-enabled コンテンツ リポジトリ機能が有効になっている（デフォルト: false）。
--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 起動オプションのリストが表示される。
--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 テーブルで使用できる接続レコードの最大数（デフォルト: 10000）。
--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 権限は必要ありません。セキュリティ上の理由から、root 以外のアカウントで Looker を実行することをおすすめします。トラブルシューティングの目的で Looker アナリストから要求された場合など、必要な場合にのみ root として実行するオプションを使用します。
--redis-cache-config-file=<s> Redis 構成を含むファイル。
--report-backend-errors, --no-report-backend-errors バックエンドからエラーを報告する（デフォルト: false）。
--report-frontend-errors, --no-report-frontend-errors フロントエンドからエラーを報告する（デフォルト: false）。
-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> 追加の 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> Looker Studio を iframe に読み込む URL。
--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 ファイルは、JAVAARGS と LOOKERARGS の環境変数を設定するために推奨される場所です。Looker 起動スクリプトの新しいバージョンがインストールされても、上書きされません。

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

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

lookerstart.cfg を変更したら、Looker を再起動する必要があります。

次のステップ

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