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.