Looker-Startoptionen

Es gibt eine Reihe von Looker-Starteinstellungen, die optional für vom Kunden gehostete Instanzen konfiguriert werden können. Wenn Sie diese Optionen nicht ändern müssen, können Sie Looker auch ohne sie starten.

Liste der Startoptionen

In der folgenden Tabelle finden Sie eine alphabetisch sortierte Liste der aktuellen Start-up-Optionen. Sie können auch eine Liste der Startoptionen anzeigen lassen, indem Sie das Looker-Startskript mit der Option --help ausführen.

Option Beschreibung
--alerts-scheduler-threads=<i> Anzahl der gleichzeitig geplanten Benachrichtigungen (Standard: 3).
--ami Verworfen. Verwenden Sie stattdessen --marketplace=aws.
--api-server-max-threads=<i> Maximale Anzahl von Threads für den Puma API-Server.
--api-server-min-threads=<i> Mindestanzahl von Threads für den Puma API-Server.
--application-server-max-threads=<i> Maximale Anzahl von Threads für den Puma-Anwendungsserver.
--application-server-min-threads=<i> Mindestanzahl von Threads für den Puma-Anwendungsserver.
--apply-db-migrations Datenbankmigrationen beim Start anwenden Deaktivieren Sie diese Option nur, wenn Sie Migrationen separat anwenden (Standard: true).
--async-results-cache-time=<i> Zeitraum, in dem asynchrone Ergebnisse im Cache gespeichert werden sollen (Standard: 300).
--byoid-studio-load-url=<s> URL zum Laden von BYOID Studio in einen iFrame.
--cdn-hosts=<s> Durch Komma getrennte Hostnamen für den CDN-Pool (Standard: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Pfad zur Datei mit dem Chiffrierschlüssel (nur Legacy-Verschlüsselung).
--cloud-trace-enabled Aktivieren Sie das Tracing mit Standardanmeldedaten oder JSON-Anmeldedaten, falls über cloud_trace_json_file angegeben (Standard: false).
--cloud-trace-json-file=<s> JSON-Datei mit den Anmeldedaten des Dienstkontos zum Hochladen von Tracedaten in Google Cloud Trace.
--cloud-trace-project-id=<s> Die Google-Projekt-ID, in die Trace-Daten hochgeladen werden sollen.
--cloud-trace-sample-rate=<f> Die Rate (0–1), mit der Traces erfasst werden sollen (Standard: 0,0).
--clustered Gibt an, ob dieser Server Teil eines Clusters ist (Standard: false).
--concurrent-render-caching-jobs=<i> Anzahl der gleichzeitigen Prozesse für das Rendern von Caches (Standard: 3).
--concurrent-render-jobs=<i> Anzahl der gleichzeitigen PhantomJS- oder Chromium-Renderingprozesse (Standard: 2).
--core-on-loopback Stellt die Core API über die Loopback-Schnittstelle bereit (Standard: false).
--core-port=<i> Port, auf dem der Core ausgeführt werden soll (Standard: 19999).
--customer-artifact-maxsize=<i> Maximale Größe des Kundenartefaktspeichers in MB.
-d, --internal-db-creds=<s> Pfad zur YAML-Datei mit DB-Anmeldedaten.
--daemonize Wird als Daemon ausgeführt (Standardeinstellung: true).
--default-mailer-domain=<s> Standardmäßige Absenderdomain.
--default-mailer-fromemail=<s> E‑Mail-Adresse, von der E‑Mails des Standard-Mailers gesendet werden (Standard: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Standard-Hostname des Mailers (Standard: smtp.sendgrid.net).
--default-mailer-password=<s> Standardpasswort für den Mailer (Passwort in der Befehlszeile nicht empfohlen).
--default-mailer-port=<i> Standardport für Mailer (Standard: 587).
--default-mailer-username=<s> Standardmäßiger Nutzername des Mailers.
--disable-db-log Deaktiviert das Logging interner Datenbankabfragen (Standard: false).
--dogstatsd-host-ip=<s> Die IP-Adresse des Datadog-statsd-Serverhosts.
--dogstatsd-host-port=<i> Datadog-Server-Hostport.
-e, --help Zeigt diese Liste der Startoptionen an.
--enable-blobstore-recryption Aktivieren Sie die dauerhafte Blobstore-Neuverschlüsselung bei Rekey-Vorgängen (Standard: false).
--error-emails-to=<s> Fehler-E‑Mails an <email address>.
--experimental-features=<s> Durch Kommas getrennte Liste der zulässigen experimentellen Funktionen.
--experimental-routes=<s> Durch Kommas getrennte Liste der zulässigen experimentellen Routen, die Routen mit dem Suffix -next generieren.
--extension-load-url=<s> URL zum Laden von Erweiterungen in einen sicheren iFrame.
--external-solr-enabled Aktivieren Sie den externen Solr-Server (im Gegensatz zum Standard – eingebetteter Solr-Server) (Standard: false).
--fips FIPS-140-Verschlüsselung aktivieren (Standard: false).
--force-cdn CDN erzwingen (Standard: false).
--force-cipher-key Ignoriert Sicherheitsvorkehrungen für die Chiffrierschlüsseleinstellungen (nur Legacy-Verschlüsselung, Standard: false).
--force-enable-pendo Aktiviert Pendo-Anleitungen in Private Label-Instanzen oder in Einbettungskontexten (Standard: false).
--force-error-emails Erzwingt, dass Looker Fehler per E-Mail meldet (Standard: false).
--force-gcm-encryption VERWORFEN (diese Option ist nicht mehr erforderlich).
--force-mismatched-internal-db Ermöglicht die Verwendung einer nicht synchronisierten internen Looker-Datenbank (Standard: false).
--force-no-cdn CDN erzwingen (Standard: false).
--git-hooks-use-local-path Verwenden Sie für das Verzeichnis git_hooks einen lokalen Pfad anstelle eines freigegebenen Speichers.
--git-performance-logging Aktiviert die Protokollierung der JGit-Leistung (Standard: false).
--google-analytics-tracker-id=<s> Tracking-ID, die zum Senden von Seitenaufrufen an zusätzliche Google Analytics-Tracker verwendet werden soll.
-h, --hosted Von Looker gehostet.
-H, --hostname=<s> Hostname für die Knoten-zu-Knoten-Kommunikation.
--hosted-action-hub-disabled Deaktiviere den Hub für gehostete Aktionen.
--in-memory-cache-size=<i> Größe des In-Memory-Cache in MB (Standard: 200).
--integration-proxy-cert=<s> Pfad zur PKI-Zertifikatsdatei des Integrationsproxys.
--integration-proxy-key=<s> Pfad zur PKI-Schlüsseldatei des Integrationsproxys.
--internal-analytics-connection-file=<s> YAML-Datei, in der die interne Analytics-Verbindung beschrieben wird, in der Daten für das system__activity-Modell gehostet werden. Diese Option ist nur für die Verwendung mit einer Backend-Datenbank als Lesereplikat vorgesehen.
--internal-analytics-connection-pool-size=<i> Die Anzahl der gleichzeitigen Datenbankverbindungen, über die Abfragen für Systemaktivitätsmodelle ausgeführt werden können. Diese Option ist nur für die Verwendung mit einer Backend-Datenbank als Lesereplikat vorgesehen.
--internal-analytics-retention-days=<i> Die Anzahl der Tage, für die Verlaufsdaten in der internen Datenbank aufbewahrt werden. Dies hat keine Auswirkungen auf ETL-Prozesse. Der Standardwert ist 90. Diese Option ist nur für die Verwendung mit einer Backend-Datenbank als Lesereplikat vorgesehen.
--k8s-deployment-api-s3bucket-url=<s> URL, unter der dieser Looker-Prozess S3-Bucket-Anmeldedaten schreiben kann, die als Kubernetes-Secrets gespeichert werden sollen.
--log-format=<s> Logformat, das entweder text oder json ist (Standard: text).
--log-level=<s> Protokollebene (Standard: info).
--log-to-file Sendet die Logausgabe an die Looker-Logdatei (Standard: true).
--lookml-runtime-cache-size=<i> Größe (in MB) des LookML-Laufzeit-Cache (Standard: 200).
--loose-cipher-key-file 0600-Berechtigungen für die Chiffrierschlüsseldatei sind nicht erforderlich (nur Legacy-Verschlüsselung, Standard: false).
--marketplace=<s> Die Anwendung wird in einer Looker Marketplace-Instanz ausgeführt.
--max-async-threads=<i> Maximale Anzahl von Threads für asynchrone Abfragen (Standard: 200).
--max-configurable-db-connections=<i> Maximale Anzahl von Verbindungen, die für eine Kunden-DB-Verbindung in der Benutzeroberfläche zulässig sind.
--max-db-connections-records=<i> Maximale Anzahl von Verbindungsdatensätzen, die in der Tabelle db_connection zulässig sind (Standard: 10.000).
--max-pdt-regen-threads=<i> Maximale Anzahl von Threads für die PDT-Regenerierung.
--max-scheduled-plans=<i> Maximale Anzahl aktiver wiederkehrender geplanter Pläne (Standard: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flagge, um die Ausführung von Zeitplänen zufällig über die angegebene Anzahl von Sekunden zu verteilen.
--max-unstreamed-limit=<i> Legt die maximale Anzahl von Zeilen fest,die für alle nicht gestreamten Abfragen zurückgegeben werden können (Standard: 100.000).
--min-pdt-regen-threads=<i> Mindestanzahl von Threads für PDT-Regenerator.
--monitoring-port=<i> Port für das Hosting von Monitoring (Prometheus usw.) (Standard: 1552).
-n, --node-to-node-port=<i> Port für die Knoten-zu-Knoten-Kommunikation (Standard: 1551).
--new-cipher-key-file=<s> Pfad zur Datei mit dem neuen Chiffrierschlüssel (nur Legacy-Verschlüsselung).
--on-disk-cache-size=<i> Größe des Festplatten-Cache (in MB) (Standard: 2000).
-p, --port=<i> Port, auf dem der Server ausgeführt werden soll (Standard: 9999).
--per-user-query-limit=<i> Begrenzt die Anzahl der gleichzeitigen Anfragen pro Nutzer (Standard: 15).
--per-user-query-timeout=<i> Länge des Zeitlimits pro Nutzer, das auf eine Verbindung gewartet wird (Standard: 600).
--prefer-ipv4 IPv4 bevorzugen.
--public-embed-auth-param-file=<s> Datei mit Authentifizierungsparametern für die öffentliche Authentifizierung.
--public-host-url=<s> Wenn die public_host_url-Lizenzfunktion aktiviert ist, können Administratoren mit dieser Option einen public_host_url-Hostnamen angeben, sodass die Looker Action API-Callback-URIs mit dem public_host_url-Hostnamen anstelle der Standard-Host-URL in Looker erstellt werden. Die Eingabe für die Startoption sollte https://<my.host.name> ohne nachgestellten Schrägstrich in der URL sein. Wenn Sie diese Methode verwenden, müssen Looker-Administratoren auch die statischen Egress-IP-Adressen auf die Zulassungsliste setzen, die auf der Dokumentationsseite Daten über einen Action Hub freigeben aufgeführt sind.
-q, --queue-broker-port=<i> Port für den Queue-Broker (Standard: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Maximales Schlafintervall, bevor die Long-Polling-API prüft, ob Ergebnisse verfügbar sind (Standard: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Erstes Schlafintervall, bevor die Long-Polling-API prüft, ob Ergebnisse verfügbar sind (Standard: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Maximale serverseitige Zeitüberschreitung für die Long-Polling-API, bevor sie an den Client zurückgegeben wird (Standard: 30).
--query-manager-max-threads=<i> Maximale Anzahl von Threads für Query Manager.
--query-manager-min-threads=<i> Mindestanzahl von Threads für Query Manager.
--query-metrics-retention-hours=<i> Die Anzahl der Stunden, für die query_metrics-Daten in der internen Datenbank aufbewahrt werden sollen (Standard: 336).
--queue-startup-timeout-in-seconds=<i> Die Dauer in Sekunden, die eine Verbindung zur Warteschlange beim Start zulässig ist (Standard: 180).
--query-task-cleanup-interval-seconds=<i> Das Intervall zwischen Bereinigungsjobs für Tabellen mit Abfrageaufgaben (Standard: 600).
--query-task-persistence-duration-minutes=<i> Die Zeit nach Abschluss der Abfrage, die Zeilen in der Tabelle für Abfrageaufgaben beibehalten werden sollen (Standard: 360).
-r, --root Ermöglicht die Ausführung als Root.

Für den normalen Betrieb von Looker sind keine Root-Berechtigungen erforderlich. Aus Sicherheitsgründen empfehlen wir, Looker in einem Konto ohne Root-Berechtigungen auszuführen. Verwenden Sie die Option „Als Root ausführen“ nur bei Bedarf, z. B. wenn ein Looker-Analyst sie zur Fehlerbehebung anfordert.
--redis-cache-config-file=<s> Datei mit der Redis-Konfiguration.
--report-backend-errors, --no-report-backend-errors Meldet Fehler vom Backend (Standard: false).
--report-frontend-errors, --no-report-frontend-errors Meldet Fehler vom Frontend (Standard: false). HINWEIS: Diese Startoption ist veraltet. Verwenden Sie stattdessen das Feature-Flag client_monitor.
-S, --ssh-tunnel-sidecar-url=<s> Die Basis-URL, die für die Verbindung mit dem SSH-Tunnel-Sidecar verwendet wird.
--scheduled-job-attempt-limit=<i> Maximale Anzahl geplanter Jobversuche (Standard: 10).
--scheduled-job-max-age-days=<i> Maximales Alter eines geplanten Jobs, bevor er gelöscht wird (Standard: 60).
--scheduler-query-limit=<i> Beschränkt die Anzahl gleichzeitiger geplanter Abfragen (Standard: 10).
--scheduler-query-timeout=<i> Länge des Zeitlimits für den Scheduler, das auf eine Verbindung gewartet wird (Standard: 1200).
--scheduler-start-delay=<i> Anzahl der Sekunden, die vor dem Starten des Task-Runners gewartet werden soll (Standard: 60).
--scheduler-threads=<i> Anzahl der gleichzeitig ausgeführten geplanten Aufgaben (Standard: 10).
--search-result-comparison Vergleichen Sie die Ergebnisse des Search Service mit den alten Ergebnissen (Standard: false).
--search-service Aktiviert den Suchdienst (Standardeinstellung: false).
--search-service-ab-test Aktivieren Sie den A/B-Test für den Suchdienst (Standard: false).
--self-signup Ermöglicht es jedem, ein Konto für sich selbst zu erstellen.
--shared-storage-dir=<s> Pfad zum freigegebenen Speicher des Netzwerkdateisystems.
--snowplow-host=<s> Zusätzlicher Snowplow-Collector.
--solr-basic-auth=<s> Anmeldedaten für die Basisauthentifizierung für Aufrufe von Solr (Standard: solr:SolrRocks).
--ssl Verwendet SSL (Standard: true).
--ssl-ca-cert=<s> Verworfen. Verwenden Sie stattdessen --ssl-keystore.
--ssl-cert=<s> Verworfen. Verwenden Sie stattdessen --ssl-keystore.
--ssl-key=<s> Verworfen. Verwenden Sie stattdessen --ssl-keystore.
--ssl-keystore-pass-file=<s> Pfad zur Datei mit dem ssl-keystore-Passwort.
--ssl-keystore-pass=<s> Passwort für die Datei ssl-keystore.
--ssl-keystore=<s> Pfad zur Keystore-Datei für SSL.
--ssl-provided-externally-by=<s> Gibt den Host:Port für einen externen SSL-Anbieter an, der vom Server aus zugänglich ist, auf dem Looker ausgeführt wird. Wenn nichts angegeben ist, stellt der Looker-App-Server SSL bereit.

Hier ist ein Beispiel für einen SSL-Proxy vor einem Looker-Cluster:

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

Hier ist ein Beispiel für einen SSL-Anbieter auf demselben Host wie Ihre Looker-Instanz:

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

Ein Nullwert gibt an, dass der Looker-App-Server SSL bereitstellt. Wenn Ihre Looker-Instanz auf einem Server mit eingeschränktem Zugriff auf das öffentliche Internet ausgeführt wird, müssen Sie eine IP-Adresse in Ihrem internen Netzwerk angeben, die für den Server Ihrer Looker-Instanz erreichbar ist.
--ssl-provided-externally Verworfen. Verwenden Sie stattdessen --ssl-provided-externally-by.
--staging Führt den Server als Staging aus. Mit dieser Option wird verhindert, dass in Ihrer Staging-Instanz geplante Berichte gesendet werden. Die Staging-Instanz führt jedoch weiterhin geplante Aufgaben aus und sendet Fehlermeldungen an die Inhaber geplanter Vorlagen, wenn Probleme mit der geplanten Aufgabe auftreten.
--staging-override-email=<s> E‑Mails, die auf einer Staging-Instanz gesendet werden, werden an diese Adresse statt an das normale Ziel gesendet.
--stereo-data-search-enabled Aktivieren Sie die Suche nach Stereodaten (Standard: false).
--studio-load-url=<s> URL zum Laden von Studio in einem iFrame.
--studio-one-platform-endpoint=<s> Endpunkt für die Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> Die Dauer, die seit dem letzten Zugriff auf eine Aufgabe vergangen ist, bevor die Abfrageaufgabe als abgebrochen betrachtet wird.
--task-monitor-query-startup-interval-in-seconds=<i> Dauer, die als Kulanzzeitraum verwendet wird, wenn Abfragen ausgeführt werden, bis der erste Long-Poll erfolgt. So haben Anrufer mehr Zeit, bevor die Umfrage beginnt.
--task-monitor-sleep-interval-in-seconds=<i> Schlafintervall, bevor der Thread zur Aufgabenverfolgung prüfen kann, ob Aufgaben abgebrochen wurden.
--unification-jwt-service-account=<s> Dienstkonto für Unification-JWT.
--unlimited-scheduler-threads=<i> Anzahl der gleichzeitigen unbegrenzten geplanten Aufgaben (Standard: 3).
--use-custom-jdbc-config Gibt an, ob eine benutzerdefinierte JDBC-Treiberkonfiguration verwendet werden soll (Standard: false).
--user-db-credentials Eingeschränkte Nutzung. Verbindungen können Nutzeranmeldedaten verwenden (Standard: false).
-v, --version Gibt die Version aus und beendet den Vorgang.

Dateiformat für Anmeldedaten

Wenn Sie die Anwendungsdatenbank in MySQL geändert haben, benötigen Sie eine Anmeldedatendatei mit dem Namen looker-db.yml, die die folgenden Einstellungen enthält:

dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT

Wenn für Ihre MySQL-Datenbank eine SSL-Verbindung erforderlich ist, muss die Datei looker-db.yml auch Folgendes enthalten:

ssl: true

Startoptionen dauerhaft festlegen

Die bevorzugte Methode zum dauerhaften Festlegen von Startkonfigurationseinstellungen besteht darin, eine Datei mit dem Namen lookerstart.cfg im Looker-Anwendungsverzeichnis zu erstellen. Diese Datei wird vom Looker-Startskript ausgeführt, das mit looker.jar bereitgestellt wurde. Die Datei lookerstart.cfg ist der empfohlene Ort, um Umgebungsvariablen für JAVAARGS und LOOKERARGS festzulegen, da sie nicht überschrieben werden, wenn neue Versionen des Looker-Startskripts installiert werden.

Hier ist ein Beispiel für lookerstart.cfg, in dem SSL für Looker deaktiviert und Port 8080 festgelegt wird:

LOOKERARGS="--no-ssl --port 8080"

Looker muss neu gestartet werden, nachdem Änderungen an lookerstart.cfg vorgenommen wurden.

Nächste Schritte

Nachdem Sie die Looker-Startoptionen konfiguriert haben, können Sie Ihr SSL-Zertifikat für HTTPS konfigurieren.