Opzioni di avvio di Looker

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

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 Ritirato. Usa invece il criterio --marketplace=aws.
--api-server-max-threads=<i> Numero massimo di thread per 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 server di 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> Periodo di tempo per conservare i risultati asincroni nella cache (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 legacy).
--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 in 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 (impostazione predefinita: false).
--concurrent-render-caching-jobs=<i> Numero di processi di memorizzazione nella cache di rendering simultanei (impostazione predefinita: 3).
--concurrent-render-jobs=<i> Numero di processi di rendering PhantomJS o Chromium simultanei (impostazione predefinita: 2).
--content-repo-enabled La funzionalità repository di contenuti è attivata (impostazione predefinita: false).
--core-on-loopback Espone l'API Core nell'interfaccia di loopback (valore predefinito: false).
--core-port=<i> Porta su cui eseguire il core (impostazione predefinita: 19999).
--customer-artifact-maxsize=<i> Dimensione massima in MB dell'archivio degli artefatti del cliente.
-d, --internal-db-creds=<s> Percorso del file YAML con credenziali DB.
--daemonize Esecuzione come daemon (valore predefinito: true).
--default-mailer-domain=<s> Dominio mailer predefinito.
--default-mailer-fromemail=<s> Indirizzo email da cui provengono le email predefinite del servizio postale (impostazione predefinita: 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 (la password sulla riga di comando non è consigliata).
--default-mailer-port=<i> Porta di posta predefinita (impostazione predefinita: 587).
--default-mailer-username=<s> Nome utente predefinito del mailer.
--disable-db-log Disabilita la registrazione delle query database interne (impostazione predefinita: false).
--dogstatsd-host-ip=<s> IP host del server Statistiched Datadog.
--dogstatsd-host-port=<i> Porta host del server Datadog.
-e, --help Visualizza questo elenco di opzioni di avvio.
--enable-blobstore-recryption Abilita la ricrittografia dell'archivio BLOB permanente per le operazioni di richiave (impostazione predefinita: 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 il Solr esterno (anziché quello predefinito, ovvero il Solr incorporato) (valore predefinito: false).
--fips Attiva la crittografia FIPS-140 (impostazione predefinita: false).
--force-cdn Abilita forzatamente CDN (impostazione predefinita: false).
--force-cipher-key Ignora le salvaguardie per le impostazioni della chiave di crittografia (solo crittografia precedente, impostazione predefinita: false).
--force-enable-pendo Abilita le guide di Pendo sulle istanze di etichette private o in contesti di incorporamento (valore predefinito: 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 del database interno di Looker non sincronizzato (impostazione predefinita: false).
--force-no-cdn Disattiva forzatamente CDN (impostazione predefinita: false).
--git-hooks-use-local-path Usa un percorso locale per la directory git_hooks anziché uno 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 (impostazione predefinita: 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 in cui i dati storici devono essere conservati nel database interno. Questo non influisce sui processi 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 di 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 consentito 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 del rigeneratore PDT.
--max-scheduled-plans=<i> Numero massimo di piani pianificati ricorrenti attivi (valore predefinito: unlimited).
--max-scheduler-jitter-in-seconds=<i> La pianificazione delle segnalazioni da distribuire 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 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 da nodo a nodo (valore predefinito: 1551).
--new-cipher-key-file=<s> Percorso del file contenente la nuova chiave di crittografia (solo crittografia legacy).
--on-disk-cache-size=<i> Dimensioni (in MB) della cache su disco (impostazione predefinita: 2000).
-p, --port=<i> Porta su cui eseguire l'esecuzione (impostazione predefinita: 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 di attesa della connessione (valore predefinito: 600).
--prefer-ipv4 Preferisci IPv4.
--public-embed-auth-param-file=<s> File dei parametri di autenticazione per l'autenticazione pubblica.
--public-host-url=<s> Se la funzionalità della licenza public_host_url è abilitata, questa opzione consente agli amministratori di specificare un nome host public_host_url in modo che gli URI del callback dell'API Looker Action vengano creati con il public_host_url anziché con l'URL dell'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 sonno massimo prima che l'API long poll controllerà se sono disponibili risultati (impostazione predefinita: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervallo di sonno iniziale prima che l'API poll lungo controlli se sono disponibili risultati (valore predefinito: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Timeout lato server massimo per l'API long poll prima che ritorni 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 della tabella 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 l'esecuzione come root solo quando necessario, ad esempio se richiesto 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. Usa il flag 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 dell'eliminazione (valore 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 durante l'attesa della connessione (valore predefinito: 1200).
--scheduler-start-delay=<i> Numero di secondi per ritardare l'avvio del runner dell'attività (valore predefinito: 60).
--scheduler-threads=<i> Numero di attività pianificate simultanee (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 (impostazione predefinita: 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> Ritirato. Usa invece il criterio --ssl-keystore.
--ssl-cert=<s> Ritirato. Usa invece il criterio --ssl-keystore.
--ssl-key=<s> Ritirato. Usa invece il criterio --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 il valore host:port per un provider SSL esterno, come accessibile dal server che esegue Looker. Se non specificato, il server dell'app di Looker fornisce il protocollo 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 della tua istanza Looker:

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

Un valore nullo indica che il server dell'app di 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 raggiungibile dal server per l'istanza di Looker.
--ssl-provided-externally Ritirato. Usa invece il criterio --ssl-provided-externally-by.
--staging Esegue il server come gestione temporanea. 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 temporanea a questo indirizzo anziché alla normale destinazione.
--stereo-data-search-enabled Consente di attivare la funzionalità di ricerca dei dati stereo (impostazione predefinita: false).
--studio-load-url=<s> URL per caricare Looker Studio in un iframe.
--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 lasciare più spazio ai chiamanti prima di iniziare i sondaggi.
--task-monitor-sleep-interval-in-seconds=<i> Intervallo di sonno prima che il thread di monitoraggio delle attività possa controllare se le attività vengono abbandonate.
--unlimited-scheduler-threads=<i> Numero di attività pianificate illimitate simultanee (impostazione predefinita: 3).
--use-custom-jdbc-config Indica se utilizzare la configurazione del driver JDBC personalizzata (impostazione predefinita: false).
--user-db-credentials Utilizzo limitato. Le connessioni possono utilizzare credenziali per utente (valore predefinito: false).
-v, --version Stampa la versione e chiude il processo.

Formato file delle credenziali

Se hai impostato il database dell'applicazione su MySQL, avrai bisogno di 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 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 migliore per rendere permanenti le impostazioni di configurazione all'avvio consiste nel 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"

Looker dovrà essere riavviato dopo aver apportato modifiche a lookerstart.cfg.

Passaggi successivi

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