Opzioni di avvio di Looker

Esistono diverse impostazioni di avvio di Looker che possono essere configurate facoltativamente sulle 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 solo se applichi le migrazioni separatamente (impostazione predefinita: true).
--async-results-cache-time=<i> Durata di memorizzazione nella cache dei 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 (impostazione predefinita: 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 Abilita la traccia 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> Il tasso (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 del rendering simultanei (valore predefinito: 3).
--concurrent-render-jobs=<i> Numero di processi di rendering simultanei di PhantomJS o Chromium (impostazione predefinita: 2).
--core-on-loopback Espone l'API principale sull'interfaccia di loopback (impostazione predefinita: false).
--core-port=<i> Porta su cui eseguire il core (valore predefinito: 19999).
--customer-artifact-maxsize=<i> Dimensioni massime in MB dell'archivio degli artefatti del cliente.
-d, --internal-db-creds=<s> Percorso del file YAML con le credenziali del database.
--daemonize Viene eseguito come daemon (impostazione predefinita: true).
--default-mailer-domain=<s> Dominio mittente predefinito.
--default-mailer-fromemail=<s> Indirizzo email da cui provengono le email del programma di posta predefinito (impostazione predefinita: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Nome host del mailer predefinito (valore predefinito: smtp.sendgrid.net).
--default-mailer-password=<s> Password del programma di posta predefinito (la password sulla riga di comando non è consigliata).
--default-mailer-port=<i> Porta del programma di posta predefinito (valore predefinito: 587).
--default-mailer-username=<s> Nome utente del programma di posta predefinito.
--disable-db-log Disattiva il logging delle query del database interno (impostazione predefinita: false).
--dogstatsd-host-ip=<s> IP host server statsd di Datadog.
--dogstatsd-host-port=<i> Porta host del server Datadog.
-e, --help Visualizza questo elenco di opzioni di avvio.
--enable-blobstore-recryption Abilita la ricriptazione permanente di Blobstore nelle operazioni di riassegnazione delle chiavi (impostazione predefinita: false).
--error-emails-to=<s> Email di errore a <email address>.
--experimental-features=<s> Elenco separato da virgole delle 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 protetto.
--external-solr-enabled Attiva Solr esterno (anziché quello predefinito, ovvero Solr incorporato) (impostazione predefinita: false).
--fips Abilita crittografia FIPS-140 (impostazione predefinita: false).
--force-cdn Forza l'attivazione della CDN (impostazione predefinita: false).
--force-cipher-key Ignora le misure di protezione per le impostazioni della chiave di crittografia (solo crittografia legacy, valore predefinito: false).
--force-enable-pendo Attiva le guide Pendo nelle istanze private label 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 DEPRECATO (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 Disabilita forzatamente la 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 Attiva il logging delle prestazioni di JGit (impostazione predefinita: false).
--google-analytics-tracker-id=<s> ID monitoraggio da utilizzare per inviare visualizzazioni di pagina a tracker Google Analytics aggiuntivi.
-h, --hosted Ospitato da Looker.
-H, --hostname=<s> Nome host per la comunicazione da nodo a nodo.
--hosted-action-hub-disabled Disattiva l'hub delle azioni ospitate.
--in-memory-cache-size=<i> Dimensione (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 è da utilizzare solo con un database di backend di replica di lettura.
--internal-analytics-connection-pool-size=<i> Il numero di connessioni simultanee al database che possono eseguire query del modello di attività di sistema. Questa opzione è da utilizzare solo con un database di backend di replica di lettura.
--internal-analytics-retention-days=<i> Il numero di giorni per conservare i dati della cronologia nel database interno. Questa operazione non influisce su alcun processo ETL. Il valore predefinito è 90. Questa opzione è da utilizzare 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 da rendere persistenti come secret Kubernetes.
--log-format=<s> Formato log text o json (impostazione predefinita: text).
--log-level=<s> Livello di log (valore predefinito: info).
--log-to-file Invia l'output del log al file di log di Looker (impostazione predefinita: true).
--lookml-runtime-cache-size=<i> Dimensione (in MB) della cache del runtime di LookML (valore predefinito: 200).
--loose-cipher-key-file Non richiedere le autorizzazioni 0600 per il file della chiave di crittografia (solo crittografia legacy, valore predefinito: 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 DB cliente nella UI.
--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 delle PDT.
--max-scheduled-plans=<i> Numero massimo di piani pianificati ricorrenti attivi (valore predefinito: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag per distribuire le esecuzioni della pianificazione in modo casuale nel numero di secondi specificato.
--max-unstreamed-limit=<i> Imposta il numero massimo di righe che possono essere restituite per tutte le query che non sono trasmesse 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, ...) (impostazione predefinita: 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 (valore predefinito: 2000).
-p, --port=<i> Porta su cui eseguire (impostazione predefinita: 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 l'attesa della connessione (impostazione predefinita: 600).
--prefer-ipv4 Preferenza per IPv4.
--public-embed-auth-param-file=<s> File dei parametri di autenticazione per l'autenticazione pubblica.
--public-host-url=<s> Se la funzionalità di licenza public_host_url è abilitata, 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 di uscita elencati nella pagina della documentazione Condivisione di dati tramite un hub delle azioni.
-q, --queue-broker-port=<i> Porta per il broker di code (valore predefinito: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Intervallo di sospensione massimo prima che l'API Long Polling verifichi se sono disponibili risultati (impostazione predefinita: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Intervallo di sospensione iniziale prima che l'API Long Polling verifichi se sono disponibili risultati (valore predefinito: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Timeout massimo lato server per l'API Long Polling prima che venga restituita 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 query_metrics nel database interno (valore predefinito: 336).
--queue-startup-timeout-in-seconds=<i> Per quanti secondi 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> Quantità 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 di 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 di Redis.
--report-backend-errors, --no-report-backend-errors Segnala errori dal backend (valore predefinito: false).
--report-frontend-errors, --no-report-frontend-errors Segnala gli errori del frontend (impostazione predefinita: false). NOTA: questa opzione di avvio è obsoleta. Utilizza invece il flag funzionalità client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> L'URL di base utilizzato per connettersi al sidecar del server tunnel SSH.
--scheduled-job-attempt-limit=<i> Numero massimo di tentativi di job pianificati (valore predefinito: 10).
--scheduled-job-max-age-days=<i> Età massima di un job pianificato prima che venga eliminato (impostazione predefinita: 60).
--scheduler-query-limit=<i> Limita il numero di query pianificate simultanee (valore predefinito: 10).
--scheduler-query-timeout=<i> Durata del timeout dello scheduler per l'attesa della connessione (valore predefinito: 1200).
--scheduler-start-delay=<i> Numero di secondi di ritardo prima dell'avvio dell'esecutore dell'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 (impostazione predefinita: false).
--search-service Attiva il servizio di ricerca (impostazione predefinita: false).
--search-service-ab-test Attiva il test A/B 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> Collector Snowplow 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. 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 di 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 host:porta per un provider SSL esterno accessibile dal server che esegue Looker. Se non specificato, il server delle app Looker fornisce 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 dell'istanza di Looker:

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

Un valore nullo indica che il server dell'app Looker fornisce SSL. Se la tua istanza di Looker è in esecuzione su un server con accesso limitato a internet pubblico, devi specificare un indirizzo IP sulla tua rete interna raggiungibile dal server per la tua istanza di Looker.
--ssl-provided-externally Deprecato. Utilizza invece --ssl-provided-externally-by.
--staging Esegue il server come staging. Questa opzione impedirà 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 dei piani pianificati se l'attività pianificata presenta problemi.
--staging-override-email=<s> Invia 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 (impostazione predefinita: false).
--studio-load-url=<s> L'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 dall'inizio dell'esecuzione delle query fino alla prima richiesta di attesa prolungata. In questo modo, i chiamanti hanno più tempo a disposizione prima dell'inizio del 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.
--unification-jwt-service-account=<s> Account di servizio JWT di unificazione.
--unlimited-scheduler-threads=<i> Numero di attività pianificate simultanee illimitate (impostazione predefinita: 3).
--use-custom-jdbc-config Indica se utilizzare la configurazione del driver JDBC personalizzato (impostazione predefinita: false).
--user-db-credentials Utilizzo limitato. Le connessioni possono utilizzare le credenziali per utente (impostazione predefinita: false).
-v, --version Stampa la versione ed esce.

Formato del file delle credenziali

Se hai modificato il database dell'applicazione in MySQL, ti servirà 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 di 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 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, Looker dovrà essere riavviato.

Passaggi successivi

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