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

A tabela a seguir mostra as opções de inicialização atuais em ordem alfabética. Também é possível exibir 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 linhas de execução para o servidor da API Puma.
--api-server-min-threads=<i>	Contagem mínima de linhas para o 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).
--byoid-studio-load-url=<s>	URL para carregar o BYOID Studio em um iframe.
--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 cifra (somente 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 contendo as credenciais da conta de serviço para fazer upload de dados de rastreamento para o Google Cloud Trace.
--cloud-trace-project-id=<s>	ID do projeto do Google para fazer upload dos dados de rastreamento.
--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).
--core-on-loopback	Expõe a 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: verdadeiro).
--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 remetente padrão (padrão: smtp.sendgrid.net).
--default-mailer-password=<s>	Senha padrão do mailer (não é recomendável usar a senha na linha de comando).
--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 esta 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 rotas experimentais permitidas que geram rotas com o sufixo -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	Ativar a criptografia FIPS-140 (padrão: false).
--force-cdn	Forçar a ativação da CDN (padrão: false).
--force-cipher-key	Ignora as proteções para as configurações da chave de cifra (somente 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	DESCONTINUADA (essa opção não é mais necessária).
--force-mismatched-internal-db	Permite o uso do banco de dados interno do Looker fora de sincronização (padrão: false).
--force-no-cdn	Desativação forçada do 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 de análise 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 é 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 para reter dados históricos no banco de dados interno. Isso não afeta nenhum processo 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 registro 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 é necessário ter permissões 0600 para o arquivo de chave de criptografia (somente criptografia legada, padrão: false).
--marketplace=<s>	Executando em uma instância do Marketplace do Looker.
--max-async-threads=<i>	Número máximo de linhas de execução de consulta assíncrona (padrão: 200).
--max-configurable-db-connections=<i>	Contagem máxima de conexões permitidas para uma conexão de banco de dados do cliente na interface.
--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 TDP.
--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 que não são transmitidas em fluxo (padrão: 100.000).
--min-pdt-regen-threads=<i>	Contagem mínima de linhas de execução para o Regenerator do 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ó a nó (padrão: 1551).
--new-cipher-key-file=<s>	Caminho para o arquivo que contém a nova chave de cifra (somente criptografia legada).
--on-disk-cache-size=<i>	Tamanho (em MB) do cache de disco (padrão: 2000).
-p, --port=<i>	Porta em que será executado (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 de suspensão máximo antes que a API de pesquisa 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 servidor para a API de pesquisa 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 linhas para o gerenciador de consultas.
--query-metrics-retention-hours=<i>	O número de horas para reter dados query_metrics no banco de dados interno (padrão: 336).
--queue-startup-timeout-in-seconds=<i>	Tempo (em segundos) para permitir a conexão à 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 de 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). OBSERVAÇÃO: essa opção de inicialização está obsoleta. Use a flag de recurso client_monitor.
-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>	Idade máxima de um job programado antes da exclusão (padrão: 60).
--scheduler-query-limit=<i>	Limita o número de consultas programadas simultâneas (padrão: 10).
--scheduler-query-timeout=<i>	Duração do tempo limite do programador para aguardar a conexão (padrão: 1200).
--scheduler-start-delay=<i>	Número de segundos para atrasar a inicialização do task runner (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 extra do Snowplow.
--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 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 o host:porta para um provedor SSL externo como acessível pelo servidor que está executando o Looker. Quando não especificado, o servidor do app do Looker fornece SSL. Confira um exemplo de proxy SSL em 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 do Looker fornece SSL. Se a instância do Looker estiver em execução em um servidor com acesso restrito à Internet pública, você vai precisar especificar um endereço IP na rede interna que possa ser acessado pelo servidor para a instância do Looker.
--ssl-provided-externally	Obsoleto. Use --ssl-provided-externally-by.
--staging	Executa o servidor como preparo. Essa opção impede que a instância de preparação 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	Ative o recurso de pesquisa de dados de áudio estéreo (padrão: false).
--studio-load-url=<s>	URL para carregar o Studio em um iframe.
--studio-one-platform-endpoint=<s>	Endpoint da API Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i>	Duração decorrido desde o último acesso para que uma tarefa seja considerada abandonada.
--task-monitor-query-startup-interval-in-seconds=<i>	Duração usada como um período de carência quando as consultas começam a ser executadas até a primeira pesquisa longa. 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 sequência 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 do driver JDBC personalizado 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ê tiver mudado o banco de dados do aplicativo para MySQL, vai precisar de 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 preferencial para tornar as configurações de inicialização permanentes é criar um arquivo chamado lookerstart.cfg no diretório do aplicativo do 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.

Confira um exemplo de lookerstart.cfg, que desativa o SSL do Looker e o define para ser executado na porta 8080:

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

O Looker precisa ser reiniciado depois de fazer mudanças no lookerstart.cfg.

Próximas etapas

Depois de configurar as opções de inicialização do Looker, você pode configurar seu certificado SSL para HTTPS adequado.