Opzioni di avvio di Looker

Facoltativamente, alcune impostazioni di avvio di Looker possono essere configurate. Se non è necessario modificare queste opzioni, puoi avviare Looker senza utilizzarle.

Elenco opzioni di avvio

Di seguito è riportato l'elenco delle opzioni di avvio correnti in ordine alfabetico. Puoi anche visualizzare un elenco di opzioni di avvio eseguendo lo script di avvio di Looker con l'opzione --help.

Opzione Descrizione
--alerts-scheduler-threads=<i> Numero di avvisi pianificati simultanei (impostazione predefinita: 3).
--ami Deprecato. Usa invece il criterio --marketplace=aws.
--api-server-max-threads=<i> Numero massimo di thread per il server API Puma.
--api-server-min-threads=<i> Numero minimo di thread per il server API Puma.
--application-server-max-threads=<i> Numero massimo di thread per il server delle applicazioni Puma.
--application-server-min-threads=<i> Numero minimo di thread per il server delle applicazioni Puma.
--apply-db-migrations Applica le migrazioni dei database all'avvio. Disabilita solo se applichi le migrazioni separatamente (impostazione predefinita: true).
--async-results-cache-time=<i> Periodo di tempo per mantenere i risultati sincronizzati memorizzati nella cache (impostazione predefinita: 300).
--cdn-hosts=<s> Nomi host separati da virgola per il pool di CDN (valore predefinito: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Percorso del file contenente la chiave di crittografia (solo crittografia precedente).
--cloud-trace-enabled Attiva il tracciamento utilizzando le credenziali predefinite o le credenziali json, se fornite tramite cloud_trace_json_file (valore predefinito: false).
--cloud-trace-json-file=<s> File JSON contenente le credenziali dell'account di servizio per caricare i dati di traccia in Google Cloud Trace.
--cloud-trace-project-id=<s> ID progetto Google in cui caricare i dati di traccia.
--cloud-trace-sample-rate=<f> La frequenza (0-1) con cui campionare le tracce. Il valore predefinito è 1% (predefinito: 0,01).
--clustered Indica se il server fa parte di un cluster (valore predefinito: false).
--concurrent-render-caching-jobs=<i> Numero di processi di memorizzazione contemporanea nella cache (visualizzazione predefinita: 3).
--concurrent-render-jobs=<i> Numero di processi di rendering PhantomJS o Chromium simultanei (predefinito: 2).
--content-repo-enabled La funzionalità di repository di contenuti è abilitata (valore predefinito: false).
--core-on-loopback espone l'API Core sull'interfaccia di loopback (impostazione predefinita: false).
--core-port=<i> Porta su cui eseguire il core (valore predefinito: 19999).
--customer-artifact-maxsize=<i> Dimensione massima in MB dell'archivio di artefatti del cliente.
-d, --internal-db-creds=<s> Percorso del file YAML con credenziali DB.
--daemonize Viene eseguito come daemon (valore predefinito: true).
--debug-node-modules Non memorizzare nella cache in modo aggressivo node_modules nel webpack (impostazione predefinita: false).
--default-mailer-domain=<s> Dominio mittente predefinito.
--default-mailer-fromemail=<s> Indirizzo email di origine delle email di spedizione predefinite (valore predefinito: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome host del mittente predefinito (predefinito: smtp.sendgrid.net).
--default-mailer-password=<s> Password mailer predefinita (la password alla riga di comando non è consigliata).
--default-mailer-port=<i> Porta mailer predefinita (predefinita: 587).
--default-mailer-username=<s> Nome utente del mittente predefinito.
--disable-db-log Disabilita il logging delle query DB interne (predefinito: false).
--dogstatsd-host-ip=<s> IP host del server delle statistiche calcolato da Datadog.
--dogstatsd-host-port=<i> Porta host del server Datadog.
-e, --help Visualizza questo elenco di opzioni di avvio.
--error-emails-to=<s> Email di errore a <email address>.
--experimental-features=<s> Elenco separato da virgole di funzionalità sperimentali consentite.
--experimental-routes=<s> Elenco separato da virgole di route sperimentali consentite che generano route con il suffisso -next.
--extension-load-url=<s> URL per caricare le estensioni in un IFRAME sicuro.
--external-solr-enabled Abilita Solr esterno (a differenza di quello predefinito — Solr incorporato) (predefinito: false).
--force-cdn Forza l'attivazione di CDN (valore predefinito: false).
--force-cipher-key Ignora le protezioni per le impostazioni della chiave di crittografia (solo crittografia precedente, impostazione predefinita: false).
--force-enable-pendo Attiva le guide Pendo nelle istanze con etichetta privata o nei contesti di incorporamento (impostazione predefinita: false).
--force-error-emails Forza Looker a segnalare gli errori via email (impostazione predefinita: false).
--force-gcm-encryption OBSOLETO (questa opzione non è più necessaria).
--force-mismatched-internal-db Consente l'utilizzo di un database interno Looker non sincronizzato (predefinito: false).
--force-no-cdn Forza la disattivazione di CDN (impostazione predefinita: false).
--git-hooks-use-local-path Utilizza un percorso locale per la directory git_hooks anziché lo spazio di archiviazione condiviso.
--git-performance-logging Abilita il logging delle prestazioni JGit (valore predefinito: false).
--google-analytics-tracker-id=<s> ID monitoraggio da utilizzare per inviare visualizzazioni di pagina ad altri tracker di Google Analytics.
-h, --hosted Ospitato da Looker.
-H, --hostname=<s> Nome host per la comunicazione nodo-nodo.
--in-memory-cache-size=<i> Dimensioni (in MB) nella cache di memoria (valore predefinito: 200).
--integration-proxy-cert=<s> Percorso del file del certificato PKI di Proxy di integrazione.
--integration-proxy-key=<s> Percorso del file della chiave PKI del proxy di integrazione.
--internal-analytics-connection-file=<s> File YAML che descrive la connessione di analisi interna che ospita i dati per il modello system__activity. Questa opzione deve essere utilizzata solo con un database di backend di replica di lettura.
--internal-analytics-connection-pool-size=<i> Il numero di connessioni DB simultanee che possono eseguire le query del modello di attività del sistema. Questa opzione deve essere utilizzata solo con un database di backend di replica di lettura.
--internal-analytics-retention-days=<i> Il numero di giorni per cui conservare i dati della cronologia nel database interno. Questa operazione non influisce su nessun processo ETL. Il valore predefinito è 90. Questa opzione deve essere utilizzata solo con un database di backend di replica di lettura.
--k8s-deployment-api-s3bucket-url=<s> URL in cui questo processo Looker può scrivere le credenziali del bucket S3 in modo che vengano mantenute come secret di Kubernetes.
--log-format=<s> Formato di log che è uno di text, json.
--log-level=<s> Livello di log (predefinito: info).
--log-to-file Invia l'output del log al file di log di Looker (impostazione predefinita: true).
--lookml-runtime-cache-size=<i> Dimensioni (in MB) della cache di runtime LookML (valore predefinito: 200).
--loose-cipher-key-file Non richiedere 0600 autorizzazioni per il file della chiave di crittografia (solo crittografia precedente, impostazione predefinita: false).
--marketplace=<s> Esecuzione in un'istanza di Looker Marketplace.
--max-async-threads=<i> Numero massimo di thread di query asincroni (predefinito: 200).
--max-configurable-db-connections=<i> Numero massimo di connessioni consentite per una connessione del database del cliente nell'interfaccia utente.
--max-pdt-regen-threads=<i> Numero massimo di thread del rigeneratore PDT.
--max-scheduled-plans=<i> Numero massimo di piani pianificati ricorrenti attivi (predefinito: unlimited).
--max-unstreamed-limit=<i> Consente di impostare il numero massimo di righe che possono essere restituite per tutte le query che non sono in streaming (impostazione predefinita: 100.000).
--min-pdt-regen-threads=<i> Il numero minimo di thread per il rigeneratore PDT.
--monitoring-port=<i> Porta per il monitoraggio dell'hosting (Prometheus, ...) (valore predefinito: 1552).
-n, --node-to-node-port=<i> Porta per la comunicazione nodo-nodo (valore predefinito: 1551).
--new-cipher-key-file=<s> Percorso del file contenente la nuova chiave di crittografia (solo crittografia precedente).
--on-disk-cache-size=<i> Dimensioni (in MB) della cache su disco (valore predefinito: 2000).
-p, --port=<i> Porta su cui eseguire l'esecuzione (valore predefinito: 9999).
--per-user-query-limit=<i> Limita il numero di query simultanee per utente (impostazione predefinita: 15).
--per-user-query-timeout=<i> Durata del timeout per utente in attesa di connessione (valore predefinito: 600).
--prefer-ipv4 preferisci IPv4.
--public-embed-auth-param-file=<s> File del parametro di autenticazione per l'autenticazione pubblica.
--public-host-url=<s> Se la funzionalità licenza public_host_url è attiva, questa opzione consente agli amministratori di specificare un nome host public_host_url in modo che gli URI di callback dell'API Looker Action vengano creati con public_host_url anziché con l'URL host predefinito in Looker. L'input per l'opzione di avvio deve essere https://<my.host.name>, senza barra finale nell'URL. Se utilizzi questo metodo, gli amministratori di Looker devono anche inserire nella lista consentita gli indirizzi IP statici in uscita indicati nella pagina della documentazione Condivisione dei dati tramite un hub azioni.
-q, --queue-broker-port=<i> Porta per il broker della coda (valore predefinito: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervallo massimo di sonno prima che l'API per i sondaggi lunghi verifichi la disponibilità di risultati.
--qm-long-poll-sleep-interval-in-seconds=<i> Intervallo di sonno iniziale prima che l'API per i sondaggi lunghi controlli la disponibilità dei risultati (impostazione predefinita: 30).
--qm-long-poll-timeout-in-seconds=<i> Timeout lato server massimo per l'API del sondaggio lungo prima che torni al client.
--query-manager-max-threads=<i> Numero massimo di thread per Query Manager.
--query-manager-min-threads=<i> I thread minimi vengono conteggiati per Query Manager.
--query-metrics-retention-hours=<i> Il numero di ore in cui i dati query_metrics devono essere conservati nel database interno (il valore predefinito: 336).
--queue-startup-timeout-in-seconds=<i> Il tempo necessario in secondi per consentire la connessione alla coda all'avvio (impostazione predefinita: 180).
--query-task-cleanup-interval-seconds=<i> Intervallo tra i job di pulizia della tabella delle attività delle query (predefinito: 600).
--query-task-persistence-duration-minutes=<i> Tempo dopo il completamento della query per mantenere le righe nella tabella attività della query (valore predefinito: 90).
-r, --root Consente l'esecuzione come root.

Looker non richiede privilegi di root per il normale funzionamento. Per motivi di sicurezza, ti consigliamo di eseguire Looker in un account non root. Utilizza l'opzione per eseguire l'esecuzione come root solo quando richiesto, ad esempio se richiesto da un analista Looker per scopi di risoluzione dei problemi.
--redis-cache-config-file=<s> File con configurazione Redis.
--report-backend-errors, --no-report-backend-errors Segnala errori nel backend (impostazione predefinita: true).
--report-frontend-errors, --no-report-frontend-errors Segnala errori nel frontend (impostazione predefinita: true).
-S, --ssh-tunnel-sidecar-url=<s> L'URL di base utilizzato per la connessione al SSH Tunnel Server Sidecar.
--scheduled-job-attempt-limit=<i> Numero massimo di tentativi job pianificati (il valore predefinito: 10).
--scheduled-job-max-age-days=<i> Età massima di un job programmato prima dell'eliminazione (predefinito: 60).
--scheduler-query-limit=<i> Limita il numero di query pianificate simultanee (impostazione predefinita: 10).
--scheduler-query-timeout=<i> Durata del timeout dello scheduler in attesa della connessione (valore predefinito: 1200).
--scheduler-start-delay=<i> Numero di secondi per ritardare l'avvio dell'esecuzione dell'attività (valore predefinito: 60).
--scheduler-threads=<i> Numero di attività programmate contemporaneamente (impostazione predefinita: 10).
--search-result-comparison Confronta i risultati del servizio di ricerca con i risultati precedenti (valore predefinito: false).
--search-service Attiva il Servizio di ricerca (impostazione predefinita: false).
--search-service-ab-test Attiva il test AB per il servizio di ricerca (valore predefinito: false).
--self-signup Consente a chiunque di creare un account per sé.
--shared-storage-dir=<s> Percorso dello spazio di archiviazione condiviso del file system di rete.
--snowplow-host=<s> Raccoglitore di spazzaneve extra.
--solr-basic-auth=<s> Credenziali di autenticazione di base per le chiamate a Solr (valore predefinito: solr:SolrRocks).
--ssl Usa SSL (impostazione predefinita: true).
--ssl-ca-cert=<s> Deprecato. Usa invece il criterio --ssl-keystore.
--ssl-cert=<s> Deprecato. Usa invece il criterio --ssl-keystore.
--ssl-key=<s> Deprecato. Usa invece il criterio --ssl-keystore.
--ssl-keystore-pass-file=<s> Percorso del file contenente la password ssl-keystore.
--ssl-keystore-pass=<s> Password per il file ssl-keystore.
--ssl-keystore=<s> Percorso del file archivio chiavi per SSL.
--ssl-provided-externally-by=<s> Fornisce la porta host:port per un provider SSL esterno accessibile dal server che esegue Looker. Se non specificato, il server delle app Looker fornisce il protocollo SSL.

Ecco un esempio di proxy SSL davanti a un cluster Looker:

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

Ecco un esempio di un provider SSL sullo stesso host della tua istanza di Looker:

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

Un valore null indica che il server delle app Looker fornisce il protocollo SSL. Se l'istanza di Looker è in esecuzione su un server con accesso limitato alla rete Internet pubblica, dovrai specificare un indirizzo IP sulla rete interna che sia raggiungibile dal server per l'istanza di Looker.
--ssl-provided-externally Deprecato. Usa invece il criterio --ssl-provided-externally-by.
--staging Esegue il server come temporaneo. Questa opzione impedirà alla tua istanza temporanea di inviare report pianificati. Tuttavia, l'istanza temporanea continuerà a eseguire le attività pianificate e invierà email di errore ai proprietari del piano pianificato in caso di problemi.
--staging-override-email=<s> Invia le email su un'istanza temporanea a questo indirizzo anziché alla destinazione normale.
--stereo-data-search-enabled Attiva la funzionalità di ricerca dati stereo (impostazione predefinita: false).
--super-max-query-limit Utilizzo limitato. Consente di impostare il numero massimo di righe che possono essere restituite nei risultati di Esplora o Query, sostituendo il limite predefinito di 5000 righe.
--task-monitor-abandoned-query-in-seconds=<i> Durata trascorso dall'ultimo accesso per considerare un'attività abbandonata.
--task-monitor-query-startup-interval-in-seconds=<i> Durata utilizzata come periodo di tolleranza quando le query iniziano l'esecuzione fino al primo sondaggio lungo. per lasciare più spazio ai chiamanti prima di avviare il sondaggio.
--task-monitor-sleep-interval-in-seconds=<i> L'intervallo di sonno prima del thread di monitoraggio delle attività può controllare se le attività vengono abbandonate.
--unlimited-scheduler-threads=<i> Numero di attività pianificate simultanee. (predefinito: 3).
--use-custom-jdbc-config Indica se utilizzare una configurazione del driver JDBC personalizzata (valore predefinito: false).
--user-db-credentials Utilizzo limitato. Le connessioni possono utilizzare le credenziali per utente (impostazione predefinita: false).
-v, --version Stampa la versione e le uscite.

Formato file delle credenziali

Se hai cambiato il database dell'applicazione in MySQL, ti servirà un file di credenziali denominato looker-db.yml che includa le seguenti impostazioni:

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

Se il database MySQL richiede una connessione SSL, il file looker-db.yml richiede anche quanto segue:

ssl: true

Rendere permanenti le opzioni di avvio

Il metodo preferito per rendere permanenti le impostazioni di configurazione dell'avvio è creare un file denominato lookerstart.cfg nella directory dell'applicazione Looker. Questo file verrà eseguito dallo script di avvio di Looker fornito con looker.jar. Il file lookerstart.cfg è la posizione consigliata per impostare le variabili di ambiente per JAVAARGS e LOOKERARGS perché non verranno sovrascritte quando sono installate nuove versioni dello script di avvio di Looker.

Ecco un esempio di lookerstart.cfg, che disabilita il protocollo SSL di Looker e lo imposta per essere eseguito sulla porta 8080:

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

Dopo aver apportato le modifiche a lookerstart.cfg sarà necessario riavviare Looker.

Passaggi successivi

Dopo aver configurato le opzioni di avvio di Looker, puoi configurare il certificato SSL per il corretto protocollo HTTPS.