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 você não precisar mudar essas opções, 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. 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 de API Puma.
--api-server-min-threads=<i>	Contagem mínima de linhas de execução para o servidor de 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 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 as credenciais padrão ou JSON, se fornecidas, com --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 trace para o Google Cloud Trace.
--cloud-trace-project-id=<s>	ID do projeto do Google para fazer upload de dados de trace.
--cloud-trace-sample-rate=<f>	A taxa (0-1) com que os traces 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 armazenamento em cache de renderização (padrão: 3).
--concurrent-render-jobs=<i>	Número de processos simultâneos de renderização 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	É executado como daemon (padrão: true).
--db-migrations-kill-timeout=<i>	Tempo limite de encerramento para migrações de banco de dados em segundos (padrão: 480).
--db-migrations-lock-wait-timeout=<i>	Tempo limite de espera de bloqueio para migrações de banco de dados em segundos (padrão: 180).
--db-migrations-monitor-cutoff=<i>	Horário-limite para monitorar migrações de banco de dados internas em segundos (padrão: 2592000).
--db-migrations-wait-timeout=<i>	Tempo limite de espera para migrações de banco de dados em segundos (padrão: 720).
--default-mailer-domain=<s>	Domínio de e-mail padrão.
--default-mailer-fromemail=<s>	Endereço de e-mail de origem dos e-mails padrão (padrão: Looker <[e-mail]>).
--default-mailer-host=<s>	Nome do host do mailer 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 padrão do mailer (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 statsd do Datadog.
--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	Ative a recriptografia do Persistent Blobstore em operações de troca de 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, o Solr incorporado) (padrão: false).
--fips	Ativar a criptografia FIPS-140 (padrão: false).
--force-cdn	Ativa a CDN de forma forçada (padrão: false).
--force-cipher-key	Ignora as proteções para as configurações da 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 usando e-mail (padrão: false).
--force-gcm-encryption	DESCONTINUADO (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	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 a geração de registros de desempenho do JGit (padrão: false).
--google-analytics-tracker-id=<s>	ID de rastreamento 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	Desativar a central de ações hospedada.
--in-memory-cache-size=<i>	Tamanho (em MB) do cache em 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 de modelo de atividade do sistema. Essa opção é usada apenas com um banco de dados de back-end de réplica de leitura.
--internal-data-apps-on-gcs	Permite que as extensões de apps de dados busquem recursos de ambiente de execução no Google Cloud Storage (somente para uso interno/Googlers).
--internal-analytics-retention-days=<i>	O número de dias em que os dados do histórico são retidos 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 do S3 para serem mantidas como secrets do Kubernetes.
--load-chronicle-dialect	Se o dialeto integrado do Chronicle deve ser carregado (padrão: false).
--log-format=<s>	Formato de registro que é text ou json (padrão: text).
--log-frontend-errors	Registra os detalhes do erro do front-end no arquivo de registro do cliente (padrão: false).
--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).
--lookerdb-query-timeout=<i>	Valor de tempo limite para consultas do banco de dados interno do Looker em ms (padrão: 0).
--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 exigir permissões 0600 para o arquivo de chave de criptografia (somente criptografia legada, padrão: false).
--marketplace=<s>	Em execução 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>	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 programados recorrentes ativos (padrão: unlimited).
--max-scheduler-jitter-in-seconds=<i>	Sinalização para distribuir as execuções de programação aleatoriamente pelo 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 (padrão: 100.000).
--min-pdt-regen-threads=<i>	Contagem mínima de linhas de execução para o regenerador de TDP.
--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 a nova chave de criptografia (somente criptografia legada).
--on-disk-cache-size=<i>	Tamanho (em MB) do cache em 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, por conexão e por nó na instância do Looker (padrão: 15). Para uma conexão, se um valor for fornecido para a configuração Número máximo de consultas simultâneas por usuário para esta conexão, esse valor vai substituir o per-user-query-limit da conexão. A configuração Número máximo de consultas simultâneas por usuário para esta conexão é por usuário e por conexão, mas não por nó. Para mais informações, consulte a página de documentação Como conectar o Looker ao seu banco de dados.
--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âmetro de autenticação para autenticação pública.
--public-host-url=<s>	Se o recurso de licença do public_host_url estiver ativado, essa opção vai permitir que os administradores especifiquem um nome do host do 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 para a opção de inicialização precisa ser https:// sem barra final no URL. Se usarem 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 Compartilhar dados por uma central de ações.
-q, --queue-broker-port=<i>	Porta para o agente de fila (padrão: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f>	Intervalo máximo de suspensão antes que a API de sondagem 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 sondagem 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 sondagem longa antes de retornar ao cliente (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 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>	Por 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>	Tempo 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 raiz para 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.
--regionalised-prod-byoid-studio-load-url=<s>	URL de produção com região de marcador de posição para carregar o estúdio do BYOID em um iframe.
--regionalised-prod-studio-load-url=<s>	URL de produção com região de marcador de posição para carregar o Studio.
--regionalised-prod-studio-one-platform-endpoint=<s>	Endpoint de produção com região de marcador de posição para a API Studio One Platform.
--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 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 job programado (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 programadas simultâneas (padrão: 10).
--search-result-comparison	Compare os resultados dos serviços da 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 da 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 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 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 de SSL externo, conforme acessível no servidor que está executando o Looker. Quando não especificado, o servidor de apps do Looker fornece SSL. Veja um exemplo de 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 apps do Looker fornece SSL. Se a instância do Looker estiver em execução em um servidor com acesso restrito à Internet pública, será necessário especificar 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 preparo. Essa opção impede que a instância de preparo envie relatórios programados. No entanto, a instância de preparo vai continuar executando tarefas programadas e enviando e-mails de erro aos proprietários de planos programados 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 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 para a API Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i>	Duração decorrida desde o último acesso para que uma tarefa considere 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 ocorra a primeira sondagem longa. Isso ajuda a dar mais espaço para os autores de chamadas antes de iniciar a sondagem.
--task-monitor-sleep-interval-in-seconds=<i>	Intervalo de suspensão 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 agendadas ilimitadas simultâneas (padrão: 3).
--url-flags-override	Permite substituir as flags de recurso usando um parâmetro de consulta de URL.
--use-custom-jdbc-config	Se a configuração personalizada do driver JDBC deve ser usada (padrão: false).
--user-db-credentials	Uso restrito. As conexões podem usar credenciais por usuário (padrão: false).
-v, --version	Mostra a versão e sai.

Formato do arquivo de credenciais

Se você tiver alterado 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 vai precisar do seguinte:

ssl: true

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

O método preferido 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 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.

Veja 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 que você fizer mudanças em lookerstart.cfg.

Próximas etapas

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