Opzioni di avvio di Looker

Esistono diverse impostazioni di avvio di Looker che possono essere configurate facoltativamente nelle istanze ospitate dal cliente. Se non hai bisogno di modificare queste opzioni, puoi avviare Looker senza di esse.

Elenco delle opzioni di avvio

La tabella seguente fornisce un elenco delle opzioni di avvio attuali 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. Usa invece il descrittore --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 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 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	Abilita il tracciamento utilizzando le credenziali predefinite o le credenziali JSON, se fornite utilizzando --cloud-trace-json-file (valore predefinito: false).
--cloud-trace-json-file=<s>	File JSON contenente le credenziali del account di servizio per caricare i dati di traccia su 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 (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 principale sull'interfaccia di loopback (impostazione predefinita: false).
--core-port=<i>	Porta su cui eseguire il core (valore predefinito: 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 le credenziali del database.
--daemonize	Esegue come daemon (valore predefinito: 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 (valore predefinito: 180).
--db-migrations-monitor-cutoff=<i>	Ora 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 del gestore di posta predefinito.
--default-mailer-fromemail=<s>	Indirizzo email da cui provengono le email del gestore di posta predefinito (predefinito: Looker <[e-mail]>).
--default-mailer-host=<s>	Nome host del gestore di posta predefinito (valore predefinito: smtp.sendgrid.net).
--default-mailer-password=<s>	Password predefinita del gestore di posta (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 mailer predefinito.
--disable-db-log	Disabilita il logging delle query DB interne (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 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 sicuro.
--external-solr-enabled	Attiva Solr esterno (anziché quello predefinito, ovvero Solr incorporato) (impostazione predefinita: false).
--fips	Abilita la crittografia FIPS-140 (impostazione predefinita: false).
--force-cdn	Forza l'attivazione della CDN (valore predefinito: 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 di Pendo nelle istanze di white 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	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 (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 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 azioni in hosting.
--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 è destinata all'utilizzo solo con un database di backend di 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 è destinata all'utilizzo solo con un database di backend di replica di lettura.
--internal-data-apps-on-gcs	Consente alle estensioni delle app di dati di recuperare gli asset di runtime da Google Cloud Storage (solo per uso interno/Googler).
--internal-analytics-retention-days=<i>	Il numero di giorni per cui conservare i dati storici nel database interno. Questa operazione non influisce su alcun processo ETL. Il valore predefinito è 90. Questa opzione è destinata all'utilizzo solo con un database di backend di replica di lettura.
--k8s-deployment-api-s3bucket-url=<s>	URL in cui questo processo di Looker può scrivere le credenziali del bucket S3 da rendere persistenti come secret di Kubernetes.
--load-chronicle-dialect	Indica se caricare il dialetto integrato di Chronicle (valore predefinito: false).
--log-format=<s>	Formato log, che può essere text o json (valore predefinito: text).
--log-frontend-errors	Registra i dettagli dell'errore dal frontend nel file di log del cliente (impostazione predefinita: false).
--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).
--lookerdb-query-timeout=<i>	Valore di timeout per le query del database interno di Looker in ms (valore predefinito: 0).
--lookml-runtime-cache-size=<i>	Dimensioni (in MB) della cache di 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, 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 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 pianificati ricorrenti attivi (valore predefinito: unlimited).
--max-scheduler-jitter-in-seconds=<i>	Flag per distribuire in modo casuale le esecuzioni della pianificazione 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 il rigeneratore PDT.
--monitoring-port=<i>	Porta per l'hosting del monitoraggio (Prometheus, …) (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 legacy).
--on-disk-cache-size=<i>	Dimensione (in MB) della cache del disco (valore predefinito: 2000).
-p, --port=<i>	Porta su cui eseguire (impostazione predefinita: 9999).
--per-user-query-limit=<i>	Limita il numero di query contemporanee per utente, per connessione, per nodo nell'istanza di 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à il 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 per l'attesa della 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 in uscita elencati nella pagina della documentazione Condivisione dei dati tramite un hub di 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 di polling lungo verifichi se i risultati sono disponibili (valore predefinito: 1).
--qm-long-poll-sleep-interval-in-seconds=<i>	Intervallo di sospensione iniziale prima che l'API di polling lungo controlli se i risultati sono disponibili (valore predefinito: 0,1).
--qm-long-poll-timeout-in-seconds=<i>	Timeout massimo lato server per l'API di polling lungo prima che venga restituito 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>	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 (impostazione predefinita: 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 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 se 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 Studio BYOID in un iframe.
--regionalised-prod-studio-load-url=<s>	URL di produzione con regione segnaposto 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 gli errori del backend (valore predefinito: false).
--report-frontend-errors, --no-report-frontend-errors	Segnala errori dal 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 del 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 da attendere per la connessione (valore predefinito: 1200).
--scheduler-start-delay=<i>	Numero di secondi di ritardo per l'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 (impostazione predefinita: false).
--search-service-ab-test	Attiva il test AB 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 Network File System.
--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. Usa invece il descrittore --ssl-keystore.
--ssl-cert=<s>	Deprecato. Usa invece il descrittore --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 dell'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 viene specificato, il server dell'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 provider SSL sullo stesso host della tua istanza di Looker: --ssl-provided-externally-by=localhost:443 Un valore null indica che il server dell'app Looker fornisce SSL. Se la tua istanza Looker viene eseguita 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. Usa invece il descrittore --ssl-provided-externally-by.
--staging	Esegue il server come gestione temporanea. Questa opzione impedisce all'istanza di staging di inviare report pianificati. Tuttavia, l'istanza di gestione temporanea 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 le email su un'istanza di gestione temporanea 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 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ù spazio prima di iniziare il sondaggio.
--task-monitor-sleep-interval-in-seconds=<i>	Intervallo di sospensione prima che il thread del tracker 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 illimitate simultanee (valore predefinito: 3).
--url-flags-override	Consente di eseguire l'override dei flag di funzionalità utilizzando un parametro di query URL.
--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 le 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, 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"

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

Passaggi successivi

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