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 tabella seguente 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 (valore predefinito: 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 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 del database all'avvio. Disattiva questa opzione solo se applichi le migrazioni separatamente (valore predefinito: true).
--async-results-cache-time=<i>	Durata per cui mantenere memorizzati nella cache i risultati asincroni (valore predefinito: 300).
--byoid-studio-load-url=<s>	URL per caricare BYOID Studio in un iframe.
--cdn-hosts=<s>	Nomi host separati da virgola 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 monitoraggio 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 dei tracciati in Google Cloud Trace.
--cloud-trace-project-id=<s>	L'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 di base sull'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 dell'archivio di artefatti del cliente.
-d, --internal-db-creds=<s>	Percorso del file YAML con le credenziali del database.
--daemonize	Viene eseguito come daemon (valore predefinito: true).
--default-mailer-domain=<s>	Dominio del servizio di posta predefinito.
--default-mailer-fromemail=<s>	Indirizzo email da cui provengono le email del programma di invio email predefinito (valore predefinito: Looker <[e-mail]>).
--default-mailer-host=<s>	Nome host del client di posta predefinito (valore predefinito: smtp.sendgrid.net).
--default-mailer-password=<s>	Password predefinita del client di posta (password non consigliata sulla riga di comando).
--default-mailer-port=<i>	Porta del client di posta predefinita (valore predefinito: 587).
--default-mailer-username=<s>	Nome utente predefinito del client di posta.
--disable-db-log	Disattiva il logging delle query del database interno (valore predefinito: false).
--dogstatsd-host-ip=<s>	IP host del server statsd di 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 a <email address>.
--experimental-features=<s>	Elenco separato da virgole di funzionalità sperimentali consentite.
--experimental-routes=<s>	Elenco separato da virgole di percorsi sperimentali consentiti che generano percorsi con il 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 la CDN (valore predefinito: false).
--force-cipher-key	Ignora le salvaguardie per le impostazioni della chiave di crittografia (solo crittografia precedente, predefinito: 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	DEPRATO (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	Consente di attivare il logging delle prestazioni di JGit (valore predefinito: false).
--google-analytics-tracker-id=<s>	L'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 di azioni ospitato.
--in-memory-cache-size=<i>	Dimensioni (in MB) della cache in memoria (valore predefinito: 200).
--integration-proxy-cert=<s>	Percorso del file della certificazione 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 è da utilizzare solo con un database di backend della replica di lettura.
--internal-analytics-connection-pool-size=<i>	Il numero di connessioni simultanee al database che possono eseguire query sul modello di attività di sistema. Questa opzione è da utilizzare solo con un database di 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 è da utilizzare solo con un database di backend della replica di lettura.
--k8s-deployment-api-s3bucket-url=<s>	URL in cui questo processo Looker può scrivere le credenziali del bucket S3 da mantenere come secret di Kubernetes.
--log-format=<s>	Formato del log text o json (valore predefinito: text).
--log-level=<s>	Livello di log (valore predefinito: info).
--log-to-file	Invia l'output del log al file di log di Looker (valore predefinito: true).
--lookml-runtime-cache-size=<i>	Dimensioni (in MB) della cache di runtime di LookML (valore predefinito: 200).
--loose-cipher-key-file	Non richiedere autorizzazioni 0600 per il file della chiave di crittografia (solo crittografia legacy, predefinito: false).
--marketplace=<s>	In 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: 10000).
--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 tra nodi (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 il servizio (valore predefinito: 9999).
--per-user-query-limit=<i>	Limita il numero di query simultanee per utente (valore predefinito: 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 utilizzi questo metodo, gli amministratori di Looker devono anche inserire nella lista consentita gli indirizzi IP di uscita statici elencati nella pagina della documentazione sulla condivisione di dati tramite un hub delle azioni.
-q, --queue-broker-port=<i>	Porta per il broker di 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>	Il 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>	Tempo dopo il completamento della query per mantenere le righe nella tabella delle attività di query (valore predefinito: 360).
-r, --root	Consente l'esecuzione come utente 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 di esecuzione come utente 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 di Redis.
--report-backend-errors, --no-report-backend-errors	Segnala gli errori dal backend (valore predefinito: 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 funzionalità client_monitor.
-S, --ssh-tunnel-sidecar-url=<s>	L'URL base utilizzato per connettersi al server sidecar del tunnel SSH.
--scheduled-job-attempt-limit=<i>	Numero massimo di tentativi di 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 in parallelo (valore predefinito: 10).
--scheduler-query-timeout=<i>	Durata del timeout del programmatore per attendere 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 allo spazio di archiviazione condiviso del file system di rete.
--snowplow-host=<s>	Un altro collector Snowplow.
--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. Utilizza invece --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 la password ssl-keystore.
--ssl-keystore-pass=<s>	Password per il file ssl-keystore.
--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. Di seguito è riportato un esempio di proxy SSL davanti a 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, devi specificare un indirizzo IP sulla rete interna raggiungibile dal server per l'istanza di Looker.
--ssl-provided-externally	Deprecato. Utilizza invece --ssl-provided-externally-by.
--staging	Esegue il server come staging. Questa opzione impedisce all'istanza di staging di inviare report pianificati. Tuttavia, l'istanza di staging continuerà a eseguire le attività pianificate e invierà email di errore ai proprietari del piano pianificato 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	Attiva la funzionalità di ricerca dei dati stereo (valore predefinito: false).
--studio-load-url=<s>	URL per caricare Studio in un iframe.
--studio-one-platform-endpoint=<s>	Endpoint per l'API Studio One Platform.
--task-monitor-abandoned-query-in-seconds=<i>	Durata trascorsa dall'ultimo accesso per un'attività per considerare l'attività di query abbandonata.
--task-monitor-query-startup-interval-in-seconds=<i>	Durata utilizzata come periodo di tolleranza quando le query iniziano a essere eseguite fino al primo polling 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 del 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 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 è il luogo consigliato 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 file lookerstart.cfg, che disattiva SSL di Looker e lo imposta per l'esecuzione sulla porta 8080:

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

Dopo aver apportato modifiche a lookerstart.cfg, è necessario riavviare Looker.

Passaggi successivi

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