Opções de arranque do Looker

Existem várias definições de arranque do Looker que podem ser configuradas opcionalmente em instâncias alojadas pelo cliente. Se não precisar de alterar estas opções, pode iniciar o Looker sem elas.

Lista de opções de arranque

A tabela seguinte apresenta uma lista das opções de arranque atuais por ordem alfabética. Também pode apresentar uma lista de opções de arranque executando o script de arranque do Looker com a opção --help.

Opção Descrição
--alerts-scheduler-threads=<i> Número de alertas programados em simultâneo (predefinição: 3).
--ami Descontinuado. Em alternativa, use --marketplace=aws.
--api-server-max-threads=<i> Número máximo de threads para o servidor da API Puma.
--api-server-min-threads=<i> Número mínimo de threads para o servidor da API Puma.
--application-server-max-threads=<i> Número máximo de threads para o servidor de aplicações Puma.
--application-server-min-threads=<i> Número mínimo de threads para o servidor de aplicações Puma.
--apply-db-migrations Aplicar migrações de BD no arranque. Desative apenas se estiver a aplicar migrações separadamente (predefinição: true).
--async-results-cache-time=<i> Tempo durante o qual os resultados assíncronos são mantidos em cache (predefinição: 300).
--byoid-studio-load-url=<s> URL para carregar o BYOID Studio numa iFrame.
--cdn-hosts=<s> Nomes de anfitrião separados por vírgulas para o conjunto de CDNs (predefinição: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Caminho para o ficheiro que contém a chave de cifra (apenas encriptação antiga).
--cloud-trace-enabled Ative o rastreio através das credenciais predefinidas ou das credenciais JSON, se forem fornecidas através de cloud_trace_json_file (predefinição: false).
--cloud-trace-json-file=<s> Ficheiro JSON com as credenciais da conta de serviço para carregar dados de rastreio para o Google Cloud Trace.
--cloud-trace-project-id=<s> ID do projeto Google para carregar dados de rastreio.
--cloud-trace-sample-rate=<f> A taxa (0-1) com a qual amostrar rastreios (predefinição: 0,0).
--clustered Se este servidor faz parte de um cluster (predefinição: false).
--concurrent-render-caching-jobs=<i> Número de processos de colocação em cache de renderização simultâneos (predefinição: 3).
--concurrent-render-jobs=<i> Número de processos de renderização do PhantomJS ou do Chromium simultâneos (predefinição: 2).
--core-on-loopback Expõe a API Core na interface de loopback (predefinição: false).
--core-port=<i> Porta para executar o núcleo (predefinição: 19999).
--customer-artifact-maxsize=<i> Tamanho máximo em MB do arquivo de artefactos do cliente.
-d, --internal-db-creds=<s> Caminho para o ficheiro YAML com as credenciais da base de dados.
--daemonize Executa como daemon (predefinição: true).
--default-mailer-domain=<s> Domínio do remetente predefinido.
--default-mailer-fromemail=<s> Endereço de email a partir do qual são enviados os emails do programa de email predefinido (predefinição: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome de anfitrião do remetente predefinido (predefinição: smtp.sendgrid.net).
--default-mailer-password=<s> Palavra-passe do remetente predefinida (não é recomendável usar a palavra-passe na linha de comandos).
--default-mailer-port=<i> Porta do mailer predefinida (predefinição: 587).
--default-mailer-username=<s> Nome de utilizador do remetente predefinido.
--disable-db-log Desativa o registo de consultas da base de dados interna (predefinição: false).
--dogstatsd-host-ip=<s> IP do anfitrião do servidor statsd do Datadog.
--dogstatsd-host-port=<i> Porta do anfitrião do servidor Datadog.
-e, --help Apresenta esta lista de opções de arranque.
--enable-blobstore-recryption Ativar a reencriptação persistente do Blobstore em operações de alteração de chave (predefinição: false).
--error-emails-to=<s> Emails de erro para <email address>.
--experimental-features=<s> Lista separada por vírgulas de funcionalidades experimentais permitidas.
--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 num iFrame seguro.
--external-solr-enabled Ative o Solr externo (em oposição ao predefinido, o Solr incorporado) (predefinição: false).
--fips Ative a encriptação FIPS-140 (predefinição: false).
--force-cdn Forçar a ativação da RFC (predefinição: false).
--force-cipher-key Ignora as salvaguardas para as definições da chave de cifragem (apenas encriptação antiga, predefinição: false).
--force-enable-pendo Ativa os guias do Pendo em instâncias de marca própria ou em contextos de incorporação (predefinição: false).
--force-error-emails Força o Looker a comunicar erros por email (predefinição: false).
--force-gcm-encryption DESCONTINUADO (esta opção já não é necessária).
--force-mismatched-internal-db Permite a utilização da BD interna do Looker dessincronizada (predefinição: false).
--force-no-cdn Desative a RFC à força (predefinição: false).
--git-hooks-use-local-path Use um caminho local para o diretório git_hooks em vez do armazenamento partilhado.
--git-performance-logging Ativa o registo do desempenho do JGit (predefinição: false).
--google-analytics-tracker-id=<s> ID de acompanhamento a usar para enviar visualizações de páginas para rastreadores adicionais do Google Analytics.
-h, --hosted Alojado pelo Looker.
-H, --hostname=<s> Nome de anfitrião para comunicação entre nós.
--hosted-action-hub-disabled Desative o centro de ações alojado.
--in-memory-cache-size=<i> Tamanho (em MB) da cache na memória (predefinição: 200).
--integration-proxy-cert=<s> Caminho para o ficheiro de certificado PKI do proxy de integração.
--integration-proxy-key=<s> Caminho para o ficheiro de chave PKI do proxy de integração.
--internal-analytics-connection-file=<s> Ficheiro YAML que descreve a ligação de estatísticas interna que aloja dados para o modelo system__activity. Esta opção destina-se apenas a utilização com uma base de dados de back-end de réplica de leitura.
--internal-analytics-connection-pool-size=<i> O número de ligações à base de dados simultâneas que podem executar consultas de modelos de atividade do sistema. Esta opção destina-se apenas a utilização com uma base de dados de back-end de réplica de leitura.
--internal-analytics-retention-days=<i> O número de dias para reter os dados do histórico na base de dados interna. Isto não afeta nenhum processo de ETL. O valor predefinido é 90. Esta opção destina-se apenas a utilização com uma base de dados de back-end de réplica de leitura.
--k8s-deployment-api-s3bucket-url=<s> URL onde este processo do Looker pode escrever credenciais do contentor S3 para serem mantidas como segredos do Kubernetes.
--log-format=<s> Formato de registo que é text ou json (predefinição: text).
--log-level=<s> Nível de registo (predefinição: info).
--log-to-file Envia a saída do registo para o ficheiro de registo do Looker (predefinição: true).
--lookml-runtime-cache-size=<i> Tamanho (em MB) da cache de tempo de execução do LookML (predefinição: 200).
--loose-cipher-key-file Não exigir autorizações 0600 para o ficheiro de chave de cifra (apenas encriptação antiga, predefinição: false).
--marketplace=<s> Execução numa instância do mercado do Looker.
--max-async-threads=<i> Número máximo de threads de consulta assíncronas (predefinição: 200).
--max-configurable-db-connections=<i> Número máximo de ligações permitidas para uma ligação à base de dados de clientes na IU.
--max-db-connections-records=<i> Número máximo de registos de associação permitidos na tabela db_connection (predefinição: 10 000).
--max-pdt-regen-threads=<i> Número máximo de threads do regenerador de PDTs.
--max-scheduled-plans=<i> Número máximo de planos recorrentes agendados ativos (predefinição: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag para dispersar as execuções da agenda aleatoriamente ao longo do número de segundos indicado.
--max-unstreamed-limit=<i> Define o número máximo de linhas que podem ser devolvidas para todas as consultas que não são transmitidas (predefinição: 100 000).
--min-pdt-regen-threads=<i> Número mínimo de threads para o regenerador de PDT.
--monitoring-port=<i> Porta para alojamento da monitorização (Prometheus, …) (predefinição: 1552).
-n, --node-to-node-port=<i> Porta para comunicação entre nós (predefinição: 1551).
--new-cipher-key-file=<s> Caminho para o ficheiro que contém a nova chave de cifragem (apenas encriptação antiga).
--on-disk-cache-size=<i> Tamanho (em MB) da cache do disco (predefinição: 2000).
-p, --port=<i> Porta a usar (predefinição: 9999).
--per-user-query-limit=<i> Limita o número de consultas simultâneas por utilizador (predefinição: 15).
--per-user-query-timeout=<i> Comprimento do tempo limite por utilizador para aguardar a ligação (predefinição: 600).
--prefer-ipv4 Preferir IPv4.
--public-embed-auth-param-file=<s> Ficheiro de parâmetros de autenticação para autorização pública.
--public-host-url=<s> Se a funcionalidade de licença public_host_url estiver ativada, esta opção permite que os administradores especifiquem um nome de anfitrião 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 anfitrião predefinido no Looker. A entrada para a opção de arranque deve ser https://<my.host.name> sem barra invertida no final do URL. Se usar este método, os administradores do Looker também têm de adicionar à lista de autorizações os endereços IP de saída estáticos indicados na página de documentação Partilhar dados através de um centro de ações.
-q, --queue-broker-port=<i> Porta para o agente de filas (predefinição: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervalo máximo de suspensão antes de a API de sondagem longa verificar se os resultados estão disponíveis (predefinição: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervalo de suspensão inicial antes de a API de sondagem longa verificar se os resultados estão disponíveis (predefiniçã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 regressar ao cliente (predefinição: 30).
--query-manager-max-threads=<i> Número máximo de discussões para o Gestor de consultas.
--query-manager-min-threads=<i> Número mínimo de linhas para o Gestor de consultas.
--query-metrics-retention-hours=<i> O número de horas para reter dados query_metrics na base de dados interna (predefinição: 336).
--queue-startup-timeout-in-seconds=<i> Durante quanto tempo, em segundos, deve ser permitida a ligação à fila no arranque (predefinição: 180).
--query-task-cleanup-interval-seconds=<i> Intervalo entre tarefas de limpeza da tabela de tarefas de consulta (predefiniçã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 (predefinição: 360).
-r, --root Permite a execução como raiz.

O Looker não requer privilégios de raiz para o funcionamento normal. Por motivos de segurança, recomendamos que execute o Looker numa conta sem acesso de raiz. Use a opção para executar como raiz apenas quando necessário, por exemplo, se for solicitada por um analista do Looker para fins de resolução de problemas.
--redis-cache-config-file=<s> Ficheiro que contém a configuração do Redis.
--report-backend-errors, --no-report-backend-errors Denuncia erros do back-end (predefinição: false).
--report-frontend-errors, --no-report-frontend-errors Comunica erros do front-end (predefinição: false). NOTA: esta opção de arranque está obsoleta. Em alternativa, use a flag de funcionalidade client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> O URL base usado para estabelecer ligação ao sidecar do servidor de túnel SSH.
--scheduled-job-attempt-limit=<i> Número máximo de tentativas de tarefas agendadas (predefinição: 10).
--scheduled-job-max-age-days=<i> Idade máxima de uma tarefa agendada antes de ser eliminada (predefinição: 60).
--scheduler-query-limit=<i> Limita o número de consultas agendadas simultâneas (predefinição: 10).
--scheduler-query-timeout=<i> Tempo limite do agendador para aguardar a ligação (predefinição: 1200).
--scheduler-start-delay=<i> Número de segundos de atraso antes do início do executor de tarefas (predefinição: 60).
--scheduler-threads=<i> Número de tarefas agendadas simultâneas (predefinição: 10).
--search-result-comparison Compare os resultados do serviço de pesquisa com os resultados antigos (predefinição: false).
--search-service Ativa o serviço de pesquisa (predefinição: false).
--search-service-ab-test Ative o teste A/B para o serviço de pesquisa (predefinição: false).
--self-signup Permite que qualquer pessoa crie uma conta para si própria.
--shared-storage-dir=<s> Caminho para o armazenamento partilhado do sistema de ficheiros de rede.
--snowplow-host=<s> Coletor da Snowplow adicional.
--solr-basic-auth=<s> Credenciais de autenticação básica para chamadas para o Solr (predefinição: solr:SolrRocks).
--ssl Usa SSL (predefinição: true).
--ssl-ca-cert=<s> Descontinuado. Em alternativa, use --ssl-keystore.
--ssl-cert=<s> Descontinuado. Em alternativa, use --ssl-keystore.
--ssl-key=<s> Descontinuado. Em alternativa, use --ssl-keystore.
--ssl-keystore-pass-file=<s> Caminho para o ficheiro que contém a palavra-passe ssl-keystore.
--ssl-keystore-pass=<s> Palavra-passe para o ficheiro ssl-keystore.
--ssl-keystore=<s> Caminho para o ficheiro de keystore para SSL.
--ssl-provided-externally-by=<s> Fornece o anfitrião:porta para um fornecedor de SSL externo acessível a partir do servidor que está a executar o Looker. Quando não é especificado, o servidor de apps do Looker fornece SSL.

Segue-se um exemplo de um proxy SSL em frente de um cluster do Looker:

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

Segue-se um exemplo de um fornecedor de SSL no mesmo anfitrião que a sua instância do Looker:

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

Um valor nulo indica que o servidor da app Looker fornece SSL. Se a sua instância do Looker estiver a ser executada num servidor com acesso restrito à Internet pública, tem de especificar um endereço IP na sua rede interna que seja acessível pelo servidor da sua instância do Looker.
--ssl-provided-externally Descontinuado. Em alternativa, use --ssl-provided-externally-by.
--staging Executa o servidor como preparação. Esta opção impede que a instância de teste envie relatórios agendados. No entanto, a instância de preparação continua a executar tarefas agendadas e envia emails de erro aos proprietários do plano agendado se a tarefa agendada tiver problemas.
--staging-override-email=<s> Envia emails numa instância de preparação para este endereço em vez do respetivo destino normal.
--stereo-data-search-enabled Ative a funcionalidade de pesquisa de dados estéreo (predefinição: false).
--studio-load-url=<s> URL para carregar o Studio numa iFrame.
--studio-one-platform-endpoint=<s> Ponto final da API Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i> Duração decorrida desde o último acesso para uma tarefa considerar a tarefa de consulta abandonada.
--task-monitor-query-startup-interval-in-seconds=<i> Duração usada como período de tolerância quando as consultas iniciam a execução até ocorrer a primeira sondagem longa. Ajuda a dar mais espaço aos autores das chamadas antes de iniciar a sondagem.
--task-monitor-sleep-interval-in-seconds=<i> Intervalo de suspensão antes de o tópico de monitorização de tarefas poder 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 (predefinição: 3).
--use-custom-jdbc-config Se deve usar a configuração do controlador JDBC personalizado (predefinição: false).
--user-db-credentials Utilização restrita. As ligações podem usar credenciais por utilizador (predefinição: false).
-v, --version Imprime a versão e sai.

Formato de ficheiro de credenciais

Se alterou a base de dados da aplicação para MySQL, precisa de um ficheiro de credenciais denominado looker-db.yml que inclua estas definições:

dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT

Se a sua base de dados MySQL exigir uma ligação SSL, o ficheiro looker-db.yml também requer o seguinte:

ssl: true

Tornar as opções de arranque permanentes

O método preferencial para tornar as definições de configuração de arranque permanentes é criar um ficheiro denominado lookerstart.cfg no diretório da aplicação Looker. Este ficheiro é executado pelo script de arranque do Looker fornecido com o ficheiro looker.jar. O ficheiro lookerstart.cfg é o local recomendado para definir variáveis de ambiente para JAVAARGS e LOOKERARGS, uma vez que não são substituídas quando são instaladas novas versões do script de arranque do Looker.

Segue-se 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"

É necessário reiniciar o Looker depois de fazer alterações ao ficheiro lookerstart.cfg.

Passos seguintes

Depois de configurar as opções de arranque do Looker, pode configurar o certificado SSL para um HTTPS adequado.