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 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 gleichzeitigen 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> Dauer, für die asynchrone Ergebnisse im Cache gespeichert werden (Standard: 300).
--byoid-studio-load-url=<s> URL zum Laden von BYOID Studio in einen 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 mit dem Chiffrierschlüssel (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 Anmeldedaten des Dienstkontos zum Hochladen von Trace-Daten in Google Cloud Trace.
--cloud-trace-project-id=<s> Google-Projekt-ID, in die Trace-Daten hochgeladen werden sollen.
--cloud-trace-sample-rate=<f> Die Rate (0–1), mit der Traces stichprobenartig erfasst werden (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 auf der 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 Datenbankanmeldedaten.
--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 Wartezeit bei Sperrungen 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-Mailer-Hostname (Standard: smtp.sendgrid.net).
--default-mailer-password=<s> Standardpasswort für den Mailer (Passwort in der Befehlszeile wird nicht empfohlen).
--default-mailer-port=<i> Standard-Mailer-Port (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 auf 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 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-Deaktivierung 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 das Logging 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 Kommunikation zwischen Knoten.
--hosted-action-hub-disabled Deaktivieren Sie den gehosteten Action Hub.
--in-memory-cache-size=<i> Größe (in MB) des Arbeitsspeicher-Cache (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 system__activity-Modell 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, die Abfragen für das Systemaktivitätsmodell ausführen können. Diese Option ist nur für die Verwendung mit einer Lesereplikat-Backend-Datenbank 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 beibehalten werden sollen.
--load-chronicle-dialect Gibt an, ob der integrierte Chronicle-Dialekt geladen werden soll (Standard: false).
--log-format=<s> Logformat, entweder text oder json (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 Logausgabe an die Looker-Logdatei (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 Für die Chiffrierschlüsseldatei sind keine 0600-Berechtigungen 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 Verbindungseinträgen, die in der Tabelle db_connection zulässig sind (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 geplante Ausführungen 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 PDT-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, die den neuen Chiffrierschlüssel enthält (nur Legacy-Verschlüsselung).
--on-disk-cache-size=<i> Größe (in MB) des Datenträger-Cache (Standard: 2.000).
-p, --port=<i> Port, auf dem die Ausführung erfolgen soll (Standard: 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> Dauer des Zeitlimits pro Nutzer, um auf die Verbindung zu warten (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:// sein, ohne nachgestellten Schrägstrich in der URL. Wenn Sie diese Methode verwenden, müssen Looker-Administratoren auch die statischen IP-Adressen für ausgehenden Traffic 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> Zeitspanne nach Abschluss der Abfrage, für die Zeilen in der Abfrageaufgabentabelle beibehalten werden (Standard: 360).
-r, --root Ermöglicht die Ausführung als Root.

Looker benötigt für den normalen Betrieb keine Root-Berechtigungen. Aus Sicherheitsgründen empfehlen wir, Looker in einem Nicht-Root-Konto auszuführen. Verwenden Sie die Option zum Ausführen als Root nur, wenn dies erforderlich ist, z. B. wenn ein Looker-Analyst dies zur Fehlerbehebung anfordert.
--redis-cache-config-file=<s> Datei mit 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 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 A/B-Test für den Suchdienst aktivieren (Standard: false).
--self-signup Jeder kann ein Konto für sich selbst 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 Schlüsselspeicherdatei für SSL.
--ssl-provided-externally-by=<s> Gibt den Host:Port für einen externen SSL-Anbieter an, der über den Server, auf dem Looker ausgeführt wird, 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-Anwendungsserver 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-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 auf einer Staging-Instanz werden an diese Adresse statt an ihr normales Ziel gesendet.
--stereo-data-search-enabled Aktivieren Sie die Funktion für die Suche nach 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, die seit dem letzten Zugriff auf eine Aufgabe vergangen ist, damit die Abfrageaufgabe als abgebrochen gilt.
--task-monitor-query-startup-interval-in-seconds=<i> Dauer, die als Kulanzzeitraum verwendet wird, wenn Abfragen ausgeführt werden, bis der erste Long-Polling-Vorgang erfolgt. So haben Anrufer mehr Zeit, 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> JWT-Dienstkonto für die Zusammenführung.
--unlimited-scheduler-threads=<i> Anzahl der gleichzeitig unbegrenzten geplanten Aufgaben (Standard: 3).
--url-flags-override Ermöglicht das Überschreiben von Funktions-Flags mithilfe eines URL-Suchparameters.
--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 nutzerspezifische Anmeldedaten verwenden (Standard: false).
-v, --version Gibt die Version aus und beendet den Vorgang.

Format der Datei mit 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-Datei 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 eine lookerstart.cfg, die das SSL von Looker deaktiviert und festlegt, dass Looker auf Port 8080 ausgeführt 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.