Looker-Startoptionen

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

Liste der Startoptionen

In der folgenden Tabelle finden Sie eine Liste der aktuellen Startup-Optionen in alphabetischer Reihenfolge. 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 (Standardwert: 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, für den asynchrone Ergebnisse im Cache gespeichert werden sollen (Standard: 300).
--byoid-studio-load-url=<s> URL zum Laden von BYOID Studio in einem iFrame.
--cdn-hosts=<s> Kommagetrennte Hostnamen für den CDN-Pool (Standard: static-a.lookercdn.com,static-b.lookercdn.com).
--cipher-key-file=<s> Pfad zur Datei, die den Chiffrierschlüssel enthält (nur Legacy-Verschlüsselung).
--cloud-trace-enabled Aktivieren Sie das Tracing mit Standardanmeldedaten oder JSON-Anmeldedaten, wenn diese mit --cloud-trace-json-file bereitgestellt werden (Standard: false).
--cloud-trace-json-file=<s> JSON-Datei mit den Dienstkonto-Anmeldedaten zum Hochladen von Trace-Daten 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 (Standardwert: 0,0).
--clustered Gibt an, ob dieser Server Teil eines Clusters ist (Standard: false).
--concurrent-render-caching-jobs=<i> Anzahl der gleichzeitigen Render-Caching-Prozesse (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 den DB-Anmeldedaten.
--daemonize Wird als Daemon ausgeführt (Standardeinstellung: true).
--db-migrations-kill-timeout=<i> Zeitlimit für das Beenden von Datenbankmigrationen in Sekunden (Standard: 480).
--db-migrations-lock-wait-timeout=<i> Zeitlimit für die Sperrwartezeit für Datenbankmigrationen in Sekunden (Standard: 180).
--db-migrations-monitor-cutoff=<i> Annahmeschluss für das Monitoring interner Datenbankmigrationen in Sekunden (Standard: 2592000).
--db-migrations-wait-timeout=<i> Wartezeitlimit für Datenbankmigrationen in Sekunden (Standard: 720).
--default-mailer-domain=<s> Standard-Mailer-Domain.
--default-mailer-fromemail=<s> E‑Mail-Adresse, von der Standard-Mailer-E‑Mails stammen (Standard: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Standard-Hostname des Mailers (Standard: smtp.sendgrid.net).
--default-mailer-password=<s> Standardmäßiges Mailer-Passwort (Passwort in der Befehlszeile nicht empfohlen).
--default-mailer-port=<i> Standardport für den Mailer (Standard: 587).
--default-mailer-username=<s> Standardmäßiger Nutzername für den Mailer.
--disable-db-log Deaktiviert das Logging interner DB-Abfragen (Standard: false).
--dogstatsd-host-ip=<s> 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 erneute Verschlüsselung des nichtflüchtigen Blobstores bei Vorgängen zur Schlüsselrotation (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 zulässiger experimenteller Routen, die Routen mit dem Suffix „-next“ generieren.
--extension-load-url=<s> URL zum Laden von Erweiterungen in einen sicheren iFrame.
--external-solr-enabled Externes Solr aktivieren (im Gegensatz zum Standard – eingebettetes Solr) (Standard: false).
--fips FIPS-140-Verschlüsselung aktivieren (Standard: false).
--force-cdn CDN erzwingen (Standard: false).
--force-cipher-key Ignoriert Schutzmaßnahmen für die Einstellungen des Chiffrierschlüssels (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 EINGESTELLT (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 Deaktivieren Sie den gehosteten Action Hub.
--in-memory-cache-size=<i> Größe des Speicher-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, die die interne Analyseverbindung beschreibt, die Daten für das Modell system__activity hostet. Diese Option ist nur für die Verwendung mit einer Lesereplikat-Backend-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 die Verwendung mit einer Backend-Datenbank als Lesereplikat vorgesehen.
--internal-data-apps-on-gcs Ermöglicht Daten-App-Erweiterungen, Laufzeit-Assets aus Google Cloud Storage abzurufen (nur intern/Googler).
--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 die Verwendung mit einer Lesereplikat-Backend-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.
--load-chronicle-dialect Gibt an, ob der integrierte Chronicle-Dialekt geladen werden soll (Standardeinstellung: false).
--log-format=<s> Logformat, das entweder text oder json ist (Standard: text).
--log-frontend-errors Fehlerdetails vom Frontend in die Protokolldatei des Kunden protokollieren (Standard: false).
--log-level=<s> Logebene (Standard: info).
--log-to-file Sendet die Protokollausgabe an die Looker-Protokolldatei (Standard: true).
--lookerdb-query-timeout=<i> Zeitlimitwert für interne Looker-Datenbankabfragen in ms (Standard: 0).
--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> Ausführung in einer Looker Marketplace-Instanz.
--max-async-threads=<i> Maximale Anzahl asynchroner Abfragethreads (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 in der Tabelle db_connection (Standard: 10.000).
--max-pdt-regen-threads=<i> Maximale Anzahl von PAT-Regenerator-Threads.
--max-scheduled-plans=<i> Maximale Anzahl aktiver wiederkehrender Zeitpläne (Standard: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag, um die Ausführung des Zeitplans 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 Abfragen zurückgegeben werden können, die nicht gestreamt werden (Standard: 100.000).
--min-pdt-regen-threads=<i> Mindestanzahl von Threads für den PAT-Regenerator.
--monitoring-port=<i> Port für das Hosting-Monitoring (Prometheus, ...) (Standard: 1552).
-n, --node-to-node-port=<i> Port für die Kommunikation zwischen Knoten (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 Datenträger-Cache (in MB) (Standard: 2000).
-p, --port=<i> Port, auf dem der Server ausgeführt werden soll (Standardeinstellung: 9999).
--per-user-query-limit=<i> Begrenzt die Anzahl gleichzeitiger Abfragen pro Nutzer, pro Verbindung und pro Knoten auf der Looker-Instanz (Standard: 15). Wenn für eine Verbindung ein Wert für die Einstellung Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung angegeben ist, überschreibt der Wert Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung den Wert per-user-query-limit für die Verbindung. Die Einstellung Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung gilt pro Nutzer und pro Verbindung, aber nicht pro Knoten. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.
--per-user-query-timeout=<i> Länge des Zeitlimits pro Nutzer, das auf die Verbindung gewartet wird (Standard: 600).
--prefer-ipv4 IPv4 bevorzugen.
--public-embed-auth-param-file=<s> Authentifizierungsparameterdatei für die öffentliche Authentifizierung.
--public-host-url=<s> Wenn die Lizenzfunktion public_host_url aktiviert ist, können Administratoren mit dieser Option einen public_host_url-Hostnamen angeben, sodass die Callback-URIs der Looker Action API mit der public_host_url anstelle der Standard-Host-URL in Looker erstellt werden. Die Eingabe für die Startoption sollte https:// 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 Warteschlangen-Broker (Standard: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Maximales Ruheintervall, bevor die Long-Polling-API prüft, ob Ergebnisse verfügbar sind (Standard: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Anfängliches Ruheintervall, bevor die Long-Polling-API prüft, ob Ergebnisse verfügbar sind (Standard: 0,1).
--qm-long-poll-timeout-in-seconds=<i> Maximales serverseitiges Zeitlimit 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 den Query Manager.
--query-metrics-retention-hours=<i> Die Anzahl der Stunden, die query_metrics-Daten in der internen Datenbank aufbewahrt werden sollen (Standard: 336).
--queue-startup-timeout-in-seconds=<i> Wie lange in Sekunden die Verbindung zur Warteschlange beim Start zugelassen werden soll (Standard: 180).
--query-task-cleanup-interval-seconds=<i> Intervall zwischen Bereinigungsjobs für Abfrageaufgabentabellen (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 zu Fehlerbehebungszwecken anfordert.
--redis-cache-config-file=<s> Datei mit der Redis-Konfiguration.
--regionalised-prod-byoid-studio-load-url=<s> Produktions-URL mit Platzhalterregion zum Laden von BYOID Studio in einem iFrame.
--regionalised-prod-studio-load-url=<s> Produktions-URL mit Platzhalterregion zum Laden von Studio.
--regionalised-prod-studio-one-platform-endpoint=<s> Produktionsendpunkt mit Platzhalterregion für die Studio One Platform API.
--report-backend-errors, --no-report-backend-errors Meldet Fehler aus dem 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 Funktions-Flag client_monitor.
-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 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> Dauer des Zeitlimits für den Planer, um auf die Verbindung zu warten (Standard: 1200).
--scheduler-start-delay=<i> Anzahl der Sekunden, die der Start des Task-Runners verzögert werden soll (Standard: 60).
--scheduler-threads=<i> Anzahl der gleichzeitig ausgeführten geplanten Aufgaben (Standard: 10).
--search-result-comparison Vergleichen Sie die Ergebnisse des Suchdienstes mit den alten Ergebnissen (Standard: false).
--search-service Aktiviert den Suchdienst (Standard: 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 an 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, die das ssl-keystore-Passwort enthält.
--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, der vom Server, auf dem Looker ausgeführt wird, aus zugänglich ist. Wenn keine Angabe erfolgt, stellt der Looker-Anwendungsserver 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-Server aus. Mit dieser Option wird verhindert, dass Ihre Staging-Instanz geplante Berichte sendet. Die Staging-Instanz führt jedoch weiterhin geplante Aufgaben aus und sendet Fehler-E-Mails an die Inhaber geplanter Pläne, wenn bei der geplanten Aufgabe Probleme 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 Suchfunktion für Stereodaten (Standard: false).
--studio-load-url=<s> URL zum Laden von Studio in einen iFrame.
--studio-one-platform-endpoint=<s> Endpunkt für die Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> Dauer seit dem letzten Zugriff auf eine Aufgabe, nach der die Abfrageaufgabe als abgebrochen gilt.
--task-monitor-query-startup-interval-in-seconds=<i> Dauer, die als Kulanzzeitraum verwendet wird, wenn Abfragen mit der Ausführung beginnen, bis der erste Long-Poll-Vorgang erfolgt. So haben Anrufer mehr Zeit, sich zu melden, bevor die Umfrage beginnt.
--task-monitor-sleep-interval-in-seconds=<i> Schlafintervall, bevor der Thread für das Aufgaben-Tracking prüfen kann, ob Aufgaben abgebrochen wurden.
--unification-jwt-service-account=<s> Unification-JWT-Dienstkonto.
--unlimited-scheduler-threads=<i> Anzahl der gleichzeitig unbegrenzten geplanten Aufgaben (Standard: 3).
--url-flags-override Ermöglicht das Überschreiben von Feature-Flags mithilfe eines URL-Abfrageparameters.
--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 nutzerspezifische 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 Datei mit Anmeldedaten namens 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 außerdem Folgendes enthalten:

ssl: true

Startoptionen dauerhaft festlegen

Die bevorzugte Methode, um die Einstellungen für die Startkonfiguration dauerhaft zu speichern, besteht darin, im Looker-Anwendungsverzeichnis eine Datei mit dem Namen lookerstart.cfg zu erstellen. Diese Datei wird vom Looker-Startskript ausgeführt, das mit Ihrer looker.jar bereitgestellt wurde. Die Datei lookerstart.cfg ist der empfohlene Ort zum Festlegen von 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 SSL für Looker deaktiviert und der Port auf 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.