您可以选择在客户托管的实例上配置多项 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 |
启动时应用数据库迁移。请仅在单独应用迁移时停用(默认值: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 |
启用使用默认凭据或 JSON 凭据(如果通过 cloud_trace_json_file 提供)进行跟踪(默认值:false )。 |
--cloud-trace-json-file=<s> |
JSON 文件,包含用于将跟踪记录数据上传到 Google Cloud Trace 的服务帐号凭据。 |
--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)。 |
--content-repo-enabled |
内容代码库功能已启用(默认值:false )。 |
--core-on-loopback |
在环回接口(默认值:false )上公开了 Core API。 |
--core-port=<i> |
运行核心的端口(默认值:19999)。 |
--customer-artifact-maxsize=<i> |
客户制品存储区的大小上限(以 MB 为单位)。 |
-d, --internal-db-creds=<s> |
包含数据库凭据的 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 |
停用内部数据库查询的日志记录功能(默认值:false )。 |
--dogstatsd-host-ip=<s> |
Datadog statsd 服务器主机 IP。 |
--dogstatsd-host-port=<i> |
Datadog 服务器主机端口。 |
-e, --help |
显示此启动选项列表。 |
--enable-blobstore-recryption |
在执行密钥更新操作时启用永久性 Blob 存储区重新加密(默认值:false )。 |
--error-emails-to=<s> |
错误电子邮件发送至 <email address> 。 |
--experimental-features=<s> |
允许使用的实验性功能的列表(以英文逗号分隔)。 |
--experimental-routes=<s> |
以逗号分隔的实验路由列表,列出了可生成后缀为 -next 的路由的实验性路由。 |
--extension-load-url=<s> |
用于将扩展程序加载到安全的 iframe 中的网址。 |
--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 内部数据库(默认值:false )。 |
--force-no-cdn |
强制停用 CDN(默认值:false )。 |
--git-hooks-use-local-path |
请为 git_hooks 目录使用本地路径,而不是共享存储空间。 |
--git-performance-logging |
启用 JGit 性能日志记录(默认值:false )。 |
--google-analytics-tracker-id=<s> |
用于向其他 Google Analytics(分析)跟踪器发送网页浏览数据的跟踪 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> |
YAML 文件,用于描述托管 system__activity 模型数据的内部分析连接。此选项仅适用于读取副本后端数据库。 |
--internal-analytics-connection-pool-size=<i> |
可以同时运行系统活动模型查询的数据库连接数。此选项仅适用于读取副本后端数据库。 |
--internal-analytics-retention-days=<i> |
历史数据在内部数据库中保留的天数。这不会影响任何 ETL 流程。默认值为 90。此选项仅适用于读取副本后端数据库。 |
--k8s-deployment-api-s3bucket-url=<s> |
此网址可供此 Looker 进程写入 S3 存储桶凭据以保留为 Kubernetes Secret 的网址。 |
--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> |
界面中允许的客户数据库连接的最大连接数。 |
--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 为单位,默认值:2000)。 |
-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 主机名,以便使用 public_host_url (而不是 Looker 中的默认主机网址)构建 Looker Action API 回调 URI。启动选项的输入应为 https://<my.host.name> ,网址中不含斜杠。如果使用此方法,Looker 管理员还必须将通过操作中心共享数据文档页面中列出的静态出站流量 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 分析师出于问题排查目的而要求时。 |
--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 隧道服务器端服务器的基础网址。 |
--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 |
为搜索服务启用 A/B 测试(默认值:false )。 |
--self-signup |
允许任何人为自己创建账号。 |
--shared-storage-dir=<s> |
网络文件系统共享存储空间的路径。 |
--snowplow-host=<s> |
额外的雪铲收集器。 |
--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> |
为外部 SSL 提供商提供 host:port,可从运行 Looker 的服务器进行访问。如果未指定,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 中的网址。 |
--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 证书了。