Opções de inicialização do Looker

Há várias configurações de inicialização do Looker que podem ser definidas em instâncias hospedadas pelo cliente. Se não for necessário mudar essas opções, inicie o Looker sem elas.

Lista de opções de inicialização

Abaixo está a lista das opções de inicialização atuais em ordem alfabética. Também é possível mostrar uma lista de opções de inicialização executando o script de inicialização do Looker com a opção --help.

Opção	Descrição
--alerts-scheduler-threads=<i>	Número de alertas programados simultâneos (padrão: 3).
--ami	Obsoleto. Use --marketplace=aws.
--api-server-max-threads=<i>	Contagem máxima de threads do servidor da API Puma.
--api-server-min-threads=<i>	Contagem mínima de threads do servidor da API Puma.
--application-server-max-threads=<i>	Contagem máxima de threads do Puma Application Server.
--application-server-min-threads=<i>	Contagem mínima de threads do Puma Application Server.
--apply-db-migrations	Aplicar migrações de banco de dados na inicialização. Desative apenas se você estiver aplicando migrações separadamente (padrão: true).
--async-results-cache-time=<i>	Tempo para manter os resultados assíncronos armazenados em cache (padrão: 300).
--cdn-hosts=<s>	Nomes de host separados por vírgulas para o pool de CDN (padrão: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s>	Caminho para o arquivo que contém a chave de criptografia (apenas criptografia legada).
--cloud-trace-enabled	Ative o rastreamento usando credenciais padrão ou credenciais json, se fornecidas por cloud_trace_json_file (padrão: false).
--cloud-trace-json-file=<s>	Arquivo JSON com as credenciais da conta de serviço para fazer upload dos dados de trace para o Google Cloud Trace.
--cloud-trace-project-id=<s>	ID do projeto do Google para o qual os dados de trace serão enviados.
--cloud-trace-sample-rate=<f>	A taxa (0-1) de amostragem de traces (padrão: 0,0).
--clustered	Se esse servidor faz parte de um cluster (padrão: false).
--concurrent-render-caching-jobs=<i>	Número de processos simultâneos de armazenamento em cache de renderização (padrão: 3).
--concurrent-render-jobs=<i>	Número de processos de renderização simultâneos do PhantomJS ou Chromium (padrão: 2).
--content-repo-enabled	O recurso de repositório de conteúdo está ativado (padrão: false).
--core-on-loopback	Exposição da API Core na interface de loopback (padrão: false).
--core-port=<i>	Porta em que o núcleo será executado (padrão: 19999).
--customer-artifact-maxsize=<i>	Tamanho máximo em MB do armazenamento de artefatos do cliente.
-d, --internal-db-creds=<s>	Caminho para o arquivo YAML com as credenciais do banco de dados.
--daemonize	É executado como daemon (padrão: true).
--default-mailer-domain=<s>	Domínio de correspondência padrão.
--default-mailer-fromemail=<s>	Endereço de e-mail de origem dos e-mails de correspondência padrão (padrão: Looker <[e-mail]>).
--default-mailer-host=<s>	Nome do host do correio padrão (padrão: smtp.sendgrid.net).
--default-mailer-password=<s>	Senha do e-mail padrão (a senha na linha de comando não é recomendada).
--default-mailer-port=<i>	Porta de correspondência padrão (padrão: 587).
--default-mailer-username=<s>	Nome de usuário padrão do remetente.
--disable-db-log	Desativa a geração de registros de consultas internas do banco de dados (padrão: false).
--dogstatsd-host-ip=<s>	IP do host do servidor do Datadog estatísticasd.
--dogstatsd-host-port=<i>	Porta do host do servidor do Datadog.
-e, --help	Mostra essa lista de opções de inicialização.
--enable-blobstore-recryption	Ativar a criptografia persistente do Blobstore em operações de recriação de chaves (padrão: false).
--error-emails-to=<s>	E-mails de erro para <email address>.
--experimental-features=<s>	Lista separada por vírgulas de recursos experimentais permitidos.
--experimental-routes=<s>	Lista separada por vírgulas de trajetos experimentais permitidos que geram trajetos com o sufixo de -next.
--extension-load-url=<s>	URL para carregar extensões em um iframe seguro.
--external-solr-enabled	Ative o Solr externo (em vez do padrão: Solr incorporado) (padrão: false).
--fips	Ative a criptografia FIPS-140 (padrão: false).
--force-cdn	Forçar a ativação da CDN (padrão: false).
--force-cipher-key	Desconsidera as proteções para as configurações de chave de criptografia (apenas criptografia legada, padrão: false).
--force-enable-pendo	Ativa os guias do Pendo em instâncias de rótulos particulares ou em contextos de incorporação (padrão: false).
--force-error-emails	Força o Looker a informar erros por e-mail (padrão: false).
--force-gcm-encryption	USO SUSPENSO (esta opção não é mais necessária).
--force-mismatched-internal-db	Permite o uso do banco de dados interno do Looker fora de sincronia (padrão: false).
--force-no-cdn	Forçar a desativação da CDN (padrão: false).
--git-hooks-use-local-path	Use um caminho local para o diretório git_hooks em vez do armazenamento compartilhado.
--git-performance-logging	Ativa a geração de registros de desempenho do JGit (padrão: false).
--google-analytics-tracker-id=<s>	ID de acompanhamento a ser usado para enviar visualizações de página a outros rastreadores do Google Analytics.
-h, --hosted	Hospedado pelo Looker.
-H, --hostname=<s>	Nome do host para comunicação entre nós.
--hosted-action-hub-disabled	Desative o hub de ações hospedado.
--in-memory-cache-size=<i>	Tamanho (em MB) do cache de memória (padrão: 200).
--integration-proxy-cert=<s>	Caminho para o arquivo de certificado de ICP do proxy de integração.
--integration-proxy-key=<s>	Caminho para o arquivo de chave ICP do proxy de integração.
--internal-analytics-connection-file=<s>	Arquivo YAML que descreve a conexão analítica interna que hospeda dados para o modelo system__activity. Essa opção deve ser usada apenas com um banco de dados de back-end de réplica de leitura.
--internal-analytics-connection-pool-size=<i>	O número de conexões simultâneas do banco de dados que podem executar consultas do modelo de atividade do sistema. Essa opção deve ser usada apenas com um banco de dados de back-end de réplica de leitura.
--internal-analytics-retention-days=<i>	O número de dias de retenção dos dados históricos no banco de dados interno. Isso não afeta os processos ETL. O padrão é 90. Essa opção deve ser usada apenas com um banco de dados de back-end de réplica de leitura.
--k8s-deployment-api-s3bucket-url=<s>	URL em que esse processo do Looker pode gravar credenciais de bucket do S3 a serem mantidas como secrets do Kubernetes.
--log-format=<s>	Formato de registro text ou json (padrão: text).
--log-level=<s>	Nível de registro (padrão: info).
--log-to-file	Envia a saída de registro para o arquivo de registros do Looker (padrão: true).
--lookml-runtime-cache-size=<i>	Tamanho (em MB) do cache de tempo de execução do LookML (padrão: 200).
--loose-cipher-key-file	Não exigem permissões 0600 para o arquivo de chave de criptografia (apenas criptografia legada, padrão: false).
--marketplace=<s>	Execução em uma instância do Marketplace do Looker.
--max-async-threads=<i>	Número máximo de threads de consulta assíncronos (padrão: 200).
--max-configurable-db-connections=<i>	Contagem máxima de conexões permitida para uma conexão do banco de dados do cliente na UI.
--max-db-connections-records=<i>	Número máximo de registros de conexão permitidos na tabela db_connection (padrão: 10.000).
--max-pdt-regen-threads=<i>	Número máximo de linhas de execução do regenerador de PDT.
--max-scheduled-plans=<i>	Número máximo de planos recorrentes ativos (padrão: unlimited).
--max-scheduler-jitter-in-seconds=<i>	A programação "flag to smear" é executada aleatoriamente por um determinado número de segundos.
--max-unstreamed-limit=<i>	Define o número máximo de linhas que podem ser retornadas para todas as consultas sem streaming (padrão: 100.000).
--min-pdt-regen-threads=<i>	Contagem mínima de linhas de execução para o regenerador de PDT.
--monitoring-port=<i>	Porta para hospedagem de monitoramento (Prometheus, ...) (padrão: 1552).
-n, --node-to-node-port=<i>	Porta para comunicação de nó para nó (padrão: 1551).
--new-cipher-key-file=<s>	Caminho para o arquivo que contém a nova chave de criptografia (apenas criptografia legada).
--on-disk-cache-size=<i>	Tamanho (em MB) do cache de disco (padrão: 2000).
-p, --port=<i>	Porta a ser executada (padrão: 9999).
--per-user-query-limit=<i>	Limita o número de consultas simultâneas por usuário (padrão: 15).
--per-user-query-timeout=<i>	Tempo limite por usuário para aguardar a conexão (padrão: 600).
--prefer-ipv4	Preferir IPv4.
--public-embed-auth-param-file=<s>	Arquivo de parâmetro de autenticação para autenticação pública.
--public-host-url=<s>	Se o recurso de licença public_host_url estiver ativado, essa opção vai permitir que os administradores especifiquem um nome de host public_host_url para que os URIs de callback da API Looker Action sejam construídos com public_host_url em vez do URL de host padrão no Looker. A entrada para a opção de inicialização precisa ser https://<my.host.name> sem uma barra final no URL. Se usarem esse método, os administradores do Looker também precisarão autorizar os endereços IP de saída estáticos listados na página de documentação Como compartilhar dados em um hub de ações.
-q, --queue-broker-port=<i>	Porta do agente de filas (padrão: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f>	Intervalo máximo de suspensão antes que a API de enquete longa verifique se os resultados estão disponíveis (padrão: 1).
--qm-long-poll-sleep-interval-in-seconds=<i>	Intervalo de suspensão inicial antes que a API de enquete longa verifique se os resultados estão disponíveis (padrão: 0,1).
--qm-long-poll-timeout-in-seconds=<i>	Tempo limite máximo do lado do servidor para a API de enquete longa antes de retornar ao cliente (padrão: 30).
--query-manager-max-threads=<i>	Contagem máxima de linhas de execução para o Gerenciador de consultas.
--query-manager-min-threads=<i>	Contagem mínima de threads para o Gerenciador de consultas.
--query-metrics-retention-hours=<i>	O número de horas para reter dados do query_metrics no banco de dados interno (padrão: 336).
--queue-startup-timeout-in-seconds=<i>	Quanto tempo em segundos para permitir a conexão com a fila na inicialização (padrão: 180).
--query-task-cleanup-interval-seconds=<i>	Intervalo entre jobs de limpeza da tabela de tarefas de consulta (padrão: 600).
--query-task-persistence-duration-minutes=<i>	Quantidade de tempo após a conclusão da consulta para manter linhas na tabela de tarefas da consulta (padrão: 360).
-r, --root	Permite a execução como raiz. O Looker não requer privilégios de raiz para operação normal. Por motivos de segurança, recomendamos executar o Looker em uma conta não raiz. Use a opção de executar como root somente quando necessário, por exemplo, se solicitado por um analista do Looker para solucionar problemas.
--redis-cache-config-file=<s>	Arquivo contendo a configuração do Redis.
--report-backend-errors, --no-report-backend-errors	Informa erros do back-end (padrão: false).
--report-frontend-errors, --no-report-frontend-errors	Informa erros do front-end (padrão: false).
-S, --ssh-tunnel-sidecar-url=<s>	O URL de base usado para se conectar ao arquivo secundário do servidor de túnel SSH.
--scheduled-job-attempt-limit=<i>	Número máximo de tentativas de jobs programados (padrão: 10).
--scheduled-job-max-age-days=<i>	Tempo máximo de um job programado antes de ser excluído (padrão: 60).
--scheduler-query-limit=<i>	Limita o número de consultas programadas simultâneas (padrão: 10).
--scheduler-query-timeout=<i>	Tempo limite do programador para aguardar a conexão (padrão: 1.200).
--scheduler-start-delay=<i>	Número de segundos para atrasar a inicialização do executor de tarefas (padrão: 60).
--scheduler-threads=<i>	Número de tarefas programadas simultâneas (padrão: 10).
--search-result-comparison	Compare os resultados do Serviço de pesquisa com os resultados legados (padrão: false).
--search-service	Ativa o Serviço de pesquisa (padrão: false).
--search-service-ab-test	Ative o teste AB para o Serviço de pesquisa (padrão: false).
--self-signup	Permite que qualquer pessoa crie uma conta.
--shared-storage-dir=<s>	Caminho para o armazenamento compartilhado do sistema de arquivos da rede.
--snowplow-host=<s>	Coletor de neve extra.
--solr-basic-auth=<s>	Credenciais de autenticação básicas para chamadas para Solr (padrão: solr:SolrRocks).
--ssl	Usa SSL (padrão: true).
--ssl-ca-cert=<s>	Obsoleto. Use --ssl-keystore.
--ssl-cert=<s>	Obsoleto. Use --ssl-keystore.
--ssl-key=<s>	Obsoleto. Use --ssl-keystore.
--ssl-keystore-pass-file=<s>	Caminho para o arquivo que contém a senha de ssl-keystore.
--ssl-keystore-pass=<s>	Senha do arquivo ssl-keystore.
--ssl-keystore=<s>	Caminho para o arquivo de keystore para SSL.
--ssl-provided-externally-by=<s>	Fornece a host:porta de um provedor de SSL externo como acessível pelo servidor que está executando o Looker. Quando não especificado, o servidor do app Looker fornece SSL. Confira um exemplo de proxy SSL na frente de um cluster do Looker: --ssl-provided-externally-by=192.168.123.13:443 Confira um exemplo de provedor de SSL no mesmo host da instância do Looker: --ssl-provided-externally-by=localhost:443 Um valor nulo indica que o servidor do app Looker fornece SSL. Se a instância do Looker estiver sendo executada em um servidor com acesso restrito à Internet pública, especifique um endereço IP na rede interna que possa ser acessado pelo servidor na instância do Looker.
--ssl-provided-externally	Obsoleto. Use --ssl-provided-externally-by.
--staging	Executa o servidor como preparo. Esta opção impedirá que sua instância de teste envie relatórios programados. No entanto, a instância de teste continuará executando tarefas programadas e enviará e-mails de erro para os proprietários do plano agendado se a tarefa agendada tiver algum problema.
--staging-override-email=<s>	Envia e-mails em uma instância de teste para esse endereço em vez do destino normal.
--stereo-data-search-enabled	Ativa o recurso de pesquisa de dados estéreo (padrão: false).
--studio-load-url=<s>	URL para carregar o Looker Studio em um iframe.
--task-monitor-abandoned-query-in-seconds=<i>	Duração decorrido desde o último acesso para uma tarefa considerar a tarefa de consulta abandonada.
--task-monitor-query-startup-interval-in-seconds=<i>	Duração usada como período de carência quando as consultas começam a ser executadas até que a primeira enquete longa ocorra. Isso ajuda a oferecer mais espaço para os autores da chamada antes de iniciar a enquete.
--task-monitor-sleep-interval-in-seconds=<i>	O intervalo de sono antes que a linha de execução de monitoramento de tarefas possa verificar se as tarefas foram abandonadas.
--unlimited-scheduler-threads=<i>	Número de tarefas programadas ilimitadas simultâneas (padrão: 3).
--use-custom-jdbc-config	Define se a configuração personalizada do driver JDBC será usada (padrão: false).
--user-db-credentials	Uso restrito. As conexões podem usar credenciais por usuário (padrão: false).
-v, --version	Imprime a versão e sai.

Formato do arquivo de credenciais

Se você alterou o banco de dados do aplicativo para MySQL, será necessário um arquivo de credenciais chamado looker-db.yml que inclua estas configurações:

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

Se o banco de dados MySQL exigir uma conexão SSL, o arquivo looker-db.yml também exigirá o seguinte:

ssl: true

Como tornar permanentes as opções de inicialização

O método preferido para definir as configurações de inicialização é criar um arquivo chamado lookerstart.cfg no diretório do aplicativo Looker. Esse arquivo será executado pelo script de inicialização do Looker que foi fornecido com seu looker.jar. O arquivo lookerstart.cfg é o local recomendado para definir variáveis de ambiente para JAVAARGS e LOOKERARGS, já que elas não serão substituídas quando novas versões do script de inicialização do Looker forem instaladas.

Veja um exemplo de lookerstart.cfg, que desativa o SSL do Looker e o configura para execução na porta 8080:

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

Será necessário reiniciar o Looker após as alterações em lookerstart.cfg.

Próximas etapas

Depois de configurar as opções de inicialização do Looker, está tudo pronto para configurar seu certificado SSL para o HTTPS adequado.