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 do 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í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 (somente criptografia legada).
--cloud-trace-enabled	Ative o rastreamento usando credenciais padrão ou JSON, se fornecidas usando --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 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	É 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 internas do banco de dados 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 onde vêm os e-mails do programa de e-mail 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 do mailer padrão (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 do Datadog.
-e, --help	Mostra esta lista de opções de inicialização.
--enable-blobstore-recryption	Ative a recriptografia do Blobstore persistente 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 Solr incorporado padrão) (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 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	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	Desative 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 é 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 de 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-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 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 é 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 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 internas do banco de dados do Looker em ms (padrão: 0).
--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 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 fornecido.
--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 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 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ó. Consulte a página de documentação Conectar o Looker ao seu banco de dados para mais informações.
--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 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 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 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 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 que ela retorne 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 os 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 a 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 root 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.
--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 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 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ços da 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 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 do 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 aplicativos 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 sendo executada em um servidor com acesso restrito à Internet pública, especifique um endereço IP na sua 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 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 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 da API da plataforma Studio One.
--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 um período de carência quando as consultas começam a execução 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 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 mudado 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

Tornar as opções de inicialização permanentes

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 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 define 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.