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 在启动时应用数据库迁移。仅在您要单独应用迁移时才停用此设置(默认值: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(默认:false)提供,请使用默认凭据或 json 凭据进行跟踪。
--cloud-trace-json-file=<s> 包含服务帐号凭据的 JSON 文件,用于将跟踪记录数据上传到 Google Cloud Trace。
--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 在环回接口(默认:false)上公开 Core API。
--core-port=<i> 运行核心的端口(默认值:19999)。
--customer-artifact-maxsize=<i> 客户工件存储区的大小上限 (MB)。
-d, --internal-db-creds=<s> 包含数据库凭据的 YAML 文件的路径。
--daemonize 作为守护进程运行(默认值:true)。
--debug-node-modules 不要在 webpack 中主动缓存 node_modules(默认值:false)。
--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 显示启动选项列表。
--error-emails-to=<s> <email address> 发送错误电子邮件。
--experimental-features=<s> 允许使用的实验性功能的列表(以英文逗号分隔)。
--experimental-routes=<s> 允许生成的实验性路由列表(以英文逗号分隔,可生成后缀为 -next 的路由)。
--extension-load-url=<s> 用于在安全 IFRAME 中加载扩展程序的网址。
--external-solr-enabled 启用外部 Solr(而不是默认的 Solr - 嵌入式 Solr)(默认:false)。
--force-cdn 强制启用 CDN(默认值:false)。
--force-cipher-key 忽略加密密钥设置的保护措施(仅限旧版加密,默认:false)。
--force-enable-pendo 在私有标签实例或嵌入上下文(默认:false)中启用 Pendo 指南。
--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> 节点到节点通信的主机名。
--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> 可以运行系统活动模型查询的并发数据库连接数。此选项仅适用于读取副本后端数据库。
--internal-analytics-retention-days=<i> 内部数据库中历史数据的保留天数。这不会影响任何 ETL 进程。默认值为 90。此选项仅适用于读取副本后端数据库。
--k8s-deployment-api-s3bucket-url=<s> 此 Looker 进程可以写入 S3 存储桶凭据以保留为 Kubernetes Secret 的网址。
--log-format=<s> 日志格式为 text, json 之一。
--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-pdt-regen-threads=<i> PDT 再生器线程数上限。
--max-scheduled-plans=<i> 有效周期性周期性方案的数量上限(默认值:unlimited)。
--max-unstreamed-limit=<i> 设置所有未进行流式传输的查询可返回的行数上限(默认值:100000)。
--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 主机名,以使用 Looker 构建 Looker Action API 回调 URI,而不是使用 Looker 中的默认主机网址。启动选项的输入应为 https://<my.host.name>,网址中不含尾部斜杠。如果使用此方法,Looker 管理员还必须将通过操作中心共享数据文档页面列出的静态出站流量 IP 地址列入许可名单。
-q, --queue-broker-port=<i> 队列代理的端口(默认值:61616)。
--qm-long-poll-max-sleep-interval-in-seconds=<f> 长轮询 API 检查结果可用之前的最大睡眠间隔。
--qm-long-poll-sleep-interval-in-seconds=<i> 长轮询 API 检查结果可用之前的初始休眠时间间隔(默认值:30)。
--qm-long-poll-timeout-in-seconds=<i> 长轮询 API 在返回客户端之前的最大服务器端超时时间。
--query-manager-max-threads=<i> 查询管理器的线程数上限。
--query-manager-min-threads=<i> 查询管理器的最小线程数。
--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> 查询完成后,查询行表中保留行的时间量(默认值为 90)。
-r, --root 允许以根用户身份运行。

Looker 不需要 root 权限即可正常运行。出于安全考虑,我们建议您在非根帐号中运行 Looker。仅当需要时(例如,如果 Looker 分析师请求用于问题排查目的),才需要以根用户身份运行此选项。
--redis-cache-config-file=<s> 包含 redis 配置的文件。
--report-backend-errors, --no-report-backend-errors 从后端报告错误(默认值:true)。
--report-frontend-errors, --no-report-frontend-errors 从前端报告错误(默认值:true)。
-S, --ssh-tunnel-sidecar-url=<s> 用于连接到 SSH Tunnel Server Sidecar 的基准网址。
--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 启用 Search Service(默认值:false)。
--search-service-ab-test Search Service 启用 AB 测试(默认: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> 为可从运行 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

如果值为空,则表示 Looker 应用服务器提供 SSL。如果您的 Looker 实例在对公共互联网具有受限访问权限的服务器上运行,您将需要在内部网络上指定一个 IP 地址,以便 Looker 实例的服务器可以访问该 IP 地址。
--ssl-provided-externally 已弃用。请改用 --ssl-provided-externally-by
--staging 将服务器作为临时运行。此选项将阻止预演实例发送定期报告。不过,预演实例将继续运行计划任务;如果计划任务存在任何问题,系统会向计划计划所有者发送错误电子邮件。
--staging-override-email=<s> 将临时实例中的电子邮件发送到此地址,而不是其常规目的地。
--stereo-data-search-enabled 启用立体声数据搜索功能(默认值:false)。
--super-max-query-limit 使用受限。设置“探索”或“查询结果”中可以返回的最大行数,取代默认的 5000 行限制
--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 启动脚本时不会被覆盖。

以下是 lookerstart.cfg 的示例,它停用了 Looker 的 SSL,并将其设置为在端口 8080 上运行:

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

在更改 lookerstart.cfg 后,需要重新启动 Looker。

后续步骤

配置 Looker 启动选项后,您就可以为正确的 HTTPS 配置 SSL 证书了。