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 使用默认凭据或 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)。默认值为 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 在环回接口上公开 Core API(默认值:false)。
--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 显示此启动选项列表。
--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 关闭托管的 Action 中心。
--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> 日志格式为 textjson(默认值: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> 设置非流式查询可返回的最大行数(默认值:100000)。
--min-pdt-regen-threads=<i> PDT Regenerator 的线程数下限。
--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-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> 查询完成后,各行在查询任务表中保留的时长(默认值:360)。
-r, --root 允许以 root 用户身份运行。

Looker 不需要 root 权限即可正常运行。出于安全考虑,我们建议您在非根账号中运行 Looker。仅在需要时(例如,当 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 搜索服务启用 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> 提供外部 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 文件中为 JAVAARGSLOOKERARGS 设置环境变量,因为在安装新版本的 Looker 启动脚本时,系统不会覆盖这些变量。

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

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

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

后续步骤

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