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 mit Startoptionen

In der folgenden Tabelle sind die aktuellen Startoptionen in alphabetischer Reihenfolge aufgeführt. Sie können eine Liste der Startoptionen auch aufrufen, indem Sie das Looker-Startskript mit der Option --help ausführen.

Option Beschreibung
--alerts-scheduler-threads=<i> Anzahl gleichzeitig geplanter 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 der Threads für den Puma-Anwendungsserver.
--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> Zeitraum für die Aufbewahrung asynchroner Ergebnisse im Cache (Standardeinstellung: 300).
--byoid-studio-load-url=<s> URL, unter der BYOID Studio in einem iFrame geladen werden soll.
--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 das Tracing mit Standardanmeldedaten oder JSON-Anmeldedaten, wenn diese über cloud_trace_json_file bereitgestellt werden (Standardeinstellung: 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 abgetastet werden (Standard: 0,0).
--clustered Gibt an, ob dieser Server Teil eines Clusters ist (Standardeinstellung: false).
--concurrent-render-caching-jobs=<i> Anzahl der gleichzeitigen Rendering-Caching-Prozesse (Standard: 3).
--concurrent-render-jobs=<i> Anzahl der gleichzeitigen PhantomJS- oder Chromium-Rendering-Prozesse (Standard: 2).
--core-on-loopback Macht die Core API auf der Loopback-Schnittstelle verfügbar (Standardeinstellung: false).
--core-port=<i> Port, auf dem der Core ausgeführt werden soll (Standard: 19999).
--customer-artifact-maxsize=<i> Maximale Größe des Artefaktspeichers des Kunden 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> Die E-Mail-Adresse, von der die Standard-Mailer-E-Mails stammen (Standardeinstellung: Looker <noreply@lookermail.com>).
--default-mailer-host=<s> Standard-Hostname für E-Mails (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> Standardnutzername für E-Mail-Versand
--disable-db-log Deaktiviert das Logging interner Datenbankabfragen (Standardeinstellung: false).
--dogstatsd-host-ip=<s> IP-Adresse des Datadog-Stats-Server-Hosts.
--dogstatsd-host-port=<i> Der Hostport des Datadog-Servers.
-e, --help Zeigt diese Liste der Startoptionen an.
--enable-blobstore-recryption Aktivieren Sie die Persistent Blobstore-Neuverschlüsselung bei Neuverschlüsselungsvorgängen (Standardeinstellung: 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, über die Erweiterungen in einen sicheren iFrame geladen werden.
--external-solr-enabled Externes Solr aktivieren (im Gegensatz zum standardmäßigen eingebetteten Solr) (Standard: false).
--fips Aktivieren Sie die FIPS-140-Verschlüsselung (Standardeinstellung: false).
--force-cdn CDN erzwingen (Standard: false).
--force-cipher-key Ignoriert Sicherheitsmaßnahmen für die Verschlüsselungsschlüssel-Einstellungen (nur Legacy-Verschlüsselung, Standard: false).
--force-enable-pendo Aktiviert Pendo-Leitfäden für Private-Label-Instanzen oder in Einbettungskontexten (Standardeinstellung: 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 (Standardeinstellung: 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 das Logging der JGit-Leistung (Standardeinstellung: false).
--google-analytics-tracker-id=<s> Tracking-ID, die zum Senden von Seitenaufrufen an zusätzliche Google Analytics-Tracker verwendet wird.
-h, --hosted Gehostet von Looker.
-H, --hostname=<s> Hostname für die Knoten-zu-Knoten-Kommunikation.
--hosted-action-hub-disabled Deaktivieren Sie den Hub für gehostete Aktionen.
--in-memory-cache-size=<i> Größe (in MB) des Arbeitsspeicher-Caches (Standard: 200).
--integration-proxy-cert=<s> Pfad zur PKI-Zertifikatsdatei des Integrationsproxys.
--integration-proxy-key=<s> Pfad zur PKI-Schlüsseldatei des Integrations-Proxys.
--internal-analytics-connection-file=<s> YAML-Datei, die die interne Analyseverbindung beschreibt, die Daten für das system__activity-Modell hostet. Diese Option kann nur mit einer Backend-Datenbank mit Lesereplikat verwendet werden.
--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 kann nur mit einer Backend-Datenbank mit Lesereplikat verwendet werden.
--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 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 persistiert werden.
--log-format=<s> Logformat, entweder text oder json (Standard: text).
--log-level=<s> Logebene (Standardeinstellung: 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-Laufzeitcache (Standard: 200).
--loose-cipher-key-file Erfordert keine 0600-Berechtigungen für die Chiffreschlüsseldatei (nur Legacy-Verschlüsselung; Standard: false).
--marketplace=<s> Wird in einer Looker Marketplace-Instanz ausgeführt.
--max-async-threads=<i> Maximale Anzahl asynchroner Abfragethreads (Standard: 200).
--max-configurable-db-connections=<i> Maximal zulässige Anzahl von Verbindungen für eine kundenseitige Datenbankverbindung in der UI.
--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 Threads für die PDT-Regenerierung.
--max-scheduled-plans=<i> Maximale Anzahl aktiver wiederkehrender, geplanter Pläne (Standardeinstellung: unlimited).
--max-scheduler-jitter-in-seconds=<i> Flag, um das Programm zum Unkenntlichmachen nach einer zufälligen 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 von Threads für 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 zur Datei mit dem neuen Chiffreschlüssel (nur Legacy-Verschlüsselung).
--on-disk-cache-size=<i> Größe des Festplatten-Cache (in MB) (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 gleichzeitiger Abfragen pro Nutzer (Standardeinstellung: 15).
--per-user-query-timeout=<i> Länge des Zeitlimits pro Nutzer, das auf die Verbindung gewartet wird (Standardeinstellung: 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 Lizenzfunktion public_host_url aktiviert ist, können Administratoren mit dieser Option einen public_host_url-Hostnamen angeben, sodass die Callback-URIs für die 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 abschließenden Schrägstrich in der URL sein. Bei dieser Methode 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 Warteschlangenbroker (Standard: 61616).
--qm-long-poll-max-sleep-interval-in-seconds=<f> Max Sleep Intervall, bevor die Long Polling API prüft, ob Ergebnisse verfügbar sind (Standardeinstellung: 1).
--qm-long-poll-sleep-interval-in-seconds=<i> Anfängliches Ruhemodusintervall, bevor die Long Polling API prüft, ob Ergebnisse verfügbar sind (Standardeinstellung: 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 der Threads für Query Manager.
--query-manager-min-threads=<i> Mindestanzahl der Threads für den Query Manager.
--query-metrics-retention-hours=<i> Die Anzahl der Stunden, in denen query_metrics-Daten in der internen Datenbank aufbewahrt werden (Standardeinstellung: 336).
--queue-startup-timeout-in-seconds=<i> Legt fest, wie lange in Sekunden eine Verbindung zur Warteschlange beim Start zugelassen wird (Standardeinstellung: 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.

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 „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 der 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 Sidecar des SSH-Tunnelservers 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> Begrenzt die Anzahl gleichzeitiger geplanter Abfragen (Standardeinstellung: 10).
--scheduler-query-timeout=<i> Länge des Planer-Timeouts, das auf die Verbindung gewartet wird (Standardeinstellung: 1.200).
--scheduler-start-delay=<i> Anzahl der Sekunden, um den Start des Task-Runners zu verzögern (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 Schneeplow-Sammler.
--solr-basic-auth=<s> Anmeldedaten für die Basisauthentifizierung für Aufrufe von Solr (Standard: solr:SolrRocks).
--ssl Verwendet SSL (Standardeinstellung: 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 Passwort ssl-keystore.
--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> Stellt den Hostport für einen externen SSL-Anbieter bereit, der über den Server zugänglich ist, auf dem Looker ausgeführt wird. Wenn nicht angegeben, 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 über den 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 die Staging-Instanz geplante Berichte sendet. Die Staging-Instanz führt jedoch weiterhin geplante Aufgaben aus und sendet Fehler-E-Mails an die Inhaber von geplanten Plänen, wenn bei der geplanten Aufgabe Probleme auftreten.
--staging-override-email=<s> Sendet E-Mails auf einer Staging-Instanz an diese Adresse anstelle ihres normalen Ziels.
--stereo-data-search-enabled Aktivieren Sie die Funktion „Stereodatensuche“ (Standard: false).
--studio-load-url=<s> URL, über die Studio in einem iFrame geladen wird.
--studio-one-platform-endpoint=<s> Endpunkt für die Studio One Platform API.
--task-monitor-abandoned-query-in-seconds=<i> Verstrichene Zeit seit dem letzten Zugriff für eine Aufgabe, um die abgebrochene Abfrageaufgabe zu berücksichtigen.
--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 Platz, bevor die Umfrage gestartet wird.
--task-monitor-sleep-interval-in-seconds=<i> Das Schlafintervall vor dem Aufgaben-Tracking-Thread kann prüfen, ob Aufgaben abgebrochen werden.
--unlimited-scheduler-threads=<i> Anzahl der gleichzeitigen unbegrenzt geplanten Aufgaben (Standard: 3).
--use-custom-jdbc-config Gibt an, ob die benutzerdefinierte JDBC-Treiberkonfiguration verwendet werden soll (Standardeinstellung: false).
--user-db-credentials Eingeschränkte Nutzung. Für Verbindungen können Anmeldedaten pro Nutzer verwendet werden (Standardeinstellung: false).
-v, --version Druckt die Version und beendet den Vorgang.

Dateiformat für Anmeldedaten

Wenn Sie die Anwendungsdatenbank zu MySQL geändert haben, benötigen Sie eine Datei mit Anmeldedaten 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

Wenn Sie die Startkonfigurationseinstellungen dauerhaft festlegen möchten, erstellen Sie am besten im Looker-Anwendungsverzeichnis eine Datei namens lookerstart.cfg. Diese Datei wird vom Looker-Startscript ausgeführt, das mit Ihrer looker.jar bereitgestellt wurde. Wir empfehlen, die Umgebungsvariablen für JAVAARGS und LOOKERARGS in der Datei lookerstart.cfg festzulegen, da diese nicht überschrieben werden, wenn neue Versionen des Looker-Startskripts 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.