Opções de inicialização do Looker

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

Lista de opções de inicialização

A tabela a seguir mostra uma lista das opções de inicialização atuais em ordem alfabética. Você também pode 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> Número máximo de linhas de execução para o servidor da API Puma.
--api-server-min-threads=<i> Contagem mínima de linhas de execução para o servidor da API Puma.
--application-server-max-threads=<i> Contagem máxima de linhas de execução para o servidor de aplicativos Puma.
--application-server-min-threads=<i> Contagem mínima de linhas de execução para o servidor de aplicativos Puma.
--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> Período de tempo para manter os resultados assíncronos 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 criptografia (somente criptografia legada).
--cloud-trace-enabled Ative o rastreamento usando credenciais padrão ou JSON, se fornecidas via cloud_trace_json_file (padrão: false).
--cloud-trace-json-file=<s> Arquivo JSON que contém 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 a 1) com que os rastreamentos são amostrados (padrão: 0,0).
--clustered Se este servidor faz parte de um cluster (padrão: false).
--concurrent-render-caching-jobs=<i> Número de processos simultâneos de cache de renderização (padrão: 3).
--concurrent-render-jobs=<i> Número de processos de renderização simultâneos do PhantomJS ou do Chromium (padrão: 2).
--core-on-loopback Expõe a API Core na interface de loopback (padrão: false).
--core-port=<i> Porta para executar o núcleo (padrão: 19999).
--customer-artifact-maxsize=<i> Tamanho máximo em MB do repositório de artefatos do cliente.
-d, --internal-db-creds=<s> Caminho para o arquivo YAML com credenciais do banco de dados.
--daemonize Executa como daemon (padrão: true).
--default-mailer-domain=<s> Domínio do remetente padrão.
--default-mailer-fromemail=<s> Endereço de e-mail de onde vêm os e-mails do serviço de e-mail padrão (padrão: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome do host do remetente de e-mail padrão (padrão: smtp.sendgrid.net).
--default-mailer-password=<s> Senha do remetente de e-mail padrão (não é recomendável usar senhas na linha de comando).
--default-mailer-port=<i> Porta padrão do mailer (padrão: 587).
--default-mailer-username=<s> Nome de usuário padrão do remetente de e-mail.
--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 statsd do Datadog.
--dogstatsd-host-port=<i> Porta do host do servidor Datadog.
-e, --help Mostra esta lista de opções de inicialização.
--enable-blobstore-recryption Ative a recriptografia persistente do Blobstore em operações de nova chave (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, que é o Solr incorporado) (padrão: false).
--fips Ativar criptografia FIPS-140 (padrão: false).
--force-cdn Força a ativação da CDN (padrão: false).
--force-cipher-key Ignora as proteções para as configurações de chave de criptografia (somente criptografia legada, padrão: false).
--force-enable-pendo Ativa os guias do Pendo em instâncias de marca própria 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 de um banco de dados interno do Looker dessincronizado (padrão: false).
--force-no-cdn Desativa a CDN à força (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 o registro 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 de nó a nó.
--hosted-action-hub-disabled Desative a central de ações hospedada.
--in-memory-cache-size=<i> Tamanho (em MB) do cache na memória (padrão: 200).
--integration-proxy-cert=<s> Caminho para o arquivo de certificado PKI do proxy de integração.
--integration-proxy-key=<s> Caminho para o arquivo de chave PKI 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 é para uso 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 de banco de dados que podem executar consultas do modelo de atividade do sistema. Essa opção é para uso 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 de histórico no banco de dados interno. Isso não afeta nenhum processo de ETL. O padrão é 90. Essa opção é para uso 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 do bucket do S3 para 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 ambiente de execução do LookML (padrão: 200).
--loose-cipher-key-file Não requer permissões 0600 para o arquivo de chave de criptografia (somente 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 linhas de execução de consultas assíncronas (padrão: 200).
--max-configurable-db-connections=<i> Número máximo de conexões permitidas para uma conexão de 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 TDP.
--max-scheduled-plans=<i> Número máximo de planos recorrentes programados ativos (padrão: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag para distribuir as execuções de programação aleatoriamente ao longo do número de segundos especificado.
--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 por streaming (padrão: 100.000).
--min-pdt-regen-threads=<i> Contagem mínima de linhas de execução para o PDT Regenerator.
--monitoring-port=<i> Porta para hospedagem de monitoramento (Prometheus etc.). O 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 (somente criptografia legada).
--on-disk-cache-size=<i> Tamanho (em MB) do cache de disco (padrão: 2000).
-p, --port=<i> Porta para execução (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> Duração do 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âmetros 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 permitirá que os administradores especifiquem um nome de host public_host_url para que os URIs de callback da API Looker Action sejam criados com o 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 barra final no URL. Se estiver usando esse método, os administradores do Looker também precisarão adicionar à lista de permissões os endereços IP estáticos de saída listados na página de documentação Compartilhar dados por um hub de ações.
-q, --queue-broker-port=<i> Porta do broker de filas (padrão: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalo máximo de espera antes que a API de longa duração verifique se os resultados estão disponíveis (padrão: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalo de espera inicial antes que a API de long polling 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 sondagem longa antes que ela retorne ao cliente. O padrão é 30.
--query-manager-max-threads=<i> Número máximo de linhas de execução para o Gerenciador de consultas.
--query-manager-min-threads=<i> Contagem mínima de linhas de execução para o Query Manager.
--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 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> Período após a conclusão da consulta para manter as linhas na tabela de tarefas de consulta (padrão: 360).
-r, --root Permite a execução como raiz.

O Looker não exige privilégios de root para operação normal. Por motivos de segurança, recomendamos que você execute o Looker em uma conta não raiz. Use a opção de execução como raiz somente quando necessário, por exemplo, se um analista do Looker solicitar para fins de solução de problemas.
--redis-cache-config-file=<s> Arquivo que contém 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. Em vez disso, use a flag de recurso client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> O URL base usado para se conectar ao sidecar 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 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> 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 executor de tarefas (padrão: 60).
--scheduler-threads=<i> Número de tarefas agendadas 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 A/B para o Serviço de pesquisa (padrão: false).
--self-signup Permite que qualquer pessoa crie uma conta para si mesma.
--shared-storage-dir=<s> Caminho para o armazenamento compartilhado do sistema de arquivos de rede.
--snowplow-host=<s> Coletor extra do Snowplow.
--solr-basic-auth=<s> Credenciais de autenticação básica para chamadas ao 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 do ssl-keystore.
--ssl-keystore-pass=<s> Senha do arquivo ssl-keystore.
--ssl-keystore=<s> Caminho para o arquivo de keystore do SSL.
--ssl-provided-externally-by=<s> Fornece o host:porta de um provedor SSL externo acessível do servidor que está executando o Looker. Quando não especificado, o servidor de apps do 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 um provedor SSL no mesmo host da sua instância do Looker:

--ssl-provided-externally-by=localhost:443

Um valor nulo indica que o servidor de apps do 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 da instância do Looker.
--ssl-provided-externally Obsoleto. Use --ssl-provided-externally-by.
--staging Executa o servidor como teste. Essa opção impede que sua instância de teste envie relatórios programados. No entanto, a instância de teste vai continuar executando tarefas programadas e enviando e-mails de erro aos proprietários de planos programados se a tarefa tiver problemas.
--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 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 da plataforma Studio One.
--task-monitor-abandoned-query-in-seconds=<i> Duração decorrida desde o último acesso para considerar a tarefa de consulta 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é que a primeira pesquisa longa ocorra. Isso ajuda a dar mais espaço para os autores das chamadas antes de iniciar a pesquisa.
--task-monitor-sleep-interval-in-seconds=<i> Intervalo de espera antes que a linha de execução de rastreamento de tarefas possa verificar se as tarefas foram abandonadas.
--unification-jwt-service-account=<s> Conta de serviço JWT de unificação.
--unlimited-scheduler-threads=<i> Número de tarefas programadas ilimitadas simultâneas (padrão: 3).
--use-custom-jdbc-config Se deve usar a configuração personalizada do driver JDBC (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ê mudou o banco de dados do aplicativo para o 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 vai precisar do seguinte:

ssl: true

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

O método preferido para tornar permanentes as configurações de configuração 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 fornecido com o looker.jar. O arquivo lookerstart.cfg é o local recomendado para definir variáveis de ambiente para JAVAARGS e LOOKERARGS, porque 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 configura para ser executado na porta 8080:

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

O Looker precisará ser reiniciado depois de fazer mudanças em lookerstart.cfg.

Próximas etapas

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