Opções de inicialização do Looker

Existem várias configurações de inicialização do Looker que podem ser definidas. Se você não precisar mudar essas opções, inicie o Looker sem elas.

Lista de opções de inicialização

Veja abaixo a lista atual de opções de inicialização 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 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 threads para o servidor de aplicativos Puma.
--apply-db-migrations Aplicar as 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 para manter os resultados assíncronos em cache (padrão: 300).
--cdn-hosts=<s> Nomes do host separados por vírgula 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 com credenciais padrão ou JSON se fornecidos 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 de dados de trace para o Google Cloud Trace.
--cloud-trace-project-id=<s> ID do projeto do Google ao qual os dados de trace serão enviados.
--cloud-trace-sample-rate=<f> A taxa (0-1) com que usar amostras de traces. O padrão é 1% (padrão: 0,01).
--clustered Indica 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 do Chromium (padrão: 2)
--content-repo-enabled O recurso de repositório de conteúdo está ativado (padrão: false).
--core-on-loopback A API Core é exposta 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 de banco de dados.
--daemonize Executa como daemon (padrão: true).
--debug-node-modules Não armazene agressivamente node_modules em cache no webpack (padrão: false).
--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 padrão (padrão: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome do host da correspondência padrão (padrão: smtp.sendgrid.net).
--default-mailer-password=<s> Senha padrão da correspondência (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 da correspondência.
--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 estatístico do Datadog.
--dogstatsd-host-port=<i> Porta do host do servidor Datadog.
-e, --help Exibe esta lista de opções de inicialização.
--error-emails-to=<s> Erro ao enviar e-mails para <email address>.
--experimental-features=<s> Lista separada por vírgulas dos recursos experimentais permitidos.
--experimental-routes=<s> Lista separada por vírgulas das rotas experimentais permitidas que geram rotas 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 (ao contrário do padrão: Solr incorporado) (padrão: false).
--force-cdn Forçar ativa o CDN (padrão: false).
--force-cipher-key Desconsidera as proteções para as configurações da chave de criptografia (apenas criptografia legada, padrão: false).
--force-enable-pendo Ativa os guias do Pendo em instâncias de rótulo particular 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 OBSOLETO. Essa opção não é mais necessária.
--force-mismatched-internal-db Permite o uso de um banco de dados interno do Looker fora de sincronia (padrão: false).
--force-no-cdn A opção"Forçar"desativa a CDN (padrão: false).
--git-hooks-use-local-path Use um caminho local para o diretório git_hooks em vez de armazenamento compartilhado.
--git-performance-logging Ativa a geração de registros do 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.
--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 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 os dados do 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 do DB 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 históricos 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 de bucket S3 para serem mantidas como secrets do Kubernetes.
--log-format=<s> Formato do registro que é um dos text, json.
--log-level=<s> Nível de registro (padrão: info).
--log-to-file Envia a saída do 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 é necessário ter permissões de 0600 para o arquivo de chave de criptografia (apenas criptografia legada, padrão: false).
--marketplace=<s> Executando em uma instância do Looker Marketplace.
--max-async-threads=<i> Número máximo de linhas de execução de consulta assíncronas (padrão: 200).
--max-configurable-db-connections=<i> Contagem máxima de conexões permitida para uma conexão de banco de dados do cliente na IU.
--max-pdt-regen-threads=<i> Número máximo de linhas de execução de regeneração de PDT.
--max-scheduled-plans=<i> Número máximo de planos programados recorrentes ativos (padrão: unlimited).
--max-unstreamed-limit=<i> Define o número máximo de linhas que podem ser retornadas para todas as consultas que não foram streaming (padrão: 100.000).
--min-pdt-regen-threads=<i> Contagem mínima de conversas para o PDT Regenerator.
--monitoring-port=<i> Porta para monitoramento de hospedagem (Prometheus, ...) (padrão: 1552).
-n, --node-to-node-port=<i> Porta para comunicação entre nós (padrão: 1551).
--new-cipher-key-file=<s> Caminho para o arquivo que contém 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, esta 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 do host padrão no Looker. A entrada da opção de inicialização precisa ser https://<my.host.name> sem barras no URL. Se estiverem usando esse método, os administradores do Looker também precisarão incluir na lista de permissões os endereços IP de saída estáticos listados na página de documentação Compartilhamento de dados por meio de um hub de ações.
-q, --queue-broker-port=<i> Porta do agente da fila (padrão: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalo máximo de sono antes da verificação da API de verificação longa, para saber se os resultados estão disponíveis.
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalo de sono inicial antes da verificação da API de verificação longa se os resultados estiverem disponíveis (padrão: 30).
--qm-long-poll-timeout-in-seconds=<i> Tempo limite máximo do lado do servidor para a API de pesquisa longa antes de retornar ao cliente.
--query-manager-max-threads=<i> Número máximo de conversas para o Gerenciador de consultas.
--query-manager-min-threads=<i> Contagem mínima de conversas para o Gerenciador de consultas.
--query-metrics-retention-hours=<i> O número de horas para reter dados de 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 os 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 as linhas na tabela de tarefas de consulta (padrão: 90).
-r, --root Permite executar como raiz.

O Looker não requer privilégios de raiz para uma operação normal. Por motivos de segurança, recomendamos que você execute o Looker em uma conta que não seja raiz. Use a opção de execução como raiz somente quando necessário. Por exemplo, se solicitado por um analista do Looker 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: true).
--report-frontend-errors, --no-report-frontend-errors Informa erros do front-end (padrão: true).
-S, --ssh-tunnel-sidecar-url=<s> O URL de base usado para se conectar ao arquivo secundário de servidor de túnel SSH.
--scheduled-job-attempt-limit=<i> Número máximo de tentativas de job programadas (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> Tempo limite do programador para aguardar a conexão (padrão: 1.200).
--scheduler-start-delay=<i> Segundos de atraso para 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 Search Service 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 para si.
--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 o 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 para o arquivo ssl-keystore.
--ssl-keystore=<s> Caminho para o arquivo do keystore para SSL.
--ssl-provided-externally-by=<s> Fornece o host:porta para um provedor de SSL externo como acessível pelo servidor que está executando o Looker. Quando não especificado, o servidor de apps do Looker oferece SSL.

Veja um exemplo de um proxy SSL na frente de um cluster do Looker:

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

Veja um exemplo de um provedor de SSL no mesmo host que sua instância do Looker:

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

Um valor nulo indica que o servidor de aplicativos do Looker fornece SSL. Se a instância do Looker estiver em execução em um servidor com acesso restrito à Internet pública, especifique um endereço IP na sua rede interna que possa ser acessado pelo servidor para sua instância do Looker.
--ssl-provided-externally Obsoleto. Use --ssl-provided-externally-by.
--staging Executa o servidor como preparo. Essa opção impedirá que a instância de preparo envie relatórios programados. No entanto, a instância de preparo ainda vai executar as tarefas programadas e vai enviar e-mails de erro para os proprietários do plano programado se a tarefa programada tiver algum problema.
--staging-override-email=<s> Envia e-mails em uma instância de preparo para esse endereço, em vez de para o destino normal.
--stereo-data-search-enabled Ativar o recurso de pesquisa de dados estéreo (padrão: false).
--super-max-query-limit Uso restrito. Define o máximo de linhas que podem ser retornadas na guia "Explorar" ou nos resultados da consulta, substituindo o limite padrão de 5.000 linhas.
--task-monitor-abandoned-query-in-seconds=<i> Duração decorrido desde o último acesso de uma tarefa 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 enquete longa ocorra. Isso ajuda a dar mais espaço aos autores da chamada antes de iniciar a pesquisa.
--task-monitor-sleep-interval-in-seconds=<i> O intervalo de sono antes da linha de execução de rastreamento de tarefas pode verificar se as tarefas estão abandonadas.
--unlimited-scheduler-threads=<i> Número de tarefas programadas ilimitadas e simultâneas (padrão: 3).
--use-custom-jdbc-config Indica 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 de arquivo de credenciais

Se você mudou o banco de dados do aplicativo para MySQL, 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

Opções para manter a inicialização permanente

O método preferencial para tornar as definições de configuração 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 fornecido com seu looker.jar. O arquivo lookerstart.cfg é o lugar 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.

Veja um exemplo 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 depois de fazer alterações 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.