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.