Opzioni di avvio di Looker

Esistono diverse impostazioni di avvio di Looker che possono essere configurate facoltativamente 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 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	Attiva la tracciabilità utilizzando le credenziali predefinite o le credenziali JSON se fornite utilizzando --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 (valore predefinito: 2).
--core-on-loopback	Espone l'API principale sull'interfaccia di loopback (impostazione predefinita: false).
--core-port=<i>	Porta su cui eseguire il core (impostazione predefinita: 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).
--db-migrations-kill-timeout=<i>	Timeout di interruzione per le migrazioni del database in secondi (valore predefinito: 480).
--db-migrations-lock-wait-timeout=<i>	Timeout di attesa del blocco per le migrazioni del database in secondi (impostazione predefinita: 180).
--db-migrations-monitor-cutoff=<i>	Tempo limite per il monitoraggio delle migrazioni di database interni in secondi (valore predefinito: 2592000).
--db-migrations-wait-timeout=<i>	Timeout di attesa per le migrazioni del database in secondi (impostazione predefinita: 720).
--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 <[e-mail]>).
--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 mailer predefinita (valore predefinito: 587).
--default-mailer-username=<s>	Nome utente del programma di posta predefinito.
--disable-db-log	Disabilita 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	Visualizza questo elenco di opzioni di avvio.
--enable-blobstore-recryption	Abilita la ricriptazione persistente di Blobstore nelle operazioni di cambio chiave (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 route sperimentali consentite che generano route 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 con etichetta privata o nei contesti di incorporamento (impostazione predefinita: false).
--force-error-emails	Forza Looker a segnalare gli errori tramite 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 la registrazione 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 ospitato.
--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. Ciò 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.
--load-chronicle-dialect	Indica se caricare il dialetto integrato di Chronicle (impostazione predefinita: false).
--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 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 del rigeneratore di PDT.
--max-scheduled-plans=<i>	Numero massimo di piani programmati 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>	Dimensione (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, per connessione, per nodo nell'istanza Looker (valore predefinito: 15). Per una connessione, se viene fornito un valore per l'impostazione Numero massimo di query contemporanee per utente per questa connessione, questo valore sostituirà per-user-query-limit per la connessione. Tieni presente che l'impostazione Numero massimo di query contemporanee per utente per questa connessione è per utente e per connessione, ma non per nodo. Per ulteriori informazioni, consulta la pagina della documentazione Connessione di Looker al tuo database.
--per-user-query-timeout=<i>	Durata del timeout per utente da attendere per la connessione (valore predefinito: 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:// 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 di documentazione Condivisione dei 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 di long polling verifichi se sono disponibili risultati (valore predefinito: 0,1).
--qm-long-poll-timeout-in-seconds=<i>	Timeout lato server massimo 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.
--regionalised-prod-byoid-studio-load-url=<s>	URL di produzione con segnaposto della regione per caricare BYOID Studio in un iframe.
--regionalised-prod-studio-load-url=<s>	URL di produzione con segnaposto della regione per caricare Studio.
--regionalised-prod-studio-one-platform-endpoint=<s>	Endpoint di produzione con segnaposto della regione per l'API Studio One Platform.
--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 legacy (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 l'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 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 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 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 polling lungo. In questo modo, i chiamanti hanno più tempo per prepararsi 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, avrai bisogno di 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"

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 HTTPS.