Looker-Startoptionen

Es gibt eine Reihe von Looker-Starteinstellungen, die optional auf vom Kunden gehosteten 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 sind die aktuellen Startoptionen in alphabetischer Reihenfolge aufgeführt. 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 der Threads für den Puma API-Server.
--application-server-max-threads=<i> Maximale Anzahl von Threads für den Puma Application Server.
--application-server-min-threads=<i> Mindestanzahl der 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> Zeitspanne, in der asynchrone Ergebnisse im Cache gespeichert bleiben (Standard: 300).
--byoid-studio-load-url=<s> URL, unter der BYOID Studio in einem iFrame geladen wird.
--cdn-hosts=<s> Kommagetrennte Hostnamen für den CDN-Pool (Standard: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Pfad zu einer Datei mit dem Chiffreschlüssel (nur für die alte Verschlüsselung).
--cloud-trace-enabled Aktivieren Sie die Aufrufabfolge mit Standard- oder JSON-Anmeldedaten, sofern über cloud_trace_json_file angegeben (Standard: false).
--cloud-trace-json-file=<s> JSON-Datei mit den Anmeldedaten des Dienstkontos zum Hochladen von Trace-Daten in Google Cloud Trace.
--cloud-trace-project-id=<s> Google-Projekt-ID, auf die Trace-Daten hochgeladen werden sollen.
--cloud-trace-sample-rate=<f> Die Rate (0–1), mit der Traces abgetastet werden (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 den Render-Cache (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 Kunden-Artefaktspeichers 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> Standard-Mailer-Domain.
--default-mailer-fromemail=<s> E-Mail-Adresse, von der E-Mails des Standard-Mailers stammen (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 E-Mail-Client (Passwort in der Befehlszeile wird nicht empfohlen).
--default-mailer-port=<i> Standard-Port des Mailers (Standard: 587).
--default-mailer-username=<s> Standard-Nutzername des E-Mail-Programms.
--disable-db-log Deaktiviert das Logging interner Datenbankabfragen (Standard: false).
--dogstatsd-host-ip=<s> Die IP-Adresse des Datadog-StatsD-Server-Hosts.
--dogstatsd-host-port=<i> Der Hostport des Datadog-Servers.
-e, --help Hier wird eine Liste der Startoptionen angezeigt.
--enable-blobstore-recryption Aktivieren Sie die erneute Verschlüsselung des Persistent Blobstore bei Schlüsselwiederverwendung (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, über die Erweiterungen in einen sicheren iFrame geladen werden.
--external-solr-enabled Externes Solr aktivieren (im Gegensatz zum Standard „embedded Solr“) (Standard: false).
--fips FIPS-140-Verschlüsselung aktivieren (Standard: false).
--force-cdn CDN erzwingen (Standard: false).
--force-cipher-key Sicherheitsvorkehrungen für die Einstellungen des Chiffreschlüssels werden ignoriert (nur bei der alten Verschlüsselung, Standard: false).
--force-enable-pendo Aktiviert Pendo-Leitfäden in Private-Label-Instanzen oder in eingebetteten Kontexten (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 erzwungen deaktivieren (Standard: false).
--git-hooks-use-local-path Verwenden Sie einen lokalen Pfad für das git_hooks-Verzeichnis anstelle des 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 wird.
-h, --hosted Von Looker gehostet.
-H, --hostname=<s> Hostname für die Knoten-zu-Knoten-Kommunikation.
--hosted-action-hub-disabled Deaktivieren Sie den gehosteten Aktions-Hub.
--in-memory-cache-size=<i> Größe (in MB) des In-Memory-Caches (Standard: 200).
--integration-proxy-cert=<s> Pfad zur PKI-Zertifikatdatei des Integrations-Proxys.
--integration-proxy-key=<s> Pfad zur PKI-Schlüsseldatei des Integrations-Proxys.
--internal-analytics-connection-file=<s> YAML-Datei, die die interne Analytics-Verbindung beschreibt, auf der Daten für das system__activity-Modell gehostet werden. Diese Option ist nur für eine Lesereplikat-Back-End-Datenbank vorgesehen.
--internal-analytics-connection-pool-size=<i> Die Anzahl der gleichzeitigen Datenbankverbindungen, über die Abfragen für das Systemaktivitätsmodell ausgeführt werden können. Diese Option ist nur für eine Lesereplikat-Back-End-Datenbank vorgesehen.
--internal-analytics-retention-days=<i> Die Anzahl der Tage, für die Verlaufsdaten in der internen Datenbank aufbewahrt werden sollen. Dies hat keine Auswirkungen auf ETL-Prozesse. Der Standardwert ist 90. Diese Option ist nur für eine Lesereplikat-Back-End-Datenbank 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: text oder json (Standard: text)
--log-level=<s> Protokollebene (Standard: info)
--log-to-file Die Protokollausgabe wird an die Looker-Protokolldatei gesendet (Standard: true).
--lookml-runtime-cache-size=<i> Größe (in MB) des LookML-Laufzeit-Caches (Standard: 200).
--loose-cipher-key-file Für die Datei mit dem Verschlüsselungsschlüssel sind keine 0600-Berechtigungen erforderlich (nur Legacy-Verschlüsselung, Standard: false).
--marketplace=<s> Sie 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 Kundendatenbankverbindung auf der Benutzeroberfläche zulässig sind.
--max-db-connections-records=<i> Maximale Anzahl von Verbindungseinträgen in der Tabelle db_connection (Standard: 10.000).
--max-pdt-regen-threads=<i> Maximale Anzahl von PDT-Regenerator-Threads.
--max-scheduled-plans=<i> Maximale Anzahl aktiver wiederkehrender geplanter Pläne (Standard: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag, um den Zeitplan für das Verwischen zufällig über die angegebene Anzahl von Sekunden auszuführen.
--max-unstreamed-limit=<i> Legt die maximale Anzahl von Zeilen fest, die für alle Abfragen zurückgegeben werden können, die nicht gestreamt werden (Standardwert: 100.000).
--min-pdt-regen-threads=<i> Mindestanzahl der Threads für den PDT-Regenerator.
--monitoring-port=<i> Port für das Hosting von Monitoring (Prometheus, …) (Standard: 1552).
-n, --node-to-node-port=<i> Port für die Knoten-zu-Knoten-Kommunikation (Standard: 1551).
--new-cipher-key-file=<s> Pfad zu einer Datei mit dem neuen Chiffreschlüssel (nur bei der alten Verschlüsselung).
--on-disk-cache-size=<i> Größe (in MB) des Festplatten-Cache (Standard: 2.000).
-p, --port=<i> Port, auf dem der Dienst ausgeführt werden soll (Standard: 9999).
--per-user-query-limit=<i> Begrenzt die Anzahl der gleichzeitigen Abfragen pro Nutzer (Standard: 15).
--per-user-query-timeout=<i> Zeitlimit 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, damit die Callback-URIs der Looker Action API mit der public_host_url und nicht mit 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. Bei Verwendung dieser Methode müssen Looker-Administratoren auch die statischen ausgehenden 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 Zeitintervall, bevor die Long Poll API prüft, ob Ergebnisse verfügbar sind (Standard: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Das anfängliche Ruheintervall, bevor die Long-Poll-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-Poll-API, bevor sie an den Client zurückgegeben wird (Standard: 30).
--query-manager-max-threads=<i> Maximale Anzahl von Threads für den Abfragemanager.
--query-manager-min-threads=<i> Mindestanzahl der Threads für den Abfragemanager.
--query-metrics-retention-hours=<i> Die Anzahl der Stunden, in denen query_metrics-Daten in der internen Datenbank aufbewahrt werden (Standard: 336).
--queue-startup-timeout-in-seconds=<i> Die Dauer in Sekunden, die eine Verbindung zur Warteschlange beim Starten erlaubt (Standard: 180).
--query-task-cleanup-interval-seconds=<i> Intervall zwischen Jobs zum Bereinigen von Tabellen für Abfrageaufgaben (Standard: 600).
--query-task-persistence-duration-minutes=<i> Zeitspanne nach Abschluss der Abfrage, in der Zeilen in der Tabelle mit Abfrageaufgaben beibehalten werden (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 anderen Konto als dem Root-Konto auszuführen. Verwenden Sie die Option „Als Root ausführen“ nur, wenn dies erforderlich ist, z. B. wenn ein Looker-Analyst Sie dazu auffordert, um Fehler zu beheben.
--redis-cache-config-file=<s> Datei mit Redis-Konfiguration
--report-backend-errors, --no-report-backend-errors Meldet Fehler aus dem Backend (Standard: false).
--report-frontend-errors, --no-report-frontend-errors Meldet Fehler aus dem Frontend (Standard: false). HINWEIS: Diese Startoption ist veraltet. Verwenden Sie stattdessen das client_monitor-Funktionsflag.
-S, --ssh-tunnel-sidecar-url=<s> Die Basis-URL, die für die Verbindung mit dem SSH-Tunnel-Server-Sidecar verwendet wird.
--scheduled-job-attempt-limit=<i> Maximale Anzahl von geplanten Jobversuchen (Standard: 10).
--scheduled-job-max-age-days=<i> Maximalalter 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, der auf eine Verbindung wartet (Standard: 1.200).
--scheduler-start-delay=<i> Anzahl der Sekunden, die der Task-Runner verzögert gestartet wird (Standard: 60).
--scheduler-threads=<i> Anzahl der gleichzeitig geplanten Aufgaben (Standard: 10).
--search-result-comparison Ergebnisse des Suchdiensts mit bisherigen Ergebnissen vergleichen (Standard: false).
--search-service Aktiviert den Suchdienst (Standardeinstellung: false).
--search-service-ab-test Aktivieren Sie den AB-Test für den Suchdienst (Standard: false).
--self-signup Jeder kann ein Konto für sich selbst erstellen.
--shared-storage-dir=<s> Pfad zum freigegebenen Speicherplatz 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 ssl-keystore-Datei.
--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, auf den über den Server zugegriffen werden kann, auf dem Looker ausgeführt wird. Wenn nicht angegeben, 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 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 vom Server für Ihre 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 über Ihre Staging-Instanz geplante Berichte gesendet werden. Die Staging-Instanz führt jedoch weiterhin geplante Aufgaben aus und sendet bei Problemen mit der geplanten Aufgabe Fehler-E-Mails an die Inhaber des geplanten Plans.
--staging-override-email=<s> E-Mails in einer Staging-Instanz werden an diese Adresse statt an ihr normales Ziel gesendet.
--stereo-data-search-enabled Aktivieren Sie die Funktion „Stereodatensuche“ (Standard: false).
--studio-load-url=<s> URL, unter der Studio in einem iFrame geladen werden soll.
--studio-one-platform-endpoint=<s> Endpunkt für die Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> Die Zeitspanne, die seit dem letzten Zugriff auf eine Aufgabe vergangen ist, bis die Abfrageaufgabe als aufgegeben betrachtet wird.
--task-monitor-query-startup-interval-in-seconds=<i> Dauer, die als Kulanzzeitraum verwendet wird, wenn Abfragen gestartet werden, bis der erste Longpoll erfolgt. So haben Anrufer mehr Zeit, bevor die Umfrage beginnt.
--task-monitor-sleep-interval-in-seconds=<i> Zeitintervall, bevor der Task-Tracking-Thread prüfen kann, ob Aufgaben aufgegeben wurden.
--unification-jwt-service-account=<s> JWT-Dienstkonto für die Zusammenführung.
--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 Für Verbindungen können pro Nutzer Anmeldedaten verwendet werden (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, sind in der Datei looker-db.yml außerdem folgende Angaben erforderlich:

ssl: true

Startoptionen dauerhaft festlegen

Die bevorzugte Methode, um die Startkonfigurationseinstellungen dauerhaft zu speichern, besteht darin, im Looker-Anwendungsverzeichnis eine Datei mit dem Namen lookerstart.cfg zu erstellen. Diese Datei wird vom Looker-Startscript ausgeführt, das mit Ihrer looker.jar bereitgestellt wurde. Die Datei lookerstart.cfg ist der empfohlene Speicherort für Umgebungsvariablen für JAVAARGS und LOOKERARGS, da sie nicht überschrieben werden, wenn neue Versionen des Looker-Startscripts installiert werden.

Hier ist ein Beispiel für lookerstart.cfg, in dem das SSL von Looker deaktiviert und die Ausführung auf Port 8080 festgelegt wird:

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

Nach Änderungen an lookerstart.cfg muss Looker neu gestartet werden.

Nächste Schritte

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