Opzioni di avvio di Looker

Esistono diverse impostazioni di avvio di Looker che, facoltativamente, possono essere configurate nelle istanze ospitate dal cliente. Se non devi modificare queste opzioni, puoi avviare Looker senza.

Elenco delle opzioni di avvio

La seguente tabella fornisce un 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. Utilizza invece --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 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 Puma Application Server.
--apply-db-migrations Applica le migrazioni dei database all'avvio. Disattivala solo se applichi le migrazioni separatamente (impostazione predefinita: true).
--async-results-cache-time=<i> Durata per cui mantenere memorizzati nella cache i risultati asincroni (valore predefinito: 300).
--cdn-hosts=<s> Nomi host separati da virgole per il pool 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 (impostazione predefinita: 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 su cui caricare i dati di traccia.
--cloud-trace-sample-rate=<f> La frequenza (0-1) con cui campionare le tracce (valore predefinito: 0,0).
--clustered Indica se questo server fa parte di un cluster (valore predefinito: false).
--concurrent-render-caching-jobs=<i> Numero di processi di memorizzazione nella cache di rendering simultanei (valore predefinito: 3).
--concurrent-render-jobs=<i> Numero di processi di rendering PhantomJS o Chromium simultanei (valore predefinito: 2).
--core-on-loopback Espone l'API Core nell'interfaccia di loopback (valore predefinito: false).
--core-port=<i> Porta su cui eseguire il core (valore predefinito: 19999).
--customer-artifact-maxsize=<i> Dimensioni massime in MB dello spazio di archiviazione degli elementi del cliente.
-d, --internal-db-creds=<s> Percorso del file YAML con credenziali DB.
--daemonize Viene eseguito come daemon (valore predefinito: true).
--default-mailer-domain=<s> Dominio mailer predefinito.
--default-mailer-fromemail=<s> Indirizzo email da cui provengono le email del programma di invio email predefinito (valore predefinito: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome host predefinito del mailer (valore predefinito: smtp.sendgrid.net).
--default-mailer-password=<s> Password predefinita del mailer (password non consigliata sulla riga di comando).
--default-mailer-port=<i> Porta di posta predefinita (impostazione predefinita: 587).
--default-mailer-username=<s> Nome utente del programma di posta predefinito.
--disable-db-log Disattiva il logging delle query del database interno (valore predefinito: false).
--dogstatsd-host-ip=<s> IP host del server Statistiched Datadog.
--dogstatsd-host-port=<i> Porta host del server Datadog.
-e, --help Viene visualizzato questo elenco di opzioni di avvio.
--enable-blobstore-recryption Attiva la ricodificazione di Blobstore persistente nelle operazioni di modifica della chiave (valore predefinito: false).
--error-emails-to=<s> Email di errore inviate a <email address>.
--experimental-features=<s> Elenco separato da virgole delle funzionalità sperimentali consentite.
--experimental-routes=<s> Elenco separato da virgole di route sperimentali consentite che generano route con suffisso -next.
--extension-load-url=<s> URL per caricare le estensioni in un iframe sicuro.
--external-solr-enabled Attiva Solr esterno (anziché Solr incorporato predefinito) (valore predefinito: false).
--fips Abilita la crittografia FIPS-140 (valore predefinito: false).
--force-cdn Abilita forzatamente CDN (impostazione predefinita: false).
--force-cipher-key Ignora le salvaguardie per le impostazioni delle chiavi di crittografia (solo crittografia precedente, impostazione predefinita: false).
--force-enable-pendo Attiva le guide di Pendo nelle istanze private label o nei contesti di incorporamento (valore predefinito: false).
--force-error-emails Forza Looker a segnalare gli errori via email (valore predefinito: false).
--force-gcm-encryption OBSOLETO (questa opzione non è più necessaria).
--force-mismatched-internal-db Consente l'utilizzo del DB interno di Looker non sincronizzato (valore predefinito: false).
--force-no-cdn Disattiva forzatamente la CDN (valore predefinito: 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 (impostazione predefinita: false).
--google-analytics-tracker-id=<s> ID monitoraggio da utilizzare per inviare le visualizzazioni di pagina ad altri tracker di Google Analytics.
-h, --hosted Ospitato da Looker.
-H, --hostname=<s> Nome host per la comunicazione da nodo a nodo.
--hosted-action-hub-disabled Disattiva l'hub azioni ospitato.
--in-memory-cache-size=<i> Dimensioni (in MB) della cache in memoria (valore predefinito: 200).
--integration-proxy-cert=<s> Percorso del file del certificato PKI del 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 backend della replica di lettura.
--internal-analytics-connection-pool-size=<i> Il numero di connessioni DB simultanee che possono eseguire query sul modello di attività di sistema. Questa opzione deve essere utilizzata solo con un database backend della replica di lettura.
--internal-analytics-retention-days=<i> Il numero di giorni per conservare i dati storici nel database interno. Ciò non influisce su alcun processo ETL. Il valore predefinito è 90. Questa opzione deve essere utilizzata solo con un database backend della replica di lettura.
--k8s-deployment-api-s3bucket-url=<s> URL in cui questo processo Looker può scrivere credenziali del bucket S3 da rendere persistenti come secret di Kubernetes.
--log-format=<s> Formato del log: text o json (valore predefinito: text).
--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 le autorizzazioni 0600 per il file di 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 asincrone (valore predefinito: 200).
--max-configurable-db-connections=<i> Numero massimo di connessioni consentite per una connessione al database del cliente nell'interfaccia utente.
--max-db-connections-records=<i> Numero massimo di record di connessione consentiti nella tabella db_connection (valore predefinito: 10.000).
--max-pdt-regen-threads=<i> Numero massimo di thread di rigenerazione del PDT.
--max-scheduled-plans=<i> Numero massimo di piani pianificati ricorrenti attivi (valore predefinito: unlimited).
--max-scheduler-jitter-in-seconds=<i> Indica che la pianificazione della sfocatura viene eseguita in modo casuale per il numero di secondi specificato.
--max-unstreamed-limit=<i> Imposta il numero massimo di righe che possono essere restituite per tutte le query non in streaming (valore predefinito: 100.000).
--min-pdt-regen-threads=<i> Numero minimo di thread per PDT Regenerator.
--monitoring-port=<i> Porta per l'hosting del monitoraggio (Prometheus e così via) (valore predefinito: 1552).
-n, --node-to-node-port=<i> Porta per la comunicazione da nodo a 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 (impostazione predefinita: 2000).
-p, --port=<i> Porta su cui eseguire il servizio (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 per attendere la connessione (valore predefinito: 600).
--prefer-ipv4 Preferenza per IPv4.
--public-embed-auth-param-file=<s> File del parametro di autenticazione per l'autenticazione pubblica.
--public-host-url=<s> Se la funzionalità della licenza public_host_url è attivata, 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 costruiti 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 utilizzano questo metodo, gli amministratori di Looker devono anche inserire nella lista consentita gli indirizzi IP in uscita statici elencati nella pagina della documentazione Condivisione di dati tramite un hub azioni.
-q, --queue-broker-port=<i> Porta per il broker coda (valore predefinito: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervallo di sospensione massimo prima che l'API long poll controlli se sono disponibili risultati (valore predefinito: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervallo di sospensione iniziale prima che l'API long poll controlli se sono disponibili risultati (valore predefinito: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Timeout massimo lato server per l'API long poll prima del ritorno al client (valore predefinito: 30).
--query-manager-max-threads=<i> Numero massimo di thread per Query Manager.
--query-manager-min-threads=<i> Numero minimo di thread per Query Manager.
--query-metrics-retention-hours=<i> Il numero di ore per conservare i dati di query_metrics nel database interno (valore predefinito: 336).
--queue-startup-timeout-in-seconds=<i> Tempo in secondi per consentire la connessione alla coda all'avvio (valore predefinito: 180).
--query-task-cleanup-interval-seconds=<i> Intervallo tra i job di pulizia delle tabelle delle attività di query (valore predefinito: 600).
--query-task-persistence-duration-minutes=<i> Intervallo di tempo dopo il completamento della query per conservare le righe nella tabella delle attività di query (valore predefinito: 360).
-r, --root Consente l'esecuzione come root.

Looker non richiede privilegi root per il normale funzionamento. Per motivi di sicurezza, ti consigliamo di eseguire Looker in un account non root. Utilizza l'opzione per eseguire come root solo quando necessario, ad esempio se richiesta da un analista di Looker per la risoluzione dei problemi.
--redis-cache-config-file=<s> File contenente la configurazione Redis.
--report-backend-errors, --no-report-backend-errors Segnala gli errori del backend (impostazione predefinita: false).
--report-frontend-errors, --no-report-frontend-errors Segnala gli errori dal frontend (valore predefinito: false). NOTA: questa opzione di avvio è obsoleta. Utilizza invece il flag della funzionalità client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> L'URL di base utilizzato per la connessione all'SSH Tunnel Server Sidecar.
--scheduled-job-attempt-limit=<i> Numero massimo di tentativi di esecuzione del job pianificati (valore predefinito: 10).
--scheduled-job-max-age-days=<i> Durata massima di un job pianificato prima che venga eliminato (valore predefinito: 60).
--scheduler-query-limit=<i> Limita il numero di query pianificate simultanee (impostazione predefinita: 10).
--scheduler-query-timeout=<i> Tempo di attesa del timeout dello scheduler per la connessione (valore predefinito: 1200).
--scheduler-start-delay=<i> Numero di secondi di ritardo nell'avvio dell'esecutore di attività (valore predefinito: 60).
--scheduler-threads=<i> Numero di attività pianificate simultanee (valore predefinito: 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 (valore predefinito: false).
--search-service-ab-test Attiva il test A/B per il servizio di ricerca (valore predefinito: false).
--self-signup Consente a chiunque di creare un account personale.
--shared-storage-dir=<s> Percorso dello spazio di archiviazione condiviso del file system di rete.
--snowplow-host=<s> Raccoglitore spazzaneve aggiuntivo.
--solr-basic-auth=<s> Credenziali di autenticazione di base per le chiamate a Solr (valore predefinito: solr:SolrRocks).
--ssl Utilizza SSL (valore predefinito: true).
--ssl-ca-cert=<s> Deprecato. Usa invece il criterio --ssl-keystore.
--ssl-cert=<s> Deprecato. Utilizza invece --ssl-keystore.
--ssl-key=<s> Deprecato. Utilizza invece --ssl-keystore.
--ssl-keystore-pass-file=<s> Percorso del file contenente ssl-keystore password.
--ssl-keystore-pass=<s> Password per ssl-keystore file.
--ssl-keystore=<s> Percorso del file dell'archivio chiavi per SSL.
--ssl-provided-externally-by=<s> Fornisce l'host:port per un provider SSL esterno accessibile dal server su cui è in esecuzione Looker. Se non specificato, il server dell'app Looker fornisce SSL.

Ecco un esempio di proxy SSL per un cluster Looker:

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

Ecco un esempio di provider SSL sullo stesso host dell'istanza di Looker:

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

Un valore nullo indica che il server dell'app Looker fornisce 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 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 staging. Questa opzione impedirà all'istanza di gestione temporanea di inviare report pianificati. Tuttavia, l'istanza di gestione temporanea continuerà a eseguire le attività pianificate e invierà le email di errore ai proprietari del piano in caso di problemi con l'attività pianificata.
--staging-override-email=<s> Invia le email su un'istanza di staging a questo indirizzo anziché alla destinazione normale.
--stereo-data-search-enabled Consente di attivare la funzionalità di ricerca dei dati stereo (impostazione predefinita: false).
--task-monitor-abandoned-query-in-seconds=<i> Tempo trascorso dall'ultimo accesso a un'attività per considerare l'attività di query abbandonata.
--task-monitor-query-startup-interval-in-seconds=<i> Durata utilizzata come periodo di tolleranza quando viene avviata l'esecuzione delle query fino al primo sondaggio lungo. Consente di dare più spazio agli utenti che chiamano prima di iniziare il sondaggio.
--task-monitor-sleep-interval-in-seconds=<i> Intervallo di sospensione prima che il thread di monitoraggio delle attività possa verificare se le attività sono state abbandonate.
--unlimited-scheduler-threads=<i> Numero di attività pianificate illimitate simultanee (valore predefinito: 3).
--use-custom-jdbc-config Indica se utilizzare la configurazione del driver JDBC personalizzato (valore predefinito: false).
--user-db-credentials Utilizzo limitato. Le connessioni possono utilizzare credenziali per utente (valore predefinito: false).
-v, --version Stampa la versione ed esce.

Formato file delle credenziali

Se hai modificato il database dell'applicazione in MySQL, devi avere un file delle credenziali denominato looker-db.yml che includa queste impostazioni:

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

Se il tuo 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 all'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 vengono installate nuove versioni dello script di avvio di Looker.

Ecco un esempio di lookerstart.cfg, che disabilita SSL di Looker e lo imposta per l'esecuzione sulla porta 8080:

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

Dopo aver apportato modifiche a lookerstart.cfg, devi riavviare Looker.

Passaggi successivi

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